spec-kit

spec-kit — specify を使った仕様駆動開発

GitHub の spec-kit は、従来の流れを逆転させます。 仕様が実行可能になり、実装を直接推進します。このスキルは、上流の specify CLI を中心としたルーティング優先のラッパーです。ツールをインストールし、選択した AI エージェント用にプロジェクトを初期化して、SDD の 5 段階コマンドパイプラインを案内します。

このスキルを使う場面

• ユーザーが spec-kit、specify-cli、または「GitHub spec kit」のインストールを依頼した場合
• ユーザーが Spec-Driven Development ワークフローでプロジェクトを開始したい場合
• ユーザーが /speckit.constitution、/speckit.specify、 /speckit.plan、/speckit.tasks、/speckit.implement、/speckit.clarify、 /speckit.analyze、または /speckit.checklist を入力したり、質問したりした場合
• ユーザーが Claude Code、Copilot、Gemini、Cursor、Codex、opencode、Qwen、Kiro、またはその他のサポート対象エージェント間で実行可能な仕様を共有したい場合
• ユーザーがコミュニティの spec-kit 拡張機能やプリセットを探したい場合 （specify extension search、specify preset search）

このスキルを使わない場面

• ユーザーがベンダーに依存しない、パケット優先の計画ルーターを必要とし、次の BMAD 成果物を分類したい場合 → bmad を使います
• ユーザーが GitHub spec-kit に依存しない、不変のシードとドリフトを考慮した実行を備えた、仕様優先の制御ループを必要とする場合 → ooo を使います
• ユーザーが既存の計画や差分の視覚的なレビュー／承認を希望する場合 → plannotator を使います
• ユーザーが仕様を作成する前に、計画前のコンセプト整理（課題、対象者、ポジショニング）を希望する場合 → bmad-idea を使います

前提条件

要件	備考
Linux / macOS / Windows	Windows ではネイティブ環境または WSL
Python 3.11+	specify-cli に必要
uv（推奨）または pipx	ツールのインストールマネージャー
git	リポジトリおよびプラグインマーケットプレイスの操作
サポート対象の AI エージェント 1 つ	Claude Code、Copilot、Gemini、Codex など

手順

ステップ 1 — specify-cli をインストールする

# Recommended: uv tool install (pins via Git ref)
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# Pinned to a tag (reproducibility):
uv tool install specify-cli --from git+https://github.com/github/[email protected]

# Alternative: pipx
pipx install git+https://github.com/github/spec-kit.git

# Verify
specify --version
specify integration list

ステップ 2 — 対象の AI エージェントを選ぶ

specify integration list を実行すると、サポート対象のエージェントがすべて表示されます。一般的な選択肢は次のとおりです。

エージェント	--integration の値
Claude Code	claude
GitHub Copilot	copilot
Google Gemini CLI	gemini
OpenAI Codex CLI	codex
Cursor CLI	cursor
opencode	opencode
Qwen CLI	qwen
Kiro CLI	kiro

ステップ 3 — プロジェクトを初期化する

# Create a new project directory and bootstrap it
specify init my-project --integration claude

# Bootstrap in the current directory
specify init . --integration copilot

# Force-overwrite into the current directory
specify init --here --force --integration gemini

.specify/、エージェント固有のコマンドファイル、憲章テンプレートが書き込まれます。

ステップ 4 — SDD コマンドパイプラインを進める

選択したエージェント（Claude Code、Copilot、Gemini など）の中で、次のスラッシュコマンドを実行します。エージェントは specify init が書き込んだファイルを読み込みます。

コマンド	目的
/speckit.constitution	プロジェクトの原則と譲れない条件を定めます
/speckit.specify	要件とユーザーストーリーを記録します
/speckit.plan	技術的な実装方針を作成します
/speckit.tasks	計画を実行可能なタスクに分割します
/speckit.implement	計画をタスクごとに実行します

任意の詳細化：

• /speckit.clarify — 仕様の曖昧さを解消するための聞き取りを行います
• /speckit.analyze — 憲章、仕様、計画の整合性をレビューします
• /speckit.checklist — レビューチェックポイント用の品質チェックリストを生成します

ステップ 5 — 拡張機能とプリセット（コミュニティ）

specify extension search
specify extension add <extension-name>

specify preset search
specify preset add <preset-name>

コミュニティのリソースは https://github.github.io/spec-kit/community/ でご覧ください。

ステップ 6 — jeo-skills と併用するプラグイン形式のインストール

このスキルフォルダーは、標準の jeo-skills の手順でプラグインとしてインストールできます。これにより、ラッパー、リファレンス、インストーラースクリプトがディスク上に配置され、サポート対象のエージェント実行環境で利用できるようになります。

# Project install (writes into .agents/skills/spec-kit/)
npx skills add https://github.com/akillness/jeo-skills --skill spec-kit

# Global install for every detected agent
npx skills add -g https://github.com/akillness/jeo-skills --skill spec-kit

# Target specific agents
npx skills add -g https://github.com/akillness/jeo-skills --skill spec-kit -a claude-code -a codex -y

このスキルには、uv / pipx を検出してステップ 1 を実行する、1 回限りのインストーラーとして scripts/install.sh も含まれています。

出力形式

ユーザーが spec-kit にサポートを求めた場合は、簡潔な概要を返します。

# spec-kit Routing Brief

## Scope
- Target agent: claude | copilot | gemini | codex | cursor | opencode | ...
- Project state: new | existing-init | mid-pipeline | extension-only
- Pipeline stage: constitution | specify | plan | tasks | implement | clarify | analyze | checklist

## Recommended next move
- install-specify | specify-init | run-/speckit.<command> | add-extension

## Why
- 2-3 bullets grounded in the user's packet

## Route-outs
- `ooo` for vendor-neutral spec-first loops
- `bmad` for packet-first BMAD/BMM artifact selection
- `plannotator` for approval/review of an existing plan

ベストプラクティス

1. 再現性が重要な場合は、Git の参照（@v0.0.10 またはコミット SHA）を固定してください。main は更新されます。
2. ユーザーが明示的に複数エージェント間の同等性を求めない限り、リポジトリごとに統合は 1 つにしてください。--integration を切り替えると、コマンドファイルが書き換えられます。
3. /speckit.constitution を重要な基盤として扱ってください。 後続の /speckit.plan と /speckit.tasks はこれを順守するため、原則が変わった場合は、まずこれを更新してください。
4. 仕様が曖昧な場合は、計画で未解決の疑問を覆い隠すのではなく、/speckit.plan の前に /speckit.clarify を使用してください。
5. レベル 2 以上の作業で /speckit.implement を実行する前に、明示的なレビューを行うため、成果物を plannotator に引き渡してください。
6. ユーザーが GitHub のパイプラインではなく、ドリフト追跡を備えたベンダー中立の仕様優先ワークフローを実際に求めている場合は、ooo に振り分けてください。

参考資料

• 上流リポジトリ：https://github.com/github/spec-kit
• ドキュメントサイト：https://github.github.io/spec-kit/
• コミュニティのプリセットと拡張機能：https://github.github.io/spec-kit/community/
• インストーラースクリプト：scripts/install.sh
• コマンドリファレンス：references/commands.md
• 関連スキル：../ooo/SKILL.md、../bmad/SKILL.md、 ../plannotator/SKILL.md、../bmad-idea/SKILL.md
• ライセンス：MIT（上流の LICENSE を参照）