clarify

Files (2)

• SKILL.md
• question-patterns.md · templates/

SKILL.md (first lines)

# Skill: Clarify

## 목적

사용자 요구사항에서 모호한 부분을 식별하고 명확화 질문 생성

---

## 입력

- 사용자 요구사항 (원문)
- 이미 해결된 모호함 목록 (선택)

---

## 출력

- 탐지된 모호함 목록 (우선순위 정렬)
- AskUserQuestion 형식의 질문

---

## 모호함 탐지 카테고리

| 카테고리 | 탐지 패턴 | 질문 예시 |
|----------|----------|----------|
| **범위** | "회원", "주문" 같은 추상적 용어 | "회원은 어떤 정보를 가지나요?" |
| **기능** | "번역", "추천" 같은 동작 | "번역 결과를 저장하나요?" |
| **제약** | "지원", "허용" 같은 제한 | "언어 지원 범위는?" |
| **관계** | "A와 B" 같은 연결 | "회원과 주문의 관계는?" |
| **권한** | "누가", "어떻게" | "프로필 수정은 누가?" |
| **생명주기** | "생성", "삭제" | "탈퇴 시 데이터는?" |

---

## 작동 방식

### 1. 초기 분석

사용자 요청에서 위 카테고리별로 모호한 부분을 식별한다:

```
요청: "외국인 여행자용 번역 앱 만들어줘"

탐지:
- 범위 (high):   회원이 어떤 정보를 가지는지 불명확
- 기능 (high):   번역 히스토리를 저장하는지 불명확
- 제약 (high):   지원 언어 범위가 불명확
- 권한 (medium): 인증이 필요한지 불명확
```

우선순위(high → medium → low) 순으로 정렬하고, 배치당 최대 4개를 선택해 질문한다.

### 2. 질문 생성

탐지된 모호함마다 AskUserQuestion 형식의 질문을 만든다:
- 옵션이 2개이면 `multiSelect: False`
- 옵션이 3개 이상이면 `multiSelect: True`
- 옵션이 5개 이상이면 마지막에 "기타" 옵션 추가

---

## 질문 생성 규칙

### 옵션 수 결정

| 옵션 수 | multiSelect | 이유 |
|---------|-------------|------|
| 2개 | False | 예/아니오 |
| 3-4개 | True | 여러 선택 가능 |
| 5개 이상 | True + "기타" | 확장 가능 |

### 옵션 설명 작성

**좋은 설명**:
- 구체적: "한국어, 영어만" (좋음) vs "기본 언어" (나쁨)
- 결과 명시: "무료 50,000 MAU" (좋음) vs "무료 티어" (나쁨)
- 한글 사용: "일반 소비자" (좋음) vs "B2C" (나쁨)

---

## 기술 질문 필터링

기술 구현과 관련된 질문은 하지 않는다. 다음 키워드가 포함된 질문은 제외한다:

| 금지 영역 | 예시 키워드 |
|---------|-----------|
| 특정 기술 스택 | FastAPI, PostgreSQL, MySQL, Docker, Kubernetes |
| 인증 방식 | JWT, OAuth, Bearer |
| API 방식 | REST, GraphQL |
| 클라우드 서비스 | S3, GCS, Firebase, Supabase |
| DB 타입 | UUID, VARCHAR, INT |

대신 이렇게 질문한다:
- "인증은 JWT인가요?" → "로그인이 필요한가요?"
- "이미지는 S3에 저장할까요?" → "이미지 업로드 기능이 필요한가요?"

---

## 예시

### 입력
```
"외국인 여행자용 번역 앱 만들어줘"
```

### 탐지된 모호함
```
1. 범위 (high):   회원 정보 범위?
2. 기능 (high):   번역 히스토리 저장?
3. 제약 (high):   언어 지원 범위?
4. 권한 (medium): 인증 필요 여부?
```

### 생성된 질문

```python
{
    "questions": [

From ureca-corp/claude, MIT.

More from ureca-corp/claude