clarify

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): 인증 필요 여부?

생성된 질문

{
    "questions": [
        {
            "question": "회원 프로필에 어떤 정보가 필요한가요?",
            "header": "회원 정보",
            "multiSelect": True,
            "options": [
                {
                    "label": "기본 (이름, 이메일)",
                    "description": "최소한의 정보만"
                },
                {
                    "label": "프로필 사진",
                    "description": "선택적 이미지 추가"
                },
                {
                    "label": "선호 언어",
                    "description": "자동 언어 전환용"
                }
            ]
        },
        {
            "question": "번역 결과를 저장하나요?",
            "header": "번역 히스토리",
            "multiSelect": False,
            "options": [
                {
                    "label": "영구 저장",
                    "description": "모든 번역 기록 보관"
                },
                {
                    "label": "세션만",
                    "description": "앱 종료 시 삭제"
                },
                {
                    "label": "저장 안 함",
                    "description": "실시간만"
                }
            ]
        }
    ]
}