Brand Skill Builder
이 스킬은 브랜드 스킬 라이브러리를 구축하고 유지 관리하는 데 도움을 줍니다. 라이브러리는 모든 모델이 하나의 회사를 위해 브랜드에 맞는 작업을 생성할 수 있게 하는 작은 스킬 집합입니다. 이 스킬은 프로덕션 라이브러리의 아키텍처, 템플릿, 스크립트 및 교훈을 담고 있지만, 자체 브랜드는 가지고 있지 않습니다. 모든 브랜드 값은 사용자의 소스에서 비롯됩니다.
어떤 모드든 시작하기 전에 references/architecture.md를 읽으십시오. 아래 단계에서 참조 파일이 명시된 경우 다른 참조 파일도 읽으십시오.
폴더. 모든 명령어에서 SKILL_DIR은 이 파일이 있는 폴더이고, LIB는 사용자가 선택한 라이브러리 폴더입니다. 모든 명령어에서 둘 다 전체 경로로 작성하십시오. 셸 변수로 설정하지 마십시오 (일부 플랫폼에서는 한 명령어에서 설정한 변수가 다음 명령어에서 사라집니다).
모드 선택
| 사용자가 원하는 것 | 모드 |
|---|---|
| 아직 브랜드 스킬이 없는 브랜드를 위한 브랜드 스킬 | A. 새 라이브러리 |
| 기존 라이브러리에 스킬 하나 더 추가 | B. 스킬 추가 |
| 기존 브랜드 스킬 또는 라이브러리 검토 | C. 검토 |
| 구축 전 접근 방식 이해 | references/architecture.md에서 설명하고 중단 |
요청에서 지정하지 않은 경우에만 어떤 모드인지 물어보십시오.
A. 새 라이브러리
- 소스 수집. 브랜드 북과 브랜드를 규율하는 모든 자료(디자인 팀의 템플릿, 보이스 가이드, 메시징 문서, 상표 규칙, 스타일 가이드, 로고 파일, 글꼴 및 라이선스, 아이콘 또는 사진 라이브러리)를 요청하십시오. 브랜드를 소유한 사람(결정을 승인할 사람)이 누군지 물어보십시오. 누락된 사항을 기록하고, 채우지 마십시오.
- 스캐폴딩.
python3 SKILL_DIR/scripts/scaffold.py library LIB --brand "<Brand>" --era <era>.era는 이 버전의 브랜드를 나타내는 짧은 레이블입니다 (예:2027-brand). 소스는LIB/reference/에 넣으십시오. - 기반 작성
LIB/shared-context/brand-foundations/context/에 소스를 기반으로 기반을 작성합니다.references/brand-foundations.md를 따르십시오. 모든 TODO를 소스에서 채우거나 격차로 기록하십시오. 대비를 측정하고, 규칙이 있는 경우 책의 표현을 인용하며, 모든 파일에 출처를 제공하십시오.logo/아래에 로고 아트워크를 추가하고, 소스에서 다루는 경우logo-policy.md,imagery-policy.md및chart-palette.json을 추가하십시오. - 소유자와 검토. 기반을 짧은 요약(색상 모델, 타입 역할, 시그니처 요소, 선적 확인, 격차, 각 제안된 하우스 결정 및 권장 사항과 그 이유)으로 제시하십시오. 결정을 기다리고, 각 결정을 하우스 결정 테이블과 개발 로그에 기록하십시오.
- 보이스 스킬 구축 (모드 B,
--kind voice). 작고 스냅샷, 사전 점검 및 패키징 경로를 증명합니다. - 첫 번째 포맷 스킬 구축 (모드 B,
--kind format), 사람들이 가장 필요로 하는 형식. 가장 작은 엔드투엔드 경로 먼저, 그 다음 파일럿 루프. - 하나씩 형식 추가, 각 형식의 하우스 결정을 먼저 결정(
references/process.md, "작업 순서")합니다. - 감사 스킬 구축 (모드 B,
--kind audit) 감사할 형식 사양이 있을 때.
B. 스킬 추가
- 이름 지정
<brand>-<format>(소문자, 하이픈 사용) 또는<brand>-voice,<brand>-audit. 하나의 스킬, 하나의 작업을 확인하십시오. 요청이 기존 스킬과 중복되면 말하고 대신 해당 스킬을 확장할 것을 권장하십시오. - 스캐폴딩.
python3 SKILL_DIR/scripts/scaffold.py skill LIB <name> --kind format|voice|audit --format "<PDF>". 이 명령은 SKILL.md 템플릿,agents/openai.yaml, 사전 점검, 플랫폼 테스트 및 스냅샷 설정LIB/tools/snapshot/<name>.json을 작성합니다. 포맷 스킬의 경우LIB/shared-context/<name>/context/format-spec.md및format-map.json도 작성합니다. - 형식의 하우스 결정 결정 코드를 작성하기 전에:
structural-system.md에서 "다른 사람이 구축할 때 결정" 범위의 모든 결정에 대해 이 형식에 대한 답변을 권장하고, 소유자의 결정을 받아 기록하십시오. - 형식 사양 및 맵 작성 (BOOK, RATIFIED 및 PROPOSED 태그가 있는 단어; 숫자는 역할 이름 사용, 16진수 사용 금지).
- 빌더 및 QA 스크립트 작성
references/format-skills.md에 따라: 모델이 JSON 사양을 계획하고 작성하며, 스크립트가 빌드하고, 스크립트가 완성된 파일을 게이트합니다. 토큰은 빌드 시간에 읽히고, 편차는 기록되며 거부하지 않습니다. 보이스 및 감사 스킬은 대신references/voice-and-audit.md를 따릅니다. - SKILL.md 채우기: 설명(트리거, 하지 않을 일, 1024자 미만), 단계, 인테이크와 룩투스펙 테이블, 사양 참조, 경고-거부 금지 섹션, 플랫폼별 전달 라인.
- 스냅샷 및 검증.
python3 LIB/tools/snapshot/snapshot.py LIB/tools/snapshot/<name>.json, 그런 다음--check, 그런 다음python3 LIB/skills/<name>/scripts/verify_context.py. 글꼴, 스타일시트 및 아트워크를 설정의bundled_assets에 추가하여 사전 점검이 이를 증명할 수 있도록 하십시오. - 테스트 (
references/qa-and-testing.md): 플랫폼 테스트, 두 테마에서의 픽스처 빌드, QA 검사별 변조 테스트, 토큰 스왑 테스트. 그런 다음 현실적인 프롬프트로 파일럿 루프를 수행하고, 각 수정 후 동일한 프롬프트를 다시 실행하십시오. - 요청 시 패키징 (
references/packaging.md):python3 LIB/tools/package/package_skill.py LIB/skills/<name> <name> <fresh scratch folder>/<name>.zip --date YYYY-MM-DD. 다른 새 폴더에 압축을 풀고 거기서 테스트를 실행한 후 zip을LIB/finalized-skills/에 넣으십시오. - 기록. 위의 모든 단계를 실행할 때마다
LIB/DEV-LOG.md에 기록하십시오.
C. 검토
스킬(또는 라이브러리)을 읽고 패턴과 비교하십시오. 다음 순서대로 각 항목을 파일과 줄 번호와 함께 보고하십시오:
- 구조: 하나의 작업, 다른 스킬에 대한 런타임 호출 없음,
agents/openapi.yaml, 단일 플랫폼 경로 없음. - 컨텍스트: 매니페스트와 다이제스트가 있는 번들 스냅샷, 중지 대신 경고하는 사전 점검, 브랜드 시대.
- 빌더: 빌드 시간에 읽는 토큰(또는 하드코딩된 값), JSON 사양, 거부 대신 편차.
- QA: 선적 확인에 매핑된 완성된 파일 게이트, 변조 테스트, 다시 스타일링하는 경우 다시 스타일 모드.
- 워크플로: 기본값이 있는 인테이크, 주장과 증거가 있는 계획, 빌드 전 승인, 경고를 앞세운 전달.
- 패키징: 엄격한 프론트매터, 설명 길이 및 트리거, 릴리스 기록.
영향 순서대로 수정 사항을 권장하십시오. 요청하지 않는 한 아무것도 변경하지 마십시오.
모든 모드에 대한 규칙
- 브랜드 값을 절대 발명하지 마십시오. 색상, 글꼴, 크기, 규칙, 주장, 수치 또는 고객이 일반 지식에서 비롯되지 않습니다. 격차는 기록되고 소유자가 결정하거나 요소를 생략합니다.
- 브랜드 북이 기록의 규칙입니다. 소유자의 디자인 파일이 침묵을 채우며, 모든 이탈은 범위, 이탈한 책의 표현, 상태 및 결정한 사람이 기록된 하우스 결정입니다.
- 경고하고, 절대 거부하지 마십시오. 구축하는 스킬 내에서: 수리하고 보고하고, 실패한 파일에 레이블을 붙여 전달하며, 물리적 불가능의 경우에만 중단하십시오. 보이스 파일이 없는 보이스 스킬이 그 불가능입니다.
- 권장한 후 물어보십시오. 소유자에게 속한 모든 선택에 대해. 결정 후에만 구축하십시오.
- 측정하고, 추측하지 마십시오: 대비, 텍스트 너비, 줄 수, 렌더링.
- 완료라고 말하기 전에 실제 렌더러에서 출력을 확인하십시오.
전달
- Claude에서: 생성 또는 변경된 내용을 경로와 함께 요약하고, 출력 폴더에서 패키징된 zip을 공유하십시오.
- ChatGPT에서: 생성 또는 변경된 내용을 경로와 함께 요약하고, 다운로드 가능한 패키징된 zip을 링크하십시오.
그런 다음 여전히 할 일, 소유자를 기다리는 각 격차, 각 PROPOSED 결정을 나열하십시오.
참조
| 파일 | 읽을 내용 |
|---|---|
references/architecture.md | 스킬 유형, 워크스페이스, 스킬 폴더, 스냅샷 우선 컨텍스트, 플랫폼 중립성 |
references/brand-foundations.md | 브랜드 북을 데이터로 변환: 파일, 색상 및 타입 아키텍처, 하우스 결정, 상태 태그 |
references/format-skills.md | 포맷 스킬 내 워크플로, 경고-거부 금지, 사양, 빌더, QA 게이트, 형식별 참고 사항 |
references/voice-and-audit.md | 보이스 스킬 및 감사 스킬 |
references/qa-and-testing.md | 테스트, 렌더링, 파일럿, 상호 작용하는 규칙 디버깅 |
references/packaging.md | 엄격한 프론트매터, 설명, 릴리스 단계, 업로드 실패 |
references/process.md | 결정, 살아있는 기록, 작업 순서, 안전한 작업, Office 도구 체인 교훈 |