github/spec-kit

Spec Kit – AI 지원 개발 툴킷

무엇인가요 – AI 코드 에이전트(예: GitHub Copilot)와 함께 구조화되고 재사용 가능한 "스킬" 세트를 통해 작업할 수 있는 오픈소스 파이썬 툴킷입니다. 세 가지 준비된 프로세스를 제공합니다:

프로세스	목적	주요 출력물
사양 기반 개발(SDD)	새로운 기능 또는 전체 애플리케이션 구축	사양, 기술 계획, 작업 목록, 구현 아티팩트, 사양과 코드가 일치하는지 확인하는 수렴 보고서
버그 수정	결함 진단 및 수리	원인 평가, 범위 제한된 수정안, 검증 보고서(`verified`, `partial`, `failed`)
아이디어 평가	아이디어가 추진할 가치가 있는지 평가	수집된 증거, 결정 문서(`go`, `needs-clarification`, `kill`)

이 세 가지는 모두 독립적인 진입점입니다. 어떤 것부터 시작해도 되며, 확장 기능, 프리셋, 워크플로우 또는 번들로 자체 프로세스를 통합할 수도 있습니다.

작동 방식

uv 설치기로 CLI(specify-cli)를 설치합니다.
프로젝트 디렉터리 생성(specify init my-project --integration copilot).
해당 디렉터리 내에서 AI 코드 에이전트를 시작합니다.
에이전트의 채팅에서 제공된 슬래시 스타일 명령어(예: /speckit-specify, /speckit-bug-fix)를 실행합니다. 에이전트는 요청된 아티팩트와 다음 단계 지침을 반환합니다.
반복 작업 – SDD의 경우 implement → converge를 반복하여 에이전트가 Converged라고 보고할 때까지; 버그 수정의 경우 assess → fix → test; 아이디어 평가의 경우 intake → research → define → shape → decide를 실행합니다.

이 툴킷은 명령어를 터미널에서 실행하지 않습니다. 대신 AI 에이전트가 명령어를 해석하고 코드 작성, 문서 생성, 테스트 실행 등의 작업을 수행한 후, 결과를 숨겨진 .specify/ 폴더에 구조화된 형태로 저장합니다.

주요 기능 (README에 설명됨)

에이전트 중심 워크플로우 – 채팅 기반 AI 에이전트에 최적화된 명령어로, 인간이 검토에 참여하도록 유지합니다.
3가지 내장 프로세스 – 기능 개발, 버그 수리, 제품 아이디어 검토를 커버합니다.
확장 가능 – 선택적 확장 기능(bug, assess)을 추가할 수 있으며, 커뮤니티는 추가 확장 기능, 프리셋, 번들, 사용자 정의 워크플로우를 제공합니다.
템플릿 기반 – 각 단계는 재사용 가능한 템플릿을 사용하며, 로컬에서 오버라이드 가능합니다.
크로스플랫폼 – Linux, macOS, Windows에서 작동합니다.
파이썬 전용 런타임 – Python 3.11+ 및 uv 패키지 매니저가 필요합니다.

일반적인 사용 사례

Copilot(또는 다른 지원 에이전트)를 사용하는 팀이 고수준 아이디어를 생산 코드로 전환할 수 있는 반복 가능하고 문서화된 방법을 원할 때.
단독 개발자가 진단과 수정을 분리한 가이드된 AI 보조 버그 수정 워크플로우를 원할 때.
제품 매니저나 디자이너가 새로운 기능에 자원을 투입하기 전에 가벼운 증거 수집 프로세스가 필요할 때.
조직이 자체 내부 도구를 구축하지 않고도 사양 우선 사고 방식을 강제하고자 할 때.

시작하기 (README의 빠른 단계)

# 1. uv(미설치 시)와 CLI 설치
uv tool install specify-cli

# 2. 선택한 AI 에이전트 통합으로 새 프로젝트 초기화
specify init my-project --integration copilot
cd my-project

프로젝트 폴더에서 AI 코드 에이전트(예: Copilot 채팅)를 엽니다.
원하는 프로세스의 슬래시 명령어를 실행합니다(정확한 명령어 시퀀스는 README 테이블 참조).
에이전트의 출력을 따르고, 필요 시 생성된 마크다운 아티팩트를 편집한 후 다음 단계로 진행합니다.

문서 및 커뮤니티

전체 CLI 참조, 프로세스 명령어 문서, 워크스루는 GitHub Pages에 호스팅됨(README 내 링크 참조).
커뮤니티 확장 기능, 프리셋, 번들은 문서의 커뮤니티 섹션에 목록됨.
기여는 표준 GitHub 이슈/PR 흐름을 통해 환영하며, 프로젝트는 MIT 라이선스를 따릅니다.

TL;DR

Spec Kit은 간단한 채팅 명령어를 사용해 AI 코드 에이전트를 명확히 정의된 개발, 디버깅, 아이디어 평가 파이프라인으로 이끄는 파이썬 기반 프레임워크입니다. 모든 아티팩트는 프로젝트 로컬의 .specify/ 디렉터리에 저장되어 작업이 재현 가능하고 감사 가능하며, 각 단계에서 인간이 제어를 유지합니다.