OpenSource-Hub

spec-kit

CLI 도구

github/spec-kit

사양 기반 개발을 보조하는 AI 툴킷.

개요

Spec Kit은 오픈소스 CLI 도구 키트로, 사양 기반 개발(Spec-driven Development)을 구현합니다. 사양 생성, 구현 계획 수립 및 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 (3)

문제 해결
‘specify init --ai codex’를 실행할 때 SKILL.md에서 constitution.md가 왜 참조되지 않습니까?

Specify CLI v0.8.0의 버그로, Codex AI로 초기화할 때 .specify/memory/constitution.md를 읽도록 하는 지시사항이 누락되었습니다. 이 문제가 수정된 최신 버전으로 업그레이드하세요.

원본 Issue #2650
문제 해결
'내가 `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에서 추적하세요.

원본 Issue #1983
문제 해결
AI agents가 반복적인 개별 댓글 답변으로 PR 리뷰를 도배하는 것을 방지하는 방법?

AGENTS.md에 'PR 리뷰 코멘트 응답' 섹션을 추가하고 다음 규칙을 포함합니다: (1) 리뷰 코멘트마다가 아니라 리뷰 라운드당 하나의 최상위 요약 코멘트를 게시합니다. (2) 인라인 답변은 의견 불일치, 연기 또는 명확하지 않은 수정 사항에만 사용합니다. (3) '대화 해결'을 절대 클릭하지 않습니다. (4) 이모지, 축하 텍스트 또는 리뷰어의 항목을 다시 언급하는 것을 피합니다. (5) 모든 피드백이 처리된 후 한 번 재검토를 요청합니다. 또한 에이전트 자기 공개(에이전트 이름, 모델, 인간 행위자)를 요구합니다.

원본 Issue #2849