스킬 작성하기
수집 → 비판 → 계획 → 구현의 4단계 파이프라인입니다.
1단계: 수집
AskUserQuestion을 사용하여 4개 영역에 걸쳐 도메인별 질문을 배치합니다. 각 영역은 2~4개의 옵션과 권장 사항(첫 번째 옵션 = (권장))과 함께 1회 호출됩니다.
- 목적 — 스킬이 다루는 작업/도메인은 무엇인가요? 누가 사용하나요?
- 사용 사례 — 어떤 특정 시나리오가 이 스킬을 트리거하나요? 어떤 키워드가 있나요?
- 구조 — 스크립트가 필요한가요? 참조 파일이 필요한가요? 단일 SKILL.md 또는 다중 파일 구조인가요?
- 도구 — 어떤 도구나 다른 스킬을 호출하거나 참조해야 하나요?
2단계: 비판
grill-me 스킬을 호출하여 수집된 요구사항을 전달합니다. skill-grill-domains.md에 있는 스킬 맞춤 도메인(의도, 범위, 설계, 경계 사례)을 사용하도록 지시합니다. 관련 없는 도메인(데이터 흐름, 종속성, 배포, 테스트)은 건너뜁니다.
대체 (grill-me 사용 불가): AskUserQuestion을 직접 사용하여 인라인 미니 비판을 실행합니다. skill-grill-domains.md의 각 도메인에 대해 호출당 2~4개의 질문을 배치하고 권장 사항과 옵션을 제공합니다.
3단계: 계획
blueprint-template.md의 템플릿을 사용하여 구조화된 스킬 청사진을 생성합니다. 청사진을 대화 컨텍스트에 표시합니다(디스크에 기록하지 않음). 사용자가 진행하기 전에 승인해야 합니다. 사용자가 변경을 요청하면 수정하여 다시 제시합니다.
4단계: 구현
승인된 청사진에 따라 모든 스킬 파일을 생성합니다. 완전 자동화 — 에이전트가 모든 것을 작성합니다.
그런 다음 quality-criteria.md의 기준을 사용하여 4b단계: 검토를 실행합니다.
- 자동 검증 — 측정 가능한 기준(줄 수, 설명 길이, 트리거, 참조 깊이)을 확인합니다. 진행하기 전에 실패 사항을 수정합니다.
- 주관적 검토 —
AskUserQuestion을 통해 체크리스트를 사용자에게 제시합니다. 사용자가 문제를 제기하면 수정하고 재검증합니다.
스킬 구조
skill-name/
├── SKILL.md # 주요 지침 (필수, <100줄)
├── references/ # 지원 문서 (필요 시)
│ └── domain-ref.md
└── scripts/ # 유틸리티 스크립트 (필요 시)
└── helper.sh
대체 (AskUserQuestion 없음)
AskUserQuestion을 사용할 수 없는 경우 텍스트 기반 질문으로 대체합니다:
[헤더] — [주제] 권장: [권장 사항 및 이유] 대안: (A) [옵션] — [장단점] | (B) [옵션] — [장단점]
품질 기준
설명 요구사항, 자동 검증 기준, 주관적 검토 체크리스트, 스크립트 추가 또는 파일 분할 시기에 대한 지침은 quality-criteria.md를 참조하세요.