---
name: clarify
description: 요구사항 명확화 스킬. 모호한 요청을 구체적인 스펙으로 변환. Plan Mode 진입 전 사용.
---

# Clarify Skill

모호한 요구사항을 구체적이고 실행 가능한 스펙으로 변환.

## 프로세스

```
/clarify "요청"
    │
    ├─ Phase 1: 원본 기록
    │   └─ 원본 요청 그대로 기록
    │
    ├─ Phase 2: 반복 질문
    │   └─ AskUserQuestion으로 모호한 점 해결
    │
    ├─ Phase 3: Before/After 비교
    │   └─ 원본 vs 명확화된 스펙 비교 제시
    │
    └─ Phase 4: 저장 옵션
        └─ docs/requirements/ 에 저장 여부 확인
```

## 질문 원칙

- **구체적 > 일반적**: 추상적 선호보다 구체적 세부사항
- **선택지 > 개방형**: 2-4개 옵션 제시 (인식 > 회상)
- **하나씩 질문**: 여러 질문 묶지 않기
- **중립적 프레이밍**: 편향 없이 옵션 제시

## 모호함 카테고리

| 카테고리 | 질문 예시 |
|----------|----------|
| **범위** | 포함/제외 항목? |
| **동작** | 엣지 케이스? 에러 시나리오? |
| **인터페이스** | 누가/무엇이 상호작용? |
| **데이터** | 입력? 출력? 포맷? |
| **제약** | 성능? 호환성? |
| **우선순위** | 필수 vs 있으면 좋은 것? |

## 결과 템플릿

```markdown
## Before (원본)
"{원본 요청}"

## After (명확화)
**목표**: [구체적 설명]
**범위**: [포함/제외 항목]
**제약**: [제한사항, 요구사항]
**성공 기준**: [완료 판단 기준]

**결정 사항**:
| 질문 | 결정 |
|------|------|
| [모호함 1] | [선택된 옵션] |
| [모호함 2] | [선택된 옵션] |
```

## 예시

### 입력
```
/clarify 태그 필터링 추가
```

### 질문
1. 다중 태그 선택 시 동작? → AND (모든 태그 포함)
2. UI 위치? → 검색바 아래
3. 태그 없는 링크 표시? → "태그 없음" 필터 제공

### 결과
- 목표: 다중 태그 AND 필터링 기능 추가
- 범위: 태그 칩 UI, 필터 로직, "태그 없음" 옵션
- 성공 기준: 선택한 모든 태그를 포함하는 링크만 표시

## 규칙

1. **가정 금지**: 물어보기
2. **의도 보존**: 방향 수정 아닌 명확화
3. **최소 질문**: 필요한 것만
4. **답변 존중**: 사용자 결정 수용
5. **변화 추적**: 항상 Before/After 표시