github/spec-kit View GitHub Homepage for Latest Official Releases

GitHubでオープンソースとして公開されている仕様駆動開発ツールキット。構造化された仕様と計画を通じて、AIコーディングアシスタントが高品質なコードを生成するのを支援します。

MITShellspec-kitgithub 42.4k Last Updated: October 23, 2025

GitHub Spec Kit プロジェクト詳細紹介

プロジェクト概要

GitHub Spec Kit は、GitHub がオープンソースとして公開している仕様駆動開発 (Spec-Driven Development, SDD) ツールキットです。AI コーディングアシスタント向けに構造化されたワークフローを提供し、詳細な仕様を先に記述してからコードを生成するという方法で、従来の「コードを先に書き、後からドキュメントを作成する」開発モデルを変革します。

プロジェクトアドレス: https://github.com/github/spec-kit

コアコンセプト

仕様駆動開発とは？

仕様駆動開発は、仕様 (Specification) を核とするソフトウェア開発手法であり、その中心となる考え方は以下の通りです。

  • 仕様優先: コーディングの前に、詳細な製品要求仕様書 (PRD) と技術実装計画を作成する
  • 仕様が唯一の真実: 仕様がプロジェクトの唯一の真実源 (Single Source of Truth) となる
  • 動的な進化: 仕様は静的なドキュメントではなく、プロジェクトの進化とともに変化する「生きたドキュメント」である

なぜ Spec Kit が必要なのか？

AI コーディングアシスタント (Claude Code, GitHub Copilot, Gemini CLI など) を使用する際、以下のような一般的な問題が発生します。

  1. 曖昧な入力による誤った出力: AI アシスタントはプロンプトに基づいてコードを生成するだけで、プロジェクト全体の理解が不足している
  2. 仮定に基づくコーディング: AI が実際の要件に合わない仮定をする可能性がある
  3. アーキテクチャ制約の欠如: 生成されたコードが既存のシステムアーキテクチャと一致しない可能性がある
  4. 品質のばらつき: 統一された基準がなく、コード品質にばらつきが生じる

Spec Kit は、構造化されたフレームワークを提供することでこれらの問題を解決し、AI アシスタントがプロジェクトの意図を正確に理解し、高品質なコードを生成できるようにします。

コアコンポーネント

1. Specify CLI

Specify CLI は、プロジェクトの SDD スキャフォールドを迅速に初期化するための Python ベースのコマンドラインツールです。

インストール方法:

# uvx を使用してインストール (推奨)
uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>

# または永続的にインストール
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

主な機能:

  • インストールされているツール (git, claude, gemini, code, cursor-agent など) の確認
  • 適合するテンプレートファイルの自動ダウンロード
  • プロジェクトの SDD 構造の初期化
  • 複数の AI コーディングアシスタントのサポート

使用例:

# 新しいプロジェクトを初期化し、AI アシスタントを指定
specify init my-project --ai claude
specify init my-project --ai copilot
specify init my-project --ai gemini

# 現在のディレクトリで初期化
specify init . --ai claude
specify init --here --ai copilot

# 空でないディレクトリへの強制マージ
specify init . --force --ai claude

# git 初期化をスキップ
specify init my-project --ai gemini --no-git

2. テンプレートと補助スクリプト

Spec Kit は、以下を含む完全なテンプレートシステムを提供します。

Constitution.md (プロジェクト憲章)

プロジェクトの基本原則と交渉不可能なガイドライン。例:

  • テスト方法の要件
  • アーキテクチャの慣例
  • コードスタイルの規範
  • 技術スタックの選択

これは、組織が「意見のある技術スタック」を確立するのに役立つ強力なツールです。

仕様テンプレート

仕様ドキュメントに含めるべき内容構造を定義します。

技術計画テンプレート

技術実装計画の形式と必須要素を規定します。

タスク分解テンプレート

大規模な機能を実行可能な小さなタスクに分解します。

補助スクリプト

powershell または bash フォルダに配置され、SDD スキャフォールドの一貫した適用を保証するために使用されます。

ワークフロー

Spec Kit は、以下の4段階の開発プロセスに従います。

ステップ 1: 仕様の定義 (/specify)

/specify コマンドを使用して、高レベルのプロジェクト記述を提供します。技術的な詳細ではなく、「何を」「なぜ」行うかに焦点を当てます。

