사용자 입력
$ARGUMENTS
진행하기 전에 사용자 입력(비어 있지 않은 경우)을 반드시 고려해야 합니다.
사전 실행 검사
확장 훅 확인 (구현 전):
- 프로젝트 루트에
.specify/extensions.yml파일이 있는지 확인합니다. - 파일이 있으면 읽고
hooks.before_implement키 아래의 항목을 확인합니다. - YAML을 구문 분석할 수 없거나 유효하지 않은 경우, 조용히 건너뛰지 말고 사용자에게
.specify/extensions.yml파일을 읽을 수 없다고 알리고(구문 분석 오류 포함) 등록된 필수(optional: false) 훅을 포함한 어떤 훅도 확인되지 않았다고 알린 후 정상적으로 계속 진행합니다. enabled가 명시적으로false인 훅은 걸러냅니다.enabled필드가 없는 훅은 기본적으로 활성화된 것으로 간주합니다.- 나머지 각 훅에 대해 훅
condition표현식을 해석하거나 평가하려고 시도하지 마십시오:- 훅에
condition필드가 없거나 null/비어 있으면 훅을 실행 가능한 것으로 간주합니다. - 훅이 비어 있지 않은
condition을 정의하면 훅을 건너뛰고 조건 평가를 HookExecutor 구현에 맡깁니다.
- 훅에
- 훅 명령 이름에서 명령 호출을 구성할 때 점(
.)을 하이픈(-)으로 바꿉니다. 예를 들어,speckit.git.commit→/speckit-git-commit이 됩니다. - 각 실행 가능한 훅에 대해
optional플래그에 따라 다음을 출력합니다:- 선택적 훅 (
optional: true):## 확장 훅 **선택적 사전 훅**: {extension} 명령: `/{command}` 설명: {description} 프롬프트: {prompt} 실행하려면: `/{command}` - 필수 훅 (
optional: false):
위 블록을 출력한 후 반드시 훅을 실제로 호출하고 완료될 때까지 기다려야 합니다. 이 에이전트/세션에서 직접 명령을 실행하는 것과 동일한 방식으로 실행합니다(호출은 위에 표시된 리터럴## 확장 훅 **자동 사전 훅**: {extension} 실행 중: `/{command}` EXECUTE_COMMAND: {command} 개요로 진행하기 전에 훅 명령의 결과를 기다리십시오.{command}ID와 다를 수 있습니다. 예: skills-mode 에이전트는/skill:speckit-...또는$speckit-...로 실행). 블록을 출력하는 것만으로는 훅이 실행되지 않습니다.
- 선택적 훅 (
- 등록된 훅이 없거나
.specify/extensions.yml파일이 없으면 조용히 건너뜁니다.
개요
-
리포지토리 루트에서
.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks를 실행하고 FEATURE_DIR 및 AVAILABLE_DOCS 목록을 파싱합니다. 모든 경로는 절대 경로여야 합니다. "I'm Groot"와 같은 인수에 작은따옴표가 있는 경우 이스케이프 구문(예: 'I'''m Groot')을 사용하거나 가능하면 큰따옴표("I'm Groot")를 사용합니다. -
체크리스트 상태 확인 (FEATURE_DIR/checklists/ 디렉토리가 있는 경우):
-
체크리스트 마커를 읽기 전용 게이트로 취급합니다. 체크박스 상태를 스캔하고 상태를 보고하며 필요한 경우 진행하기 전에 질문합니다. 체크리스트 파일이나 마커를 수정하지 마십시오.
-
checklists/requirements.md는/speckit-specify및/speckit-clarify가 유지 관리하는 기본 제공 사양 품질 체크리스트입니다./speckit-checklist가 생성한 사용자 정의 체크리스트는 검토자가 소유한 요구사항-품질 검토 산출물입니다. -
사용자 정의 체크리스트의 경우
[x]는 검토자가 요구사항-품질 기준이 충족되었다고 판단했음을 의미합니다. 구현 작업이 완료되었음을 의미하지는 않습니다. -
checklists/ 디렉토리의 모든 체크리스트 파일을 스캔합니다.
-
각 체크리스트에 대해 다음을 계산합니다:
- 총 항목:
- [ ]또는- [X]또는- [x]와 일치하는 모든 줄 - 선택된 항목:
- [X]또는- [x]와 일치하는 줄 - 선택되지 않은 항목:
- [ ]와 일치하는 줄
- 총 항목:
-
상태 표를 생성합니다:
| 체크리스트 | 총계 | 선택됨 | 선택 안됨 | 상태 | |-----------|-------|---------|-----------|--------| | ux.md | 12 | 12 | 0 | ✓ 통과 | | test.md | 8 | 5 | 3 | ✗ 실패 | | security.md | 6 | 6 | 0 | ✓ 통과 | -
전체 상태를 계산합니다:
- 통과: 모든 체크리스트에 선택되지 않은 항목이 0개입니다.
- 실패: 하나 이상의 체크리스트에 선택되지 않은 항목이 있습니다.
-
선택되지 않은 항목이 있는 체크리스트가 있는 경우:
- 선택되지 않은 항목 수와 함께 표를 표시합니다.
- 중단하고 질문합니다: "일부 체크리스트에 선택되지 않은 항목이 있습니다. 그래도 구현을 진행하시겠습니까? (예/아니오)"
- 계속하기 전에 사용자 응답을 기다립니다.
- 사용자가 "아니오" 또는 "잠시만요" 또는 "중지"라고 말하면 실행을 중단합니다.
- 사용자가 "예" 또는 "진행" 또는 "계속"이라고 말하면 3단계로 진행합니다.
-
모든 체크리스트가 선택된 경우:
- 모든 체크리스트가 통과되었음을 보여주는 표를 표시합니다.
- 자동으로 3단계로 진행합니다.
-
-
구현 컨텍스트 로드 및 분석:
- 필수: 전체 작업 목록 및 실행 계획을 위해 tasks.md를 읽습니다.
- 필수: 기술 스택, 아키텍처 및 파일 구조를 위해 plan.md를 읽습니다.
- 존재하는 경우: 엔터티와 관계를 위해 data-model.md를 읽습니다.
- 존재하는 경우: API 사양 및 테스트 요구사항을 위해 contracts/를 읽습니다.
- 존재하는 경우: 기술 결정 및 제약 조건을 위해 research.md를 읽습니다.
- 존재하는 경우: 거버넌스 제약 조건을 위해 .specify/memory/constitution.md를 읽습니다.
- 존재하는 경우: 통합 시나리오를 위해 quickstart.md를 읽습니다.
-
프로젝트 설정 확인:
- 필수: 실제 프로젝트 설정을 기반으로 무시 파일을 생성/확인합니다.
감지 및 생성 로직:
-
다음 명령이 성공하는지 확인하여 리포지토리가 git 리포지토리인지 확인합니다(그렇다면 .gitignore 생성/확인):
git rev-parse --git-dir 2>/dev/null -
Dockerfile*이 존재하거나 plan.md에 Docker가 있는지 확인 → .dockerignore 생성/확인
-
.eslintrc*가 존재하는지 확인 → .eslintignore 생성/확인
-
eslint.config.*가 존재하는지 확인 → 설정의
ignores항목이 필수 패턴을 포함하는지 확인 -
.prettierrc*가 존재하는지 확인 → .prettierignore 생성/확인
-
.npmrc 또는 package.json이 존재하는지 확인 → .npmignore 생성/확인(게시하는 경우)
-
terraform 파일(*.tf)이 존재하는지 확인 → .terraformignore 생성/확인
-
.helmignore가 필요한지 확인(helm 차트가 있는 경우) → .helmignore 생성/확인
무시 파일이 이미 존재하는 경우: 필수 패턴이 포함되어 있는지 확인하고 누락된 중요 패턴만 추가합니다. 무시 파일이 없는 경우: 감지된 기술에 대한 전체 패턴 세트로 생성합니다.
기술별 공통 패턴 (plan.md 기술 스택 기반):
- Node.js/JavaScript/TypeScript:
node_modules/,dist/,build/,*.log,.env* - Python:
__pycache__/,*.pyc,.venv/,venv/,dist/,*.egg-info/ - Java:
target/,*.class,*.jar,.gradle/,build/ - C#/.NET:
bin/,obj/,*.user,*.suo,packages/ - Go:
*.exe,*.test,vendor/,*.out - Ruby:
.bundle/,log/,tmp/,*.gem,vendor/bundle/ - PHP:
vendor/,*.log,*.cache,*.env - Rust:
target/,debug/,release/,*.rs.bk,*.rlib,*.prof*,.idea/,*.log,.env* - Kotlin:
build/,out/,.gradle/,.idea/,*.class,*.jar,*.iml,*.log,.env* - C++:
build/,bin/,obj/,out/,*.o,*.so,*.a,*.exe,*.dll,.idea/,*.log,.env* - C:
build/,bin/,obj/,out/,*.o,*.a,*.so,*.exe,*.dll,autom4te.cache/,config.status,config.log,.idea/,*.log,.env* - Swift:
.build/,DerivedData/,*.swiftpm/,Packages/ - R:
.Rproj.user/,.Rhistory,.RData,.Ruserdata,*.Rproj,packrat/,renv/ - 범용:
.DS_Store,Thumbs.db,*.tmp,*.swp,.vscode/,.idea/
도구별 패턴:
- Docker:
node_modules/,.git/,Dockerfile*,.dockerignore,*.log*,.env*,coverage/ - ESLint:
node_modules/,dist/,build/,coverage/,*.min.js - Prettier:
node_modules/,dist/,build/,coverage/,package-lock.json,yarn.lock,pnpm-lock.yaml - Terraform:
.terraform/,*.tfstate*,*.tfvars,.terraform.lock.hcl - Kubernetes/k8s:
*.secret.yaml,secrets/,.kube/,kubeconfig*,*.key,*.crt
-
tasks.md 구조를 파싱하고 다음을 추출합니다:
- 작업 단계: Setup, Tests, Core, Integration, Polish
- 작업 의존성: 순차 대 병렬 실행 규칙
- 작업 세부 정보: ID, 설명, 파일 경로, 병렬 마커 [P]
- 실행 흐름: 순서 및 의존성 요구사항
-
작업 계획에 따라 구현 실행:
- 단계별 실행: 다음 단계로 이동하기 전에 각 단계를 완료합니다.
- 의존성 준수: 순차 작업은 순서대로 실행하고, 병렬 작업 [P]은 함께 실행할 수 있습니다.
- TDD 접근 방식 따르기: 해당 구현 작업보다 먼저 테스트 작업을 실행합니다.
- 파일 기반 조정: 동일한 파일에 영향을 미치는 작업은 순차적으로 실행해야 합니다.
- 유효성 검사 체크포인트: 진행하기 전에 각 단계 완료를 확인합니다.
-
구현 실행 규칙:
- 설정 먼저: 프로젝트 구조, 의존성, 구성을 초기화합니다.
- 코드보다 테스트 먼저: 계약, 엔터티 및 통합 시나리오에 대한 테스트를 작성해야 하는 경우.
- 핵심 개발: 모델, 서비스, CLI 명령, 엔드포인트를 구현합니다.
- 통합 작업: 데이터베이스 연결, 미들웨어, 로깅, 외부 서비스.
- 마무리 및 검증: 단위 테스트, 성능 최적화, 문서화.
-
진행 상황 추적 및 오류 처리:
- 각 작업 완료 후 진행 상황을 보고합니다.
- 병렬 작업이 아닌 작업이 실패하면 실행을 중단합니다.
- 병렬 작업 [P]의 경우 성공한 작업은 계속 진행하고 실패한 작업은 보고합니다.
- 디버깅을 위해 컨텍스트와 함께 명확한 오류 메시지를 제공합니다.
- 구현을 진행할 수 없는 경우 다음 단계를 제안합니다.
- 중요: 완료된 작업의 경우 작업 파일에서 해당 작업을 [X]로 표시해야 합니다.
-
완료 검증:
- 필수 작업이 모두 완료되었는지 확인합니다.
- 구현된 기능이 원래 사양과 일치하는지 확인합니다.
- 테스트가 통과되고 적용 범위가 요구사항을 충족하는지 확인합니다.
- 구현이 기술 계획을 따르는지 확인합니다.
참고: 이 명령은 tasks.md에 완전한 작업 분류가 존재한다고 가정합니다. 작업이 불완전하거나 누락된 경우 /speckit-tasks를 실행하여 작업 목록을 다시 생성할 것을 제안합니다.
필수 사후 실행 훅
사용자에게 완료를 보고하기 전에 이 섹션을 반드시 완료해야 합니다.
프로젝트 루트에 .specify/extensions.yml 파일이 있는지 확인합니다.
- 파일이 없거나
hooks.after_implement키 아래에 등록된 훅이 없으면 완료 보고서로 건너뜁니다. - 파일이 있으면 읽고
hooks.after_implement키 아래의 항목을 확인합니다. - YAML을 구문 분석할 수 없거나 유효하지 않은 경우, 조용히 건너뛰지 말고 사용자에게
.specify/extensions.yml파일을 읽을 수 없다고 알리고(구문 분석 오류 포함) 등록된 필수(optional: false) 훅을 포함한 어떤 훅도 확인되지 않았다고 알린 후 완료 보고서로 계속 진행합니다. enabled가 명시적으로false인 훅은 걸러냅니다.enabled필드가 없는 훅은 기본적으로 활성화된 것으로 간주합니다.- 나머지 각 훅에 대해 훅
condition표현식을 해석하거나 평가하려고 시도하지 마십시오:- 훅에
condition필드가 없거나 null/비어 있으면 훅을 실행 가능한 것으로 간주합니다. - 훅이 비어 있지 않은
condition을 정의하면 훅을 건너뛰고 조건 평가를 HookExecutor 구현에 맡깁니다.
- 훅에
- 훅 명령 이름에서 명령 호출을 구성할 때 점(
.)을 하이픈(-)으로 바꿉니다. 예를 들어,speckit.git.commit→/speckit-git-commit이 됩니다. - 각 실행 가능한 훅에 대해
optional플래그에 따라 다음을 출력합니다:- 필수 훅 (
optional: false) — 각 필수 훅에 대해EXECUTE_COMMAND:를 반드시 출력해야 합니다:
위 블록을 출력한 후 반드시 훅을 실제로 호출하고 완료될 때까지 기다려야 합니다. 이 에이전트/세션에서 직접 명령을 실행하는 것과 동일한 방식으로 실행합니다(호출은 위에 표시된 리터럴## 확장 훅 **자동 훅**: {extension} 실행 중: `/{command}` EXECUTE_COMMAND: {command}{command}ID와 다를 수 있습니다. 예: skills-mode 에이전트는/skill:speckit-...또는$speckit-...로 실행). 블록을 출력하는 것만으로는 훅이 실행되지 않습니다. - 선택적 훅 (
optional: true):## 확장 훅 **선택적 훅**: {extension} 명령: `/{command}` 설명: {description} 프롬프트: {prompt} 실행하려면: `/{command}`
- 필수 훅 (
완료 보고서
완료된 작업 요약과 함께 최종 상태를 보고합니다.
완료 조건
- tasks.md의 모든 작업이 완료되고
[X]로 표시됨 - 사양, 계획 및 테스트 적용 범위에 대해 구현이 검증됨
- 위의 필수 사후 실행 훅 규칙에 따라 확장 훅이 디스패치되거나 건너뛰어짐
- 완료된 작업 요약과 함께 사용자에게 완료가 보고됨