spec-kit

초기 설정

`uv` 설치

uv 는 파이썬 패키지 매니저로 설치되어 있지 않은 경우에만 진행하며, brew 기준으로 작성되었습니다.

brew install uv

`specify-cli` 설치

해당 문서에서는 영구적 설치 방법에 대해서만 다루고 있습니다. 일회성 사용에 대한 내용은 리드미를 참고해주세요.

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
 
specify init .

명령어

기본 명령

명령	설명
`/speckit.constitution`	프로젝트 관리 원칙 및 개발 지침을 만들거나 업데이트합니다.
`/speckit.specify`	무엇을 만들고 싶은지 정의하세요 (요구사항 및 사용자 스토리).
`/speckit.plan`	선택한 기술 스택으로 기술 구현 계획을 만드세요.
`/speckit.tasks`	구현을 위한 실행 가능한 작업 목록을 생성합니다.
`/speckit.implement`	계획에 따라 기능을 구축하기 위한 모든 작업을 실행합니다.

추가 명령

명령	설명
`/speckit.clarify`	미지정된 영역을 명확히 합니다 (`/speckit.plan` 이전에 권장됨, `/quizme` 이전).
`/speckit.analyze`	교차 아티팩트 일관성 및 커버리지 분석을 수행합니다 (`/speckit.tasks` 이후, `/speckit.implement` 이전).
`/speckit.checklist`	요구 사항의 완전성, 명확성 및 일관성을 검증하는 사용자 지정 품질 체크리스트를 생성합니다 (예: "영어 단위 테스트").

활용 상세

초기화가 완료되었다는 가정 하에 다음과 같은 프로세스로 개발 진행

이하 명령어는 speckit init . 실행 시 선택했던 AI Agent 내에서 실행하시면 됩니다.

신규 프로젝트

# 프로젝트 관리 원칙 및 지침 생성
# 추가 요구사항 예시 : Next.js Best Practices 기반으로 클린 코드를 작성해
/speckit.constitution [추가_요구사항]
 
# 요구사항 및 사용자 스토리 정의
# 예시 : 할 일 CRUD와 캘린더 뷰, 진행 상황 파악을 위한 대시보드가 있는 투두 앱을 만들거야.
/speckit.specify [요구사항_및_사용자_스토리]
 
# Optionoal. 기능 명세에 대한 명확한 정의 진행
# QnA 형식으로 진행되며 여러가지 옵션을 제시
/speckit.clarify
 
# 기술 구현 계획 진행
# 예시 : 라우팅을 위해 `react-router` 를 사용하고, 상태 관리는 Tanstack Query, Zustand를 활용하며 백엔드는 Supabase로 구현해줘
/speckit.plan [구현_계획]
 
# 실행 가능한 작업 목록 생성
/speckit.tasks
 
# 작업 목록 계획에 따라 기능 구축을 위한 작업 실행
# 예시 : Phase 1, T001(Task ID)
/speckit.implement [구현_대상]

spec-kit

On this page