개요
Spec Kit은 사양 기반 개발을 구현하는 오픈 소스 CLI 툴킷입니다. 사양 작성, 구현 계획 생성, AI 코딩 어시스턴트와 연동한 작업 실행 명령을 제공하여 개발자가 제품 시나리오와 예측 가능한 결과에 집중할 수 있도록 도와줍니다.
README 미리보기
\n \n 🌱 Spec Kit\n Build high-quality software faster.\n\n\n\n An open source toolkit that allows you to focus on product scenarios and predictable outcomes instead of vibe coding every piece from scratch.\n\n\n\n \n \n \n \n\n\n---\n\n## Table of Contents\n\n- [🤔 What is Spec-Driven Development?](#-what-is-spec-driven-development)\n- [⚡ Get Started](#-get-started)\n- [📽️ Video Overview](#️-video-overview)\n- [🧩 Community Extensions](#-community-extensions)\n- [🎨 Community Presets](#-community-presets)\n- [🚶 Community Walkthroughs](#-community-walkthroughs)\n- [🛠️ Community Friends](#️-community-friends)\n- [🤖 Supported AI Coding Agent Integrations](#-supported-ai-coding-agent-integrations)\n- [🔧 Specify CLI Reference](#-specify-cli-reference)\n- [🧩 Making Spec Kit Your Own: Extensions & Presets](#-making-spec-kit-your-own-extensions--presets)\n- [📚 Core Philosophy](#-core-philosophy)\n- [🌟 Development Phases](#-development-phases)\n- [🎯 Experimental Goals](#-experimental-goals)\n- [🔧 Prerequisites](#-prerequisites)\n- [📖 Learn More](#-learn-more)\n- [📋 Detailed Process](#-detailed-process)\n- [🔍 Troubleshooting](#-troubleshooting)\n- [💬 Support](#-support)\n- [🙏 Acknowledgements](#-acknowledgements)\n- [📄 License](#-license)\n\n## 🤔 What is Spec-Driven Development?\n\nSpec-Driven Development **flips the script** on traditional software development. For decades, code has been king — specifications were just scaffolding we built and discarded once the "real work" of coding began. Spec-Driven Development changes this: **specifications become executable**, directly generating working implementations rather than just guiding them.\n\n## ⚡ Get Started\n\n### 1. Install Specify CLI\n\nChoose your preferred installation method:\n\n> **Important:** The only official, maintained packages for Spec Kit are published from this GitHub repository. Any packages with the same name on PyPI are **not** affiliated with this project and are
FAQ (5)
문제 해결‘specify init --ai codex’를 실행할 때 SKILL.md에서 constitution.md가 왜 참조되지 않습니까?
Specify CLI v0.8.0의 버그로, Codex AI로 초기화할 때 .specify/memory/constitution.md를 읽도록 하는 지시사항이 누락되었습니다. 이 문제가 수정된 최신 버전으로 업그레이드하세요.
문제 해결'내가 `specify init --ai claude`를 실행할 때 CLAUDE.md가 생성되지 않는 이유는 무엇인가요?'
이것은 SpecKit v0.4.1의 알려진 버그입니다. 해결 방법으로, 프로젝트 루트에 다음 내용으로 CLAUDE.md를 수동으로 생성하세요:
## Claude의 역할
먼저 .specify/memory/constitution.md를 읽으세요. 이 파일은 이 프로젝트의 권위 있는 진실 공급원입니다. 그 안의 모든 것은 협상할 수 없습니다.
## SpecKit 명령어
- /speckit.specify — 스펙 생성
- /speckit.plan — 계획 생성
- /speckit.tasks — 작업 목록 생성
- /speckit.implement — 계획 실행
## 모호성에 관하여
스펙이 누락되었거나, 불완전하거나, 헌법과 충돌하는 경우 — 멈추고 질문하세요. 추론하지 마세요. 진행하지 마세요.
이 파일은 세션 시작 시 Claude Code가 SpecKit 방법론과 헌법을 인식하도록 보장합니다. 공식 수정 사항은 https://github.com/github/spec-kit/issues/1983에서 추적하세요.
문제 해결카탈로그에 더 최신 버전이 표시된 후 핀으로 고정된 이전 컴포넌트에 대해 `specify bundle install`이 실패하는 이유는 무엇인가요?
정확한 catalog-release 및 bundle-pin 해석(멀티 버전 카탈로그 및 번들러 수정 사항)이 포함된 Spec Kit 릴리스로 업그레이드하세요. install-allowed 카탈로그는 버전별 releases 메타데이터에 URL, checksum, requirements를 포함한 이전 릴리스를 유지해야 하며, 최상위 필드는 여전히 현재 릴리스를 식별합니다. 그런 다음 specify bundle install을 실행하세요. 번들러는 최종 선택된 신뢰할 수 있는 소스에서 각 컴포넌트의 정확한 고정 버전을 해석하고, checksum과 다운로드된 ID/버전을 검증하며, 더 이상 현재 릴리스로 대체하지 않습니다. 릴리스를 수동으로 선택하려면 specify <family> add <id> --version <version>을 사용하고, 사용 가능한 릴리스는 specify <family> info <id> --versions로 확인하세요. 번들의 경우 specify bundle add <id> --version <version>은 번들 릴리스 자체를 선택하며 bundle.yml의 컴포넌트 핀을 재정의하지 않습니다. 요청한 버전을 포함하는 신뢰할 수 있는 install-allowed 소스가 없으면 명령이 명시적으로 실패합니다. discovery-only 커뮤니티 카탈로그는 current-tip 목록으로 유지되며, 과거 버전 설치 소스로 사용할 수 없습니다.
문제 해결AI agents가 반복적인 개별 댓글 답변으로 PR 리뷰를 도배하는 것을 방지하는 방법?
AGENTS.md에 'PR 리뷰 코멘트 응답' 섹션을 추가하고 다음 규칙을 포함합니다: (1) 리뷰 코멘트마다가 아니라 리뷰 라운드당 하나의 최상위 요약 코멘트를 게시합니다. (2) 인라인 답변은 의견 불일치, 연기 또는 명확하지 않은 수정 사항에만 사용합니다. (3) '대화 해결'을 절대 클릭하지 않습니다. (4) 이모지, 축하 텍스트 또는 리뷰어의 항목을 다시 언급하는 것을 피합니다. (5) 모든 피드백이 처리된 후 한 번 재검토를 요청합니다. 또한 에이전트 자기 공개(에이전트 이름, 모델, 인간 행위자)를 요구합니다.
방법토큰을 저장하지 않고 GitHub CLI (gh) 자격 증명으로 Specify를 인증하는 방법은?
Specify에는 아직 네이티브 github-cli 인증 모드가 없습니다(issue #4953에서 제안됨). 해결 방법으로 기존 token_env 모드를 사용하세요. ~/.specify/auth.json에서 GitHub 프로바이더를 "auth": "token_env" 및 "token_env": "GH_TOKEN"으로 구성한 다음, 토큰이 필요할 때마다 확인되도록 하여 명령을 실행합니다: GH_TOKEN="$(gh auth token)" specify <command>. 이렇게 하면 auth.json에 토큰을 저장된 상태로 두지 않을 수 있지만, 호출할 때마다 또는 셸 프로필을 통해 변수를보내야 합니다. 계획된 github-cli 모드는 gh auth token을 자동으로 실행하며(실행 시 호스트당 한 번 캐시되고, 셸을 사용하지 않고, 누락되었거나 인증되지 않은 gh에 대한 타임아웃 및 오류 처리 포함), "auth": "github-cli"로 구성됩니다.