Clarify Skill
모호한 요구사항을 구체적이고 실행 가능한 스펙으로 변환.
프로세스
code
/clarify "요청"
│
├─ Phase 1: 원본 기록
│ └─ 원본 요청 그대로 기록
│
├─ Phase 2: 반복 질문
│ └─ AskUserQuestion으로 모호한 점 해결
│
├─ Phase 3: Before/After 비교
│ └─ 원본 vs 명확화된 스펙 비교 제시
│
└─ Phase 4: 저장 옵션
└─ docs/requirements/ 에 저장 여부 확인
질문 원칙
- •구체적 > 일반적: 추상적 선호보다 구체적 세부사항
- •선택지 > 개방형: 2-4개 옵션 제시 (인식 > 회상)
- •하나씩 질문: 여러 질문 묶지 않기
- •중립적 프레이밍: 편향 없이 옵션 제시
모호함 카테고리
| 카테고리 | 질문 예시 |
|---|---|
| 범위 | 포함/제외 항목? |
| 동작 | 엣지 케이스? 에러 시나리오? |
| 인터페이스 | 누가/무엇이 상호작용? |
| 데이터 | 입력? 출력? 포맷? |
| 제약 | 성능? 호환성? |
| 우선순위 | 필수 vs 있으면 좋은 것? |
결과 템플릿
markdown
## Before (원본)
"{원본 요청}"
## After (명확화)
**목표**: [구체적 설명]
**범위**: [포함/제외 항목]
**제약**: [제한사항, 요구사항]
**성공 기준**: [완료 판단 기준]
**결정 사항**:
| 질문 | 결정 |
|------|------|
| [모호함 1] | [선택된 옵션] |
| [모호함 2] | [선택된 옵션] |
예시
입력
code
/clarify 태그 필터링 추가
질문
- •다중 태그 선택 시 동작? → AND (모든 태그 포함)
- •UI 위치? → 검색바 아래
- •태그 없는 링크 표시? → "태그 없음" 필터 제공
결과
- •목표: 다중 태그 AND 필터링 기능 추가
- •범위: 태그 칩 UI, 필터 로직, "태그 없음" 옵션
- •성공 기준: 선택한 모든 태그를 포함하는 링크만 표시
규칙
- •가정 금지: 물어보기
- •의도 보존: 방향 수정 아닌 명확화
- •최소 질문: 필요한 것만
- •답변 존중: 사용자 결정 수용
- •변화 추적: 항상 Before/After 표시