例:

/specify
タスク管理アプリケーション Taskify を構築する。以下をサポートする:
- ユーザー認証
- リアルタイムコラボレーション
- モバイル対応
- プロジェクト作成とタスク割り当て
- Kanban ボードによる進捗追跡

AI コーディングアシスタントは、以下の内容を含む完全な製品仕様書 (PRD) を生成します。

  • プロジェクトの動機と目標
  • コア機能の説明
  • ユーザーストーリー
  • 非機能要件
  • 受け入れ基準

ステップ 2: 技術計画の策定 (/plan)

/plan コマンドを使用して、高レベルの技術的方向性を提供すると、AI が詳細な技術実装計画を生成します。

例:

/plan
フロントエンドに React + TypeScript を使用
バックエンドに Node.js を使用
データベースに PostgreSQL を使用

生成される技術計画には、以下の内容が含まれます。

  • システムアーキテクチャ設計
  • 技術スタック選択の理由
  • データモデル設計
  • API 設計
  • セキュリティに関する考慮事項
  • パフォーマンス最適化戦略

ステップ 3: タスク分解 (/tasks)

/tasks

技術計画を実行可能な小さなタスクに分解します。各タスクには以下が含まれます。

  • タスク記述
  • 依存関係
  • 期待される成果物
  • 受け入れ条件

ステップ 4: 実装 (/implement)

/implement

AI コーディングアシスタントは、仕様、計画、タスクリストに基づいてコードを生成し、テスト駆動開発 (TDD) の原則に従います。

コア機能

1. クロス AI アシスタント互換性

Spec Kit は、複数の主要な AI コーディングアシスタントをサポートしています。

  • Claude Code (Anthropic)
  • GitHub Copilot
  • Cursor
  • Gemini CLI (Google)
  • Windsurf
  • Qwen Code
  • OpenCode
  • Codex
  • その他多数...

2. テスト駆動開発統合

TDD サポートが組み込まれており、以下を保証します。

  • 各機能に対応するテストがある
  • モックではなく、実際の環境テストを優先する
  • 契約テスト (Contract Tests) は実装前に完了する必要がある

3. レビューと受け入れチェックリスト

各段階で明確な受け入れ基準が設けられています。

  • 仕様は完全か？
  • 技術計画は実現可能か？
  • タスクは独立して実行可能か？
  • コードはすべてのテストに合格したか？

4. 繰り返し最適化メカニズム

どの段階でも変更に戻ることをサポートします。

  • 仕様が不明確な場合？仕様を更新
  • アーキテクチャの調整が必要な場合？技術計画を修正
  • タスクが大きすぎる場合？再分解

適用シナリオ

1. グリーンフィールドプロジェクト (Zero-to-One)

ゼロから始める新しいプロジェクトで、AI が汎用的なソリューションを生成するのを避けるために、事前の計画を通じて対応します。

2. 機能拡張 (N-to-N+1)

既存の複雑なシステムに新機能を追加する場合、これは Spec Kit の最も強力な応用シナリオです。

  • 新機能と既存システムの相互作用方法を明確にする
  • コーディングアーキテクチャの制約により、コードスタイルの一貫性を確保する
  • 新しいコードが「パッチ」ではなく、ネイティブ機能のように感じられるようにする

3. レガシーシステムのモダナイゼーション

レガシーシステムをリファクタリングする際:

  • 現代の仕様でコアビジネスロジックを捕捉する
  • 全く新しいアーキテクチャを設計する
  • AI に技術的負債なしでシステムをゼロから再構築させる

プロジェクト構造例

Specify CLI で初期化された後のプロジェクト構造:

my-project/
├── .specify/              # Spec Kit の設定とテンプレート
│   ├── templates/         # 仕様、計画、タスクのテンプレート
│   ├── scripts/           # 補助スクリプト
│   └── config.json        # 設定ファイル
├── constitution.md        # プロジェクト憲章
├── spec.md                # 製品仕様書
├── plan.md                # 技術実装計画
├── tasks/                 # タスクリスト
│   ├── task-001.md
│   ├── task-002.md
│   └── ...
└── src/                   # ソースコードディレクトリ

実際のケース: Taskify プロジェクト

