Spec Kitの実像: 仕様からAI開発を組み立てるCLI

コードより先に仕様を置くSpec-Driven Development

Spec Kitは、AIコーディングエージェントを使った開発で、何を作るかを先に定義するためのオープンソースツールキットです。READMEが掲げる考え方は、仕様を一時的なメモではなく、実装を生む実行可能な成果物として扱うことです。コードを先に書いて後から説明を合わせる流れを改め、要求、判断、実装のつながりを残します。

ここでの価値は、特定のAIモデルやIDEを売りにすることではありません。既成の仕様駆動プロセスを使うことも、自分たちのプロセスを持ち込むこともできます。READMEにはベンチマークや本番成果の測定値はありません。開発速度や品質が上がるという評価は、このリポジトリの説明から直接証明できる事実ではなく、導入後に自分で確かめる領域です。

Specify CLIでプロジェクトの入口を作る

導入にはPython 3.11以上、Git、uvまたはpipxが必要です。READMEはuvを使い、Gitリポジトリのリリースタグを指定してspecify-cliを導入する方法を示します。タグの先頭にvを残す点も明記されています。初期化はspecify init my-project --integration copilotの形で行い、生成したディレクトリでAIエージェントを起動します。

CLIには自己更新の確認、ドライラン、アップグレード、特定タグへの固定に関するコマンドがあります。uvxで一時実行する場合や、ソースチェックアウトから使う場合は、状況に応じた案内を生成するとREADMEは説明します。配布経路を一つに固定せず、プロジェクトの再現性を確保しやすい設計ですが、社内利用では使用タグと初期化オプションを記録することが欠かせません。

constitutionからimplementまでの段階設計

初期化後の中心的な流れは、原則を作るconstitution、構築内容を記述するspecify、技術選択を行うplan、計画を細かな作業へ分けるtasks、実行するimplementです。多くのエージェントではこれらが/speckit.*のスラッシュコマンドとして現れます。Codex CLIのスキルモード、GitHub Copilot CLIのagentsなど、統合ごとに入口の表記は異なります。

clarifyは曖昧な点を詰め、analyzeは成果物同士の一貫性を調べ、checklistは品質確認項目を作ります。つまり、単一の生成プロンプトではなく、判断を分割して確認できる工程です。エージェントが複数ある場合は、同じ入力から何が変わるかを比較し、生成された仕様とタスクを人間が承認する運用を決めておく必要があります。

拡張、プリセット、ローカル上書きの優先順位

Spec Kitのテンプレートは、プロジェクト側のoverrides、プロジェクトに導入したpresets、extensions、コアテンプレートの順で解決され、上位で最初に一致したものが使われます。拡張はコマンドやテンプレートを足す仕組み、プリセットはコアや拡張の内容を組織向けに上書きする仕組みです。実行時解決のため、同じ名前のテンプレートがどこから選ばれたかを追えるようにしておくことが重要です。

READMEはJira連携や規制トレーサビリティを例として挙げますが、利用できる拡張の完全なカタログは示していません。便利そうな名称だけで対応済みと判断せず、対象拡張のマニフェスト、生成物、更新方法を確認してください。ローカル上書きが増えるほど、標準プロセスとの差分管理が導入後の課題になります。

ロール別バンドルで組織の手順を配る

バンドルは、拡張、プリセット、手順、ワークフローを、ロールを意識した一つのバージョン管理構成にまとめます。bundle.ymlで記述し、プロジェクト、ユーザー、組み込みのカタログスタックから解決します。プロダクトマネージャー、ビジネスアナリスト、セキュリティ研究者、開発者向けのサンプルがexamples/bundlesにあります。

READMEが示す設計上の要点は、infoがinstallの結果と一致すること、installが冪等でプロジェクトルートに限定されること、removeが他のバンドルの依存を壊さないことです。ローカルまたは固定ソースでオフライン動作するコマンドも想定されています。社内標準として使うなら、承認者、更新担当、削除時の影響範囲をマニフェストと一緒に管理すると判断しやすくなります。

開発フェーズ、前提条件、MITライセンス

READMEは、ゼロから本番対応アプリケーションを作る0から1の開発、複数の技術やUXを試すクリエイティブ探索、既存システムを段階的に変える反復的強化の三つのフェーズを説明します。技術に依存しないこと、企業制約を扱うこと、利用者を中心に置くことなどは実験的な目標として記載されていますが、達成時期やロードマップは示されていません。John Lamの研究を大きな影響源として挙げている点もREADMEで確認できます。

対応OSはLinux、macOS、Windowsで、30以上のAIコーディングエージェントに対応するとREADMEは述べます。ただし完全な統合リストは別ガイドへの参照です。ライセンスはMITで、利用、改変、再配布の広い権利を認めますが、ソフトウェアは現状のまま提供され、セキュリティや保守の保証はありません。

編集部の結論

Spec Kitは、AIエージェントに実装を急がせる前に、仕様、原則、計画、タスクを段階化したいチーム向けです。拡張やバンドルで組織の手順を寄せられますが、READMEだけでは本番性能や全エージェントの互換性を確認できません。採用前に対象エージェント、生成物のレビュー責任、MITライセンスの条件を実環境で確かめてください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes