spec-kitty은(는) 무엇을 하나요?
진지한 소프트웨어 개발자를 위한 스펙 기반 개발(Spec-Driven Development). Claude, Cursor, Gemini, Codex와 함께하는 스펙 코딩. 칸반 대시보드, git 워크트리, 자동 병합 등.
개요
spec-kitty는 AI 에이전트(Claude Code, Cursor, Gemini, Codex)를 사용하여 스펙 기반 개발 워크플로를 구현하는 스킬입니다. 이 스킬은 다음을 지원합니다:
- 스펙 코딩: 상세한 스펙을 먼저 작성하고, AI가 스펙에 맞춰 코드를 생성/수정합니다.
- 칸반 대시보드: 작업 항목의 진행 상태(To Do, In Progress, Done)를 시각적으로 추적합니다.
- git 워크트리: 동시에 여러 브랜치에서 작업할 수 있도록 git 워크트리를 관리합니다.
- 자동 병합: 스펙 충족 시 자동으로 브랜치를 병합합니다.
지원 플랫폼
- Claude Code (Anthropic)
- Cursor (Cursor.sh)
- Gemini (Google)
- Codex (OpenAI)
사용 방법
- 프로젝트 루트에
specs/디렉토리를 생성합니다. - 마크다운 파일로 스펙을 작성합니다 (예:
specs/login.md). - AI 에이전트에게
@spec-kitty generate specs/login.md명령을 내립니다. - AI가 스펙을 읽고 구현 코드를 생성합니다.
- 칸반 대시보드를 확인하려면
@spec-kitty dashboard를 사용합니다.
명령어
| 명령어 | 설명 |
|---|---|
@spec-kitty generate <spec-file> | 스펙 파일을 기반으로 코드를 생성합니다. |
@spec-kitty dashboard | 칸반 대시보드를 표시합니다. |
@spec-kitty review <branch> | 브랜치의 변경 사항을 스펙과 비교하여 리뷰합니다. |
@spec-kitty merge <branch> | 스펙 충족 시 브랜치를 병합합니다. |
@spec-kitty worktree <branch> | 새 git 워크트리를 생성합니다. |
환경 변수
SPEC_KITTY_AUTO_MERGE: 자동 병합 활성화 (true/false, 기본값:false)SPEC_KITTY_DASHBOARD_PORT: 대시보드 포트 (기본값:8080)
예시
# 스펙 생성
@spec-kitty generate specs/api.md
# 칸반 대시보드 열기
@spec-kitty dashboard
# 기능 브랜치 생성 및 작업
@spec-kitty worktree feature/new-auth
스펙 작성 가이드
스펙 파일은 다음 구조를 따라야 합니다:
# 기능 이름
## 요구 사항
- ...
## API 설계
- ...
## 테스트 기준
- ...
기여
버그 리포트나 기능 제안은 GitHub Issues를 통해 제출해 주세요.
라이선스
MIT