Spec Kit 公式は、Kanban スタイルのプロジェクト管理ツールを仕様駆動開発で構築する方法を示す完全なサンプルプロジェクト Taskify を提供しています。

機能特性:

  • 5つのプリセットユーザー、パスワードなしでログイン可能
  • 複数プロジェクト管理
  • Kanban ボードビュー
  • ドラッグ＆ドロップによるタスク管理
  • タスク割り当てとステータス追跡
  • コメント機能 (自分のコメントのみ編集/削除可能)
  • 現在のユーザーのタスクをハイライト表示

開発フロー:

  1. /specify コマンドを使用して Taskify の要件を記述
  2. AI が詳細な製品仕様を生成
  3. /speckit.clarify を使用して詳細を明確化
  4. /plan を使用して技術実装計画を生成
  5. 検証レビューと受け入れチェックリスト
  6. タスクを生成し、実行

利点と価値

開発者にとっての価値

  1. 推測の減少: 明確な仕様が曖昧さを排除
  2. 品質の向上: 構造化されたプロセスがコード品質を保証
  3. コラボレーションの容易さ: 仕様がチームコミュニケーションの共通言語となる
  4. メンテナンスの容易さ: ドキュメントとコードが同期して進化

チームにとっての価値

  1. 標準の統一: Constitution を通じてチームの規範を確立
  2. 知識の蓄積: 仕様と計画が再利用可能な資産となる
  3. 手戻りの減少: 事前計画により実装段階の問題を削減
  4. トレーサビリティ: 明確な意思決定記録

AI アシスタントにとっての価値

  1. コンテキスト理解: 完全な仕様が十分なコンテキストを提供
  2. 制約による誘導: 技術計画がアーキテクチャ制約を提供
  3. タスクへの集中: 小粒度のタスクが AI をより集中させる
  4. 品質保証: 組み込みの受け入れ基準がコード生成をガイド

限界と注意事項

1. 学習曲線

小規模でシンプルなプロジェクトには過度に煩雑に感じられる可能性があり、投入対効果を考慮する必要があります。

2. 実験的性質

Spec Kit はまだ実験段階であり、GitHub チームはまだ多くの問題に答える必要があると明言しています。

3. テンプレートの柔軟性

組み込みテンプレートは GitHub チームのベストプラクティスに基づいていますが、組織の要件に合わせて調整が必要な場合があります。

4. 既存プロジェクトとの統合

現在は主に新規プロジェクト向けであり、既存プロジェクトのサポートはまだ模索中です。

コミュニティとエコシステム

関連プロジェクト

  • SpecLang: GitHub の2023年の研究プロジェクトで、自然言語仕様をコード生成の主要なソースとして探求
  • AWS Kiro: AWS の「エージェント型」IDE で、AI が仕様から直接ソフトウェアを構築
  • Codeplain: 専用の仕様言語 Plain を使用するスタートアッププロジェクト
  • Tessl: 仕様駆動フレームワークとレジストリを提供するプラットフォーム

コミュニティからのフィードバック

Spec Kit に関するコミュニティの主な議論点:

  1. 標準化の必要性: ユーザーは、AI 支援開発の断片化を避けるための共有フレームワークの確立を望んでいる
  2. クロスチームコラボレーション: リポジトリをまたいだ仕様と成果物の共有をサポートする提案
  3. 自動生成: 既存のコードベースから Constitution を自動生成できることを希望
  4. 既存プロジェクトのサポート: 開発済みのプロジェクトとの統合をより良くサポートするよう求める声

サポートの入手

まとめ

GitHub Spec Kit は、AI 支援ソフトウェア開発の重要な方向性、すなわち「その場のノリでコーディング (Vibe Coding)」から「計画的な構築」への転換を示しています。構造化された仕様駆動開発フレームワークを提供することで、開発者と AI アシスタントがより効果的なコラボレーションモデルを確立するのを支援します。

まだ実験段階ではありますが、Spec Kit は複雑なプロジェクト開発におけるその価値をすでに示しています。ツールの継続的な改善とコミュニティの貢献により、仕様駆動開発は AI 時代のソフトウェアエンジニアリングにおける重要な実践方法となることが期待されます。

ライセンス: MIT License

最新バージョン: 最新のリリースバージョンについては、https://github.com/github/spec-kit/releases をご覧ください。

Star History Chart