Spec Kitとは？

最近、SDDなるものに触れる機会がありました。
それが、Spec Kitでした。AIが実装に迷わないように計画を立ててコーディングをするツールですね。
あまり日本では聞きなれないので資料にしてみました。

Transcript

1. Spec Kit 仕様を起点に、AIとソフトウェアを つくる SDDの考え方と既存プロジェクトへの導入 Claude Code / Codex 対応 GitHub Spec Kit v1.0.5 | 2026-09-09
2. SDDとは 02 仕様を成果物の中心に置く開発プロセス WHAT spec.md 従来はコードが主役で、仕様書は実装後に古くなりがちでした 。SDDでは、仕様をAIエージェントが解釈できる形に整え、計画 ・タスク・実装を一貫して導きます。 HOW plan.md DO tasks.md + code Spec KitはSDDを実行するためのCLI、テンプレート、エージェント連携を提供
3. 基本ワークフロー 0 Constitution 品質・テスト・UXなど、 プロジェクト原則を一度 定義 1 03 Specify 何を、なぜ作るか。技 術選定はまだ書かない 2 Plan 技術スタック、構成 、制約を決める 3 Tasks 実装可能な単位へ分 解し、順序を決める 品質ゲート Clarify で曖昧さを解消し、Analyze で成果物間の整合性を確認。Converge で 仕様・計画・タスクとの差分を洗い出し、必要なら実装へ戻る。 短いプロンプト一発ではなく、段階的に判断を固定する 4 Implement タスクに沿って実装 し、テストする
4. uvは必要か 04 標準手順では必要。実行時の依存ではなく、Specify CLIの導入・管理に使う 推奨 # uv の導入（macOS / Linux） curl -LsSf https://astral.sh/uv/install.sh | sh # Spec Kit v1.0.5 を固定して導入 uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@v1.0.5 # 確認 specify version uv tool install 代替 PyPI版も公開 uv tool install specify-cli 補足: uvx は一時実行。PATH上の永続的な specify を更新しない
5. 既存プロジェクト リポジトリ直下で初期化する 05 事前確認 1 Gitの作業状態を確認 cd /path/to/existing-project # Claude Code specify init --here --force --non-interactive \ --integration claude --script py # または Codex specify init --here --force --non-interactive \ --integration codex --script py --here は現在のディレクトリを対象にし、--force は非空ディレクトリへの初期化に必要 2 生成・更新される .specify とエー ジェント用ディレクトリをレビュー 3 既存ファイルへのマージを許可す るため --force を明示 4 初回はブランチで試す
6. sh と Python の選び方 06 新規導入は py を推奨。OS標準に合わせるなら macOS / Linux は sh --script py --script sh Specify CLI自体がPython製のため追加ランタイムが増えな い macOS / Linuxの非対話モード既定値 JSON処理で jq に依存しない 既存チームがShell運用なら馴染みやすい コアスクリプトはパリティテスト済み JSON処理で jq が必要になる場合がある 一部拡張はまだpyへ完全対応していない Windowsでは ps が既定 判断基準: コア中心・クロスプラットフォームなら py。拡張の互換性や既存運用を優先するなら sh / ps
7. Claude Code 07 生成先 # 既存プロジェクトで初期化 specify init --here --force --integration claude --script py # Claude Codeを起動 claude Claude Codeの現行連携はskills方式。古い記事にある /speckit.* で はなく $speckit-* を使う Claude CLIが無い環境でテンプレートだけ導入する場合は --ignore-agent-tools を追 加 .claude/skills/ 呼び出し例 $speckit-constitution $speckit-specify $speckit-plan $speckit-tasks $speckit-implement
8. Codexで使う 08 生成先 # 既存プロジェクトで初期化 specify init --here --force --integration codex --script py # Codex CLIを起動 codex Codexもskills方式。プロジェクト内のSKILL.mdを読み、 $speckit-* で実行する 確認: specify integration list / specify integration status .agents/skills/ 呼び出し例 $speckit-constitution $speckit-specify $speckit-plan $speckit-tasks $speckit-implement
9. Claude Code / Codex 併用 09 1つの初期化で指定できるintegrationは1つ。追加は integration install を使う 配置 # Claudeを主設定として初期化 specify init --here --force --integration claude --script py Claude .claude/skills/ # Codexを追加 specify integration install codex --script py # 状態確認 specify integration status 追加しても既定integrationは変わらない。変更する場合は specify integration use <key> Codex .agents/skills/
10. 導入時の推奨設定 01 CLIはリリースタグ固定 再現性を優先し、v1.0.5のようにタグを付ける 02 既存プロジェクトはブランチで試す --here --force が触る管理ファイルをレビューする 03 標準は --script py 拡張の対応状況やチーム標準に応じて sh / ps を選ぶ 04 仕様から始め、実装前に確認する Constitution、Specify、Plan、Tasksの順で合意を積み上げる github.com/github/spec-kit 10