specify

Write Feature Specification

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty). The user input is the feature description.

⚠️ 커맨드 구분: 이것은 플러그인 커맨드 (/spec-kit:specify)입니다. 정보 수집과 사용자 논의를 담당합니다. 실제 파일 생성/업데이트는 GitHub Spec-Kit CLI 커맨드 (/speckit.specify)가 수행합니다.

🌐 언어 지시사항: 이 명령어를 실행할 때는 사용자의 시스템 언어를 자동으로 감지하여 해당 언어로 모든 안내, 질문, 템플릿, 출력을 제공해야 합니다. 시스템 환경 변수(LANG, LC_ALL 등)나 사용자의 이전 대화 패턴을 분석하여 언어를 판단하세요.

기능의 요구사항, 수용 기준, 사용자 흐름을 정의합니다. HOW가 아닌 WHAT에 집중합니다.

Prerequisites

헌법이 먼저 존재해야 합니다:

cat .specify/memory/constitution.md

없다면 /spec-kit:constitution을 먼저 실행하세요.

Step 1: Git 변경사항 확인

명세 작성 전에 현재 작업 디렉토리의 변경사항과 브랜치 퍼블리쉬 상태를 확인합니다:

# 변경사항 확인
git status --short

# Upstream 브랜치 확인 (퍼블리쉬 여부)
git rev-parse --abbrev-ref @{upstream} 2>/dev/null

시나리오 A: 변경사항이 없는 경우

즉시 Step 2로 이동

시나리오 B: 변경사항 있음 + Upstream 브랜치 없음 (미퍼블리쉬)

브랜치가 아직 원격에 퍼블리쉬되지 않은 상태에서 변경사항이 있는 경우:

AskUserQuestion 도구를 사용하여 사용자에게 확인:

{
  "questions": [{
    "question": "현재 작업 디렉토리에 변경되지 않은 파일이 있고, 브랜치가 아직 퍼블리쉬되지 않았습니다. 어떻게 처리하시겠습니까?",
    "header": "Git 변경사항",
    "multiSelect": false,
    "options": [
      {
        "label": "퍼블리쉬 + 커밋",
        "description": "현재 변경사항을 커밋하고 브랜치를 원격 저장소에 퍼블리쉬합니다. 팀과 공유하거나 백업이 필요한 경우 권장합니다."
      },
      {
        "label": "로컬에만 커밋",
        "description": "현재 변경사항을 커밋하지만 브랜치는 로컬에만 유지합니다. 아직 공유할 준비가 안 된 경우에 사용합니다."
      },
      {
        "label": "나중에 결정",
        "description": "명세 작성을 진행하고 나중에 모든 변경사항을 함께 처리합니다."
      }
    ]
  }]
}

사용자 선택에 따라 진행:

• "퍼블리쉬 + 커밋" 선택 시:
  1. 사용자에게 커밋 메시지 요청
  2. git add -A && git commit -m "[메시지]"
  3. git push -u origin [브랜치명]
  4. Step 2로 이동
• "로컬에만 커밋" 선택 시:
  1. 사용자에게 커밋 메시지 요청
  2. git add -A && git commit -m "[메시지]"
  3. Step 2로 이동
• "나중에 결정" 선택 시: 즉시 Step 2로 이동

시나리오 C: 변경사항 있음 + Upstream 브랜치 있음 (이미 퍼블리쉬됨)

브랜치가 이미 원격에 퍼블리쉬된 상태에서 변경사항이 있는 경우:

AskUserQuestion 도구를 사용하여 사용자에게 확인: