명령 컨텍스트: 대화형 대화를 통해 사용자가 잘 구조화된 스킬 파일을 만들도록 안내한 후, 최적화된 콘텐츠를 생성하고 검토합니다.
스킬 주제: $ARGUMENTS
실행 프로세스
다음 단계를 TaskCreate에 등록하고 체계적으로 진행합니다.
1단계: 사전 점검
- 기존 스킬 검색:
.claude/skills/*/SKILL.md,~/.claude/skills/*/SKILL.md $ARGUMENTS가 기존 스킬 이름과 일치하는 경우: 대신/refine-skill제안 후 중단- 사용자 인지용으로 기존 스킬 이름 나열
2단계: 스킬 지식 수집
AskUserQuestion을 사용하여 4라운드로 정보를 수집합니다.
1라운드: 스킬 본질
- 이 스킬은 어떤 도메인 지식을 인코딩합니까? (1-2문장)
- 이 스킬이 적용될 때의 주요 목표는 무엇입니까? (예: "타입 안전성 보장", "테스트 패턴 표준화")
2라운드: 프로젝트 특화 가치
제안된 스킬이 LLM의 기본 지식을 넘어서는 가치를 추가하는지 확인합니다.
- 이 스킬은 LLM이 일반 학습에서 알 수 없는 어떤 프로젝트별 규칙, 패턴, 클래스 이름 또는 워크플로우를 인코딩합니까?
- 구체적인 예시 제공 (예: 특정 오류 클래스, 팀 관례, 이 코드베이스의 파일 패턴)
| 사용자 응답 | 조치 |
|---|---|
| 프로젝트별 세부 정보 제공 | 스킬 콘텐츠에 통합. 3라운드로 진행. |
| 일반 지식만 설명 | 경고: "일반 지식만 포함된 스킬은 런타임에 트리거되지 않을 가능성이 높습니다." 제안: (A) 추가할 프로젝트별 측면 식별, (B) 스킬이 안정적으로 트리거되지 않을 수 있음을 이해하고 진행 |
3라운드: 스코프, 트리거 및 사용자 구문
- 이 스킬은 언제 활성화되어야 합니까? 3-5개의 구체적인 시나리오 나열 (예: "단위 테스트를 작성할 때", "PR의 보안을 검토할 때")
- 이 스킬이 명시적으로 다루지 않는 것은 무엇입니까? (스코프 경계)
- 팀에서 이런 종류의 작업을 요청할 때 실제로 사용하는 구문은 무엇입니까? (예: "X에 오류 처리 추가", "catch 블록 검토", "재시도 로직 수정")
수집된 구문을 두 범주로 분류합니다:
| 범주 | 정의 | 예 |
|---|---|---|
| 스킬 의존적 | 스킬의 지식 없이는 올바르게 완료할 수 없음 | "재시도 로직 구현", "오류 처리 검토" |
| 패턴 복사 가능 | 기존 코드 패턴을 읽고 복사하여 완료 가능 | "fetchXxx 함수 추가" |
모든 구문이 패턴 복사 가능인 경우: "이 작업들은 기존 코드를 복사하여 완료할 수 있습니다. 이 스킬이 인코딩하는 숨겨진 규칙이 필요한 시나리오를 제공해 주시겠습니까?" 진행 전에 최소 1개의 스킬 의존적 구문이 있는지 확인합니다.
4라운드: 의사 결정 기준 및 증거
- 구체적인 규칙 또는 기준은 무엇입니까? (인코딩할 핵심 지식)
- 좋은 패턴/나쁜 패턴의 예시가 있습니까?
- 이 스킬의 기반이 되는 외부 참조 또는 표준이 있습니까?
- 실제 산출물: "이러한 패턴을 보여주는 기존 파일, 과거 실패 사례, PR 또는 대화 로그가 있습니까?" (이것들은 실제 사용 사례로 스킬을 뒷받침합니다)
3단계: 이름 및 구조 결정
- 기존 관례에 따라 동명사/명사 형태로 스킬 이름 도출:
coding-standards,typescript-rules,implementation-approach(명사/동명사 복합어)
- 수집된 콘텐츠 양에 따라 크기 추정
- AskUserQuestion을 통해 이름과 구조를 사용자에게 제시하여 확인
4단계: 스킬 콘텐츠 생성
수집된 정보를 사용하여 Agent 도구를 통해 skill-creator 에이전트 호출:
- 모드: 생성
- 스킬 이름: 3단계에서 도출
- 원시 지식: 4라운드에서 수집
- 트리거 시나리오: 3라운드에서 수집
- 사용자 구문: 3라운드에서 수집 (스킬 의존적 및 패턴 복사 가능 모두)
- 스코프: 3라운드에서 수집
- 의사 결정 기준: 4라운드에서 수집
- 프로젝트 특화 가치: 2라운드에서 수집
- 실제 산출물: 4라운드에서 수집 (제공된 경우)
5단계: 생성된 콘텐츠 검토
Agent 도구를 통해 skill-reviewer 에이전트 호출:
- skill-creator의 생성 콘텐츠 전달
- 검토 모드:
creation
등급 C인 경우: 리뷰어의 수정 제안을 적용하고 재검토 (최대 2회 반복). 등급 A 또는 B인 경우: 6단계로 진행.
6단계: 사용자 검토 및 작성
- 생성된 SKILL.md 콘텐츠를 사용자에게 최종 승인을 위해 제시
- 사용자 의도 일치 확인: "이 스킬이 설명하신 지식과 기준을 잘 담고 있습니까?"
- 수정 요청 시: 변경 사항 적용 후 skill-reviewer 재실행
- 승인 시,
.claude/skills/{name}/SKILL.md에 작성 - 메타데이터 및 언어 변형 업데이트를 위해
/sync-skills실행 제안
완료 기준
- 기존 스킬과 이름 충돌 없음
- 2라운드에서 프로젝트 특화 가치 확인됨
- 사용자 구문 수집 및 분류 완료 (최소 1개 스킬 의존적)
- 사용자가 스킬 이름 확인
- skill-creator 에이전트가 유효한 JSON 출력 반환
- skill-reviewer 에이전트가 A 또는 B 등급 반환
- 사용자가 최종 콘텐츠 승인
-
.claude/skills/{name}/SKILL.md에 파일 작성됨 - 사용자에게
/sync-skills제안됨
오류 처리
| 오류 | 조치 |
|---|---|
| 스킬 이름이 이미 존재함 | 대신 /refine-skill {name} 제안 |
| 4라운드 후에도 지식 부족 | 대상 후속 질문 (최대 2개 추가 질문) |
| skill-creator가 유효하지 않은 JSON 반환 | 단순화된 입력으로 한 번 재시도 |
| 2회 검토 반복 후에도 등급 C | 문제 목록과 함께 현재 콘텐츠 제시, 사용자가 결정하도록 함 |
| 사용자가 생성된 콘텐츠 거부 | 구체적인 피드백 수집, 수정 사항 반영하여 skill-creator 재실행 |
스코프 경계
이 명령이 처리하는 것: 대화형 지식 수집, 생성 에이전트 및 검토 에이전트 오케스트레이션, 파일 작성.
이 명령이 처리하지 않는 것: 스킬 콘텐츠 최적화 로직 (skill-creator에 위임), 품질 평가 로직 (skill-reviewer에 위임), 메타데이터 동기화 (/sync-skills에 위임).