本文へスキップ
hdknr blog
戻る

GitHub Spec Kit とは? 仕様駆動開発のコマンド・constitution と Kiro との違い

GitHub Spec Kit は、GitHub が公開しているオープンソース(MIT ライセンス)の仕様駆動開発(SDD)のツールキットです。Claude Code や GitHub Copilot などの AI コーディングエージェントに、「原則 → 仕様 → 計画 → タスク → 実装」という決まった進め方と、そのためのテンプレートを持ち込みます。

専用の AI 開発環境を使う Kiro とは違い、Spec Kit は手元のエージェントにスラッシュコマンドを追加する形で動きます。

この記事では、Spec Kit の公式ドキュメント(github.github.io/spec-kit)とリポジトリ(github/spec-kit)をもとに、インストール方法、コマンドの流れ、原則(constitution)の考え方、使うときの注意点を整理します。内容は 2026 年 11 月 13 日時点のもので、最新のリリースは v1.4.0 です。

あわせて読みたい関連記事です。

Spec Kit の概要

項目内容
提供GitHub(リポジトリ github/spec-kit)
ライセンスMIT
発表2025 年 9 月 2 日の GitHub ブログ(Spec-driven development with AI: Get started with a new open source toolkit)
CLIspecify(パッケージ名 specify-cli)
前提Python 3.11 以上、uv(Python のパッケージ管理ツール。推奨)か pipx、対応する AI コーディングエージェント
対応 OSLinux、macOS、Windows

README は Spec Kit を「AI コーディングエージェントに、構造化されたプロセス、再利用できるテンプレート、記録に残る成果物を与えるオープンソースのツールキット」と説明しています。

Spec Kit のインストール方法と specify init

specify CLI を入れて、プロジェクトを初期化します(Installation)。--integration で、使う AI コーディングエージェントを指定します。

# CLI をインストール(PyPI から)
uv tool install specify-cli

# プロジェクトを初期化(Claude Code を使う場合)
specify init my-project --integration claude
cd my-project

インストールせずに 1 回だけ実行することもできます(One-time)。

uvx --from git+https://github.com/github/spec-kit.git specify init my-project --integration claude

インストール後は、specify version でバージョンを、specify self check で新しいリリースがあるかを確かめられます。

対応しているエージェント

Integrations のページには 40 を超えるエージェントが並んでいます。主なものは次のとおりです。

エージェント--integration の値
Claude Codeclaude
GitHub Copilotcopilot
Gemini CLIgemini
Codex CLIcodex
Cursorcursor-agent
Kiro CLIkiro-cli

Kiro の CLI も対象に入っているので、Kiro の上で Spec Kit の進め方を使うこともできます。

Spec Kit のコマンド一覧と使い方

初期化すると、エージェントに Spec Kit のスラッシュコマンドが追加されます。公式ドキュメントでは、/speckit.specify(ドット区切り)と /speckit-specify(ハイフン区切り)の 2 つの表記が使われています。実際の名前は、エージェントのコマンド補完に出てくるものを使ってください。

Quickstart に沿って、コマンドを順に並べます。表では先頭の /speckit. を省いています。

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

原則を決めたあとの短い流れは、specify → plan → tasks → implement → converge です。implement と converge は、converge が「Converged(収束した)」と報告するまで繰り返します。

エージェントのチャット欄で、次のように入力して進めます(シェルではありません)。

/speckit.specify 写真をアルバムにまとめて共有できるアプリを作る。アルバムは日付でまとめ、ドラッグ&ドロップで並べ替えられる
/speckit.plan フロントエンドは Vite と素の HTML/CSS/JavaScript、データはローカルの SQLite に保存する
/speckit.tasks
/speckit.implement
/speckit.converge

ポイントは、specify では「何を・なぜ作るか」だけを書き、技術の選択は plan で渡すことです。仕様と技術選定を分けておくと、仕様を変えずに技術だけを差し替えることもできます。

Spec Kit の constitution(原則)とは

constitution で作る原則は、すべての機能に共通して守らせるルールです。Spec Kit の考え方をまとめた 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結合テストを優先する

これらはあくまで考え方の例なので、自分のプロジェクトでは constitution で必要な原則を書きます。

spec-driven.md によれば、plan の段階では、計画が原則(単純さ・抽象化の禁止・結合テストの優先など)に反していないかを関門として確かめます。AI が勝手に抽象化を増やしたり、テストを後回しにしたりするのを、原則で抑える仕組みです。

Spec Kit が作るファイルと機能の管理

spec-driven.md では、次のような成果物が作られると説明されています。原則はプロジェクト全体で 1 つ、それ以外は機能ごとに作られます。

ファイル単位内容
memory/constitution.mdプロジェクトプロジェクトの原則
spec.md機能機能の仕様
plan.md機能実装計画
research.md機能技術調査の結果
data-model.md機能データモデル
contracts/機能API などの契約
quickstart.md機能動作確認の手順
tasks.md機能タスクの一覧

Spec Kit の作業用のファイルは .specify/ の下に置かれます。ファイルの置き場所はバージョンによって変わっているので、実際の構成は specify init の結果で確かめてください。

機能ごとのブランチ

現在のクイックスタートでは、Spec Kit 本体はブランチを作りません。作業中の機能は、ブランチではなく .specify/feature.json で管理されます。番号付きのブランチ(001-feature-name など)が必要なら、オプションの git 拡張を使います。

なお spec-driven.md には、specify が 003-chat-system のような番号付きのブランチを自動で作ると書かれていますが、これは以前の動きです。

Spec Kit のデメリットと使うときの注意点

Birgitta Böckeler 氏は、SDD ツールを比較した記事(Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl)で Spec Kit を試し、次のように評価しています。Spec-First・Spec-Anchored という分類については、SDD の概要記事で説明しています。

氏自身が、ツールは急速に変わっているので 2025 年 9 月に試した後で変わっている可能性がある、と断っています。実際、その後のリリースで加わった converge は、コードベースを仕様と照らし合わせる役割を持っています。それでも、次の点は今も当てはまります。

Kiro・OpenSpec との違い

Spec KitKiroOpenSpec
形態既存のエージェントに追加するツールキット専用の AI 開発環境(IDE・CLI など)既存のエージェントに追加するツール
提供GitHub(MIT ライセンス)AWSオープンソース(MIT ライセンス)
進め方原則 → 仕様 → 計画 → タスク → 実装要件 → 設計 → タスク → 実装変更の提案 → 適用 → アーカイブ
特徴原則(constitution)で AI の判断を縛るIDE に統合された Spec・Steering・Hooks変更を差分で扱い、既存のコードベースにも対応する

選び方の目安は次のとおりです。

まとめ



前の記事
Kiro とは? AWS の仕様駆動 AI IDE の Spec・Steering・Hooks と料金プラン
次の記事
BDD・Gherkin・Cucumber の違いとは? キーワード一覧と日本語での書き方入門