Spec Kit(GitHub)とは?仕様駆動開発の使い方・インストール・コマンドを徹底解説
「AIにコードを書かせたら、思っていたものと違う実装が出てきた」——AIコーディングエージェントを使う現場でよく起きる悩みです。原因の多くはAIの性能ではなく、仕様が曖昧なまま実装を始めてしまうことにあります。Spec Kit(スペックキット)は、GitHubが公開したオープンソースのツールキットで、この問題を「仕様駆動開発(SDD)」という進め方で解決するのが特徴です。本記事では、Spec Kitとは何かという基本から、Python製CLIのインストール手順、speckit系スラッシュコマンドの一覧、対応AIエージェント、料金、Kiro・cc-sddなど他ツールとの比較、導入判断の軸、よくある質問までを2026年7月時点の情報で整理します。
まとめ:Spec Kitの要点と導入判断の軸
Spec Kitは、GitHubが2025年9月に公開した仕様駆動開発(SDD)のためのオープンソース・ツールキットです。Python製のSpecify CLIを uv で導入し、speckit系のスラッシュコマンドで「原則→仕様→計画→タスク→実装」を段階的に進めることで、AIコーディングの「思っていたのと違う」を減らせます。要点は次の5つです。
- 本体は無料(MITライセンス)。実際のコストは組み合わせるAIエージェント側に依存する
- Specify CLIはPython製。
uv経由で導入し、npmからは入れない - コマンドはspeckit接頭辞に統一。原則→仕様→計画→タスク→実装の順に進む
- 対応エージェントは30種以上。GitHub CopilotやClaude Codeなど手元の環境で始められる
- 数行のバグ修正など小さな作業にはオーバーヘッドが大きく不向き
更新が非常に速いツールなので、コマンド仕様やバージョンは公式リポジトリで確認しつつ、まずはGitHub Copilotの無料プランなど費用のかからない組み合わせで小さく試すのが安全です。導入すべきかどうかの具体的な判断条件は、本文後半の「採用してよい場面と見送るべき場面」で言い切りで示します。
Spec Kitとは?GitHubが公開した仕様駆動開発ツールキット
Spec Kitは、GitHubが2025年9月に公開した、仕様駆動開発(Spec-Driven Development/SDD)を実践するためのオープンソース・ツールキットです。ライセンスはMITで、ツール自体は無料で利用できます。中心となるのは Specify CLI というコマンドラインツールと、仕様書・計画・タスクのテンプレート群、そしてAIエージェント上で動く一連のスラッシュコマンドです。
Spec Kitの考え方はシンプルです。いきなりコードを書かせる(いわゆるバイブコーディング)のではなく、まず「何を・なぜ作るのか」という仕様を文章化し、それを起点に計画・タスク・実装へとつなげます。仕様書を使い捨ての資料ではなく、開発全体を導く「真実のソース(Source of Truth)」として扱う点が特徴で、要件が変わったときはまず仕様を更新し、AIエージェントがそれに沿ってコードを再生成します。GitHub自身もこれを実験的な取り組みと位置づけており、コミュニティのフィードバックを受けて非常に速いペースで更新が続いています(2026年7月時点でもv0.0系のリリースが継続中)。
仕様駆動開発(SDD)とは?従来開発・バイブコーディングとの違い
仕様駆動開発(SDD)は、開発プロセスの中心に仕様書を置く手法です。テスト駆動開発(TDD)がテストを先に書くのと同じように、SDDでは仕様を先に固めてから実装に進みます。ユーザーストーリーや受け入れ条件を先に明確化することで、AIエージェントへの指示がぶれず、手戻りや認識違いを減らせます。
「バイブコーディング」が短い指示で一気に作らせる行き当たりばったりの進め方だとすれば、SDDは仕様→計画→タスク→実装と段階を分け、各段階が成果物(artifact)を生み、それを次の段階が受け取る多段階の進め方です。試作には前者が向きますが、既存コードベースへの機能追加やチームでの本番開発では、後者のほうが意図の取り違えを防ぎやすくなります。SDDという言葉自体は2010年代のAPI設計(OpenAPIを先に書くDesign-First)でも使われていましたが、AIコーディングの普及とともに再注目されるようになりました。SDDという手法そのものの背景や従来手法との違いを深く知りたい方は、仕様駆動開発(SDD)とは何かを従来手法との違いから整理した解説もあわせてご覧ください。本記事はその実践ツールであるSpec Kitの導入・操作を担当する位置づけです。
Spec Kitの対応AIエージェント:30種超の一覧と組み合わせの目安
Spec Kitは特定のIDEやAIに縛られず、多くのAIコーディングエージェントと組み合わせて使えるのが強みです。2026年時点で対応エージェントは30種類以上に拡大しています。代表的なものは次のとおりです(対応一覧は更新が速いため、最新は公式リポジトリで確認してください)。
| エージェント | 種別 | 補足 |
|---|---|---|
| GitHub Copilot | IDE統合/CLI | 無料プランでも試せる |
| Claude Code | CLI | スラッシュコマンド連携が円滑 |
| Cursor | AIエディタ | VS Codeベースで導入しやすい |
| Codex CLI | CLI | skillsモードは記法が異なる |
| Gemini CLI | CLI | 個人向け提供は終了(移行) |
| Windsurf/Roo Code他 | 各種 | 合わせて30種以上に対応 |
普段お使いのツールがそのまま使えるケースが多いので、まずは手元のエージェントで試すのが近道です。組み合わせを選ぶ際の注意として、Gemini CLIは2026年6月に個人向け提供が終了し、後継のAntigravity CLIへ移行しています(法人契約は条件が異なるため要確認)。過去の解説記事に載っている組み合わせが現在も使えるとは限らないので、エージェント側の提供状況もあわせて確認してから選んでください。
Spec Kitのインストール方法:uvとSpecify CLIの導入手順
ここは旧来の解説で誤りが多い箇所です。前提として、Specify CLIはPython製で、Pythonのツール管理ツール uv を使ってインストールします。「npm install で入れる」「Node.js製のCLI」という説明は誤りなので注意してください。
必要な環境は、Python 3.11以上、Git、uv、そして組み合わせるAIコーディングエージェント(Claude Code・GitHub Copilot・Cursorなど)です。uvが未導入の場合は先にuvをインストールします。
永続的にインストールする場合(一度入れればどこでも使える):
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
特定のバージョンを固定したいときは、末尾に @v0.0.x 形式のリリースタグを付けます(タグ名は公式リポジトリのReleasesページで確認できます)。
インストールせず一度だけ試す場合(uvx で一時実行):
uvx --from git+https://github.com/github/spec-kit.git specify init <プロジェクト名>
導入できたら、プロジェクトを初期化します。フラグを省略すると対話形式でエージェントを選べます。明示する場合は --integration フラグを使う形です。
specify init my-project --integration copilot
# 既存プロジェクトの中で初期化する場合
specify init . --integration claude
# 動作確認
specify check
初期化すると、選んだエージェント用のコマンド定義(例:.claude/commands/ や .github/prompts/)と、.specify/ 配下のテンプレート・スクリプト・メモリ(constitution.md など)が生成されます。
つまずきやすい点を2つ補足します。1つ目は、Spec Kitを「npmパッケージ」や「PyPIパッケージ」として探すと混乱することです。PyPIに同名の specify-cli がありますが、これは非公式で、公式に配布されているのは github/spec-kit リポジトリ由来のものだけです。上記のgitベースのコマンドで入れてください。2つ目は、初期化の挙動やフラグ名がバージョンで変わることです。たとえば古い記事にある --ai フラグは新しめのバージョンで --integration に置き換えられています。最新の手順は公式ドキュメントで確認しましょう。
Spec Kitのコマンド一覧:speckit系スラッシュコマンドと実行の順序
初期化後は、AIコーディングエージェントの中でスラッシュコマンドを実行して進めます。以前は specify・plan・tasks・implement という単独名でしたが、現在はspeckit接頭辞の付いた /speckit.* 形式に統一されています。主なコマンドは次のとおりです。
| コマンド | 役割 | 実行タイミング |
|---|---|---|
| /speckit.constitution | プロジェクトの原則・規範を定義 | 最初に一度 |
| /speckit.specify | 仕様(何を・なぜ)を作成 | 仕様フェーズ |
| /speckit.clarify | 曖昧な点を質問で解消 | 計画の前(任意) |
| /speckit.plan | 技術スタックなど計画を作成 | 計画フェーズ |
| /speckit.tasks | 実装タスクへ分解 | タスクフェーズ |
| /speckit.analyze | 仕様・計画・タスクの整合確認 | 実装の前(任意) |
| /speckit.implement | タスクに沿って実装を実行 | 実装フェーズ |
| /speckit.checklist | 要件の品質チェックリスト生成 | 必要に応じて |
なお、Codex CLIのskillsモードでは $speckit-* という記法で呼び出すなど、エージェントによって起動方法が一部異なります(スラッシュコマンドが使えるかどうかはエージェントやCLI/IDEの別によっても変わります)。スラッシュコマンドという操作体系そのものに慣れたい方は、Claude Codeのカスタムコマンドで定型操作を短縮する方法が参考になります。
Spec Kitの使い方:仕様書を起点に実装まで進める基本フローの型
Spec Kitを使った開発は、おおむね次の流れで進みます。各フェーズが「ゲート」になっていて、前の成果物を確認してから次へ進むのが型です。
- 原則を決める(constitution):コーディング規約や設計方針など、プロジェクト共通のルールを最初に定義します。
- 仕様を書く(specify):ユーザーストーリーや受け入れ条件、成功基準を自然言語で記述します。ここでは技術スタックには踏み込まず、「何を・なぜ」に集中します。
- 曖昧さを潰す(clarify):AIが仕様の不明点を質問してくれるので、答えながら精度を上げます。
- 計画を立てる(plan):使用言語・フレームワーク・データ構成などの技術的な「どう作るか」を決めます。
- タスクに分ける(tasks):実装・テスト可能な小さな単位へ分解します。優先度や並列実行の可否も整理されます。
- 整合性を確認する(analyze):仕様・計画・タスクの食い違いをチェックします。
- 実装する(implement):タスクに沿ってAIが実装し、開発者がレビュー・統合します。
仕様書はMarkdownでリポジトリ内に保存され、Gitで変更履歴を管理できます。要件が変わったらまず仕様を直し、再びタスク生成・実装を回す——この反復で、仕様と実装のズレを抑えながら開発を進められます。
チームで運用する場合は、仕様書のレビューをコードレビューと同じ粒度で回すのが定石です。constitution.md に自社のコーディング規約・セキュリティ方針・レビュー基準を落とし込んでおくと、複数人・複数エージェントで並行開発しても出力の方向が揃います。プルリクエストに仕様の差分を含め、「仕様が変わったのにコードだけ直す」逆転を防ぐ運用が実務では効きます。
他の仕様駆動開発ツールとの比較:Kiro・cc-sddとの違いと使い分け
仕様駆動開発ツールはSpec Kit以外にも登場しています。代表例との大まかな違いを整理します(各ツールとも更新が速いため、詳細は公式情報で確認してください)。
| ツール | 提供元 | 形態 | 特徴 |
|---|---|---|---|
| Spec Kit | GitHub | CLI+コマンド | IDE非依存・導入が軽い |
| Kiro | AWS | 専用AI IDE | 2025年11月GA・統合型 |
| cc-sdd | OSSコミュニティ | CLI(複数対応) | 既存コード分析・多言語 |
ざっくり言えば、Spec Kitは「工程の型」をプロジェクトに持ち込みたい・既存環境を替えたくないチームに、Kiroは統合IDE体験と自動化を重視する開発者に、cc-sddは既存資産からの自動立ち上げや多言語運用を求める場合に向きます。Kiroは専用のAgentic IDEとして仕様ワークフローとフック(Hooks)による自動化を内蔵しており、位置づけの詳細は仕様駆動型AI IDE「Kiro」の全体像を解説した記事で確認してください。Spec Kitのテンプレートは英語中心のため、日本語での仕様運用を重視するなら他ツールの多言語対応が選択肢になることもあります。OpenSpecやTesslまで含めた5ツールの横断比較は、仕様駆動開発ツール5種(Spec Kit・Kiro・cc-sdd・OpenSpec・Tessl)の比較に選び方の軸ごとにまとめています。
Spec Kitの導入事例と外部評価:エコシステムの広がりと残る課題
Spec Kitは公開から半年あまりで、仕様駆動開発の事実上の標準ツールのひとつとして広く使われ始めています。新規開発(グリーンフィールド)に限らず、既存システムへ段階的に取り入れるブラウンフィールド用途にも対応しており、チーム開発では仕様レビューを開発プロセスに組み込む運用が報告されています。
エコシステムの広がりも特徴です。たとえばIBMは、ビジネス要件からインフラコードを生成することに特化した iac-spec-kit(Terraform向けで、コマンド体系は /iac.*)を公開しており、Spec Kitの考え方がアプリ開発だけでなくインフラ領域へも応用されています。評価の面では、Martin Fowler氏(ThoughtWorks)のサイトで Kiro・Spec Kit・Tessl の3ツールが「仕様の厳密さ」という観点で比較され、Spec Kitは精緻なワークフローを評価される一方、生成されるMarkdownのレビュー負荷が課題として指摘されています。GitHub公式のOpen Source Friday枠でも取り上げられるなど、認知度は高い状態です。導入を検討する際は、この「レビュー負荷」という指摘を自分のチームの人数・レビュー体制に当てはめて読むのが実務的です。仕様書を読める人がチームに1人しかいない体制では、SDDの利点よりレビューの詰まりが先に表面化します。
Spec Kitの料金とコスト感:無料で始める構成と従量課金の注意点
Spec Kit自体はMITライセンスのオープンソースで、ツールの利用料はかかりません。ただしSpec Kitは単独では動かず、AIコーディングエージェントと組み合わせて使うため、実際のコストはエージェント側の利用料に依存します。GitHub Copilotの無料プランと組み合わせれば、まず無料で仕様駆動開発を試せます。
主要なAIエージェントと組み合わせた場合のコスト感の目安は次のとおりです。
| 組み合わせ | 月額の目安 | 備考 |
|---|---|---|
| GitHub Copilot Free | $0 | 月間の無料枠内で試せる |
| GitHub Copilot Pro | $10/月 | 個人開発の実用ライン |
| Copilot Business | $19/人/月 | 組織管理・チーム導入の標準 |
| Claude Code | 各プランに準ずる | 大規模リポジトリに強み |
※2026年6月時点の目安です。GitHub CopilotはAI Credits(トークン量)ベースの従量課金へ移行しており、エージェント側の実費は利用量で変動します。かつて無料枠の定番だったGemini CLIは個人向け提供が終了したため、無料で試すならCopilot Freeが現実的な入り口です。最新の料金は各公式ページで確認してください。
コスト面の注意点として、SDDは仕様・計画・タスクを各ターンで読み込むため、行き当たりばったりのプロンプトに比べてトークン消費がやや増える(おおむね2〜4割増という指摘もあります)傾向があります。一方で、手戻りや無駄な作り直しが減る効果が見込めるため、トータルでは効率が上がるケースが多いとされています。
導入時の注意点と向き不向き:採用してよい場面と見送るべき場面
便利な一方で、押さえておきたい前提があります。まず、最初の仕様入力は人間が考える必要があります。「シンプルなアプリ」といった曖昧な指示だけでは精度が出ないため、ある程度の要件整理は事前に行いましょう。テンプレートも比較的重厚なので、必要に応じてカスタマイズすると運用が楽になります。そして、AIが生成した仕様やコードは必ず人間がレビューすることが前提です。Spec Kitはあくまで進め方を支える土台であり、品質の最終担保は開発者の確認にあります。
そのうえで、判断を言い切ります。採用してよいのは、機能単位の開発をチームで進める場面です。具体的には、(1)新機能の追加や新規サービスの立ち上げで要件を文章化できる人がいる、(2)複数人(または複数エージェント)で並行開発するため意図の共有が必要、(3)既にAIコーディングエージェントを日常的に使っている——この3条件のうち2つ以上に当てはまるなら、導入する価値があります。逆に、数行のバグ修正・設定変更・使い捨てのプロトタイプにはSpec Kitを使わないでください。仕様→計画→タスクの往復がそのまま無駄になり、トークン消費だけが増えます。小さな修正は普通にエージェントへ直接指示するほうが速く、SDDは「仕様を書くコストを回収できる規模」でだけ効きます。仕様を書ける人がチームにいない体制も見送り対象です。その場合はツール導入より先に、要件を文章化する訓練や体制づくりが必要になります。
「開発プロセスに生成AIを組み込みたいが、SDDの型づくりや社内への展開まで手が回らない」という企業も多いはずです。株式会社一創では、生成AI導入支援サービスとして、AIコーディングを含む生成AIの業務組み込みを要件整理から運用定着まで支援しています。自社だけで進めるか、外部の知見を借りて立ち上げを速めるか——検討の選択肢に加えてみてください。
よくある質問
Spec Kitについて検索されることの多い質問と回答をまとめます。
Spec Kitとは何ですか?
GitHubが2025年9月に公開した、仕様駆動開発(SDD)を実践するためのオープンソース・ツールキットです。Specify CLIとテンプレート、AIエージェント用のスラッシュコマンドで構成され、仕様を起点にAIへ実装を指示できます。
Spec Kitの値段はいくらですか?
Spec Kit自体は無料(MITライセンス)です。ただし組み合わせるAIエージェントに利用料がかかる場合があります。GitHub Copilotの無料プランと組み合わせれば、費用をかけずに試せます。
Spec Codingとは何ですか?
明確な仕様(spec)を先に定義し、それに基づいてAIにコードを書かせる進め方を指す言い方です。意味としては仕様駆動開発(SDD)とほぼ同じで、Spec KitはこのSpec Coding/SDDを実践するためのツールです。
仕様駆動開発は英語で何といいますか?
Spec-Driven Development(略称SDD)です。Spec Kitの公式ドキュメントやコマンド名でもこの表記が使われています。
Spec KitはnpmやPyPIからインストールできますか?
公式の入手元は github/spec-kit リポジトリのみです。Python製のため uv tool install にgitのURLを指定する形で入れます。PyPIにある同名パッケージは非公式なので使わないでください。
関連記事
- Claude Code Web版とは?ブラウザでできること・使い方・料金とCLI版の違い:Spec Kitと組み合わせられる代表的エージェントのWeb版解説です。
- Cursor 2.4とは?AI搭載コードエディタ最新バージョンの概要と特徴:対応エージェントのうちAIエディタ型の代表例を扱っています。
- Gemini CLIとは?個人向け終了とAntigravity CLI移行・使い方を解説:本文で触れた提供終了・移行の詳細をまとめた記事です。
- Codex CLIとは|始め方・料金・コードを学習させない設定まで解説:skillsモードの記法差に触れたCodex CLIの導入解説です。
- Claude Codeのカスタムコマンドとは?便利なショートカット機能を解説:スラッシュコマンド操作の基礎を押さえられる記事です。