本文へスキップ
hdknr blog

GitHub Spec Kit

GitHub が公開する MIT ライセンスの仕様駆動開発ツールキット。specify CLI で既存の AI エージェントにスラッシュコマンドを足し、constitution(原則)→ 仕様 → 計画 → タスク → 実装 → converge の流れで進める

概要

GitHub Spec Kit は GitHub が 2025 年 9 月に公開した、仕様駆動開発 のオープンソースのツールキット(MIT)である。専用 IDE の Kiro と違い、Claude Code・GitHub Copilot・Gemini CLI・Codex CLI など手元のエージェント(40 以上)にスラッシュコマンドとテンプレートを追加する形で動く。最大の特徴は、すべての機能に共通して守らせる**原則(constitution)**で AI の判断を縛ることにある。

詳細

導入

CLI は specify(パッケージ specify-cli)。Python 3.11 以上と uv(推奨)か pipx が前提。

uv tool install specify-cli
specify init my-project --integration claude   # copilot / gemini / codex / cursor-agent / kiro-cli など

インストールせずに uvx --from git+https://github.com/github/spec-kit.git specify init … で 1 回だけ実行することもできる。specify version・specify self check で版と更新を確かめる。

コマンドの流れ

コマンドは /speckit.<名前>(ドキュメントにはハイフン区切りの表記もあるので、実際はエージェントの補完に出る名前を使う)。

順コマンド役割必須/任意
1constitutionプロジェクトの原則を決める最初に 1 回
2specify自然言語の説明から機能の仕様を作る必須
3clarify仕様の足りない点を的を絞って質問する任意
4plan仕様から設計の成果物を作る必須
5checklist要件の明確さ・漏れを確かめる(要件の単体テスト)任意
6tasks依存関係順の tasks.md を作る必須
7analyze成果物間の矛盾・抜け・曖昧さを報告(読み取りのみ)任意
8implementタスクを依存関係順に実行する必須
9convergeコードベースを仕様・計画・タスクと照らし合わせる必須

短い流れは specify → plan → tasks → implement → converge で、converge が「Converged」と報告するまで implement と converge を繰り返す。

要点は、specify には「何を・なぜ」だけを書き、技術の選択は plan で渡すこと。仕様と技術選定を分けておけば、仕様を変えずに技術だけを差し替えられる。

constitution(原則)

memory/constitution.md に置くプロジェクト共通のルールで、plan の段階で計画が原則に反していないかを関門として確かめる。AI が勝手に抽象化を増やしたりテストを後回しにしたりするのを抑える仕組みである。考え方をまとめた spec-driven.md の例は次のとおり(第 4〜6 条はプロジェクトごとに定める)。

条文内容
第 1 条 Library-Firstすべての機能は独立したライブラリとして始める
第 2 条 CLI Interface Mandateテキスト入出力と JSON に対応した CLI を持つ
第 3 条 Test-First Imperative厳格なテスト駆動開発に従う
第 7 条 Simplicity最初の実装ではプロジェクトを最大 3 つに
第 8 条 Anti-Abstractionフレームワークを余計な抽象化で包まない
第 9 条 Integration-First Testing結合テストを優先する

成果物

原則はプロジェクトに 1 つ、ほかは機能ごとに spec.md・plan.md・research.md・data-model.md・contracts/・quickstart.md・tasks.md ができる。作業用ファイルは .specify/ の下で、置き場所は版によって変わる。現在は本体がブランチを作らず、作業中の機能は .specify/feature.json で管理する(番号付きブランチ 001-feature-name はオプションの git 拡張。spec-driven.md の「自動でブランチを作る」は以前の動き)。

注意点

Böckeler 氏(martinfowler.com)は 2025 年 9 月の試用で、Spec-Anchored を志向しつつ実態は Spec-First にとどまる、Markdown が多く冗長でレビューが大変、問題の大きさに対して過剰、エージェントが指示のすべてには従わない、と評価した。その後 converge が加わったが、次の点は今も当てはまる。

まずは小さな機能 1 つで specify から converge までを 1 回通すのがよい。

関連ページ

ソース記事