Spec Kit アップグレード方法｜CLIとテンプレートの更新手順

GitHub Spec Kit のアップグレード方法を解説します。CLI の更新からプロジェクトのテンプレート更新まで、3ステップで完了します。

前提

specify version

今回確認したいのはCLIとTempleteのVersionです。

     CLI Version    0.0.22
Template Version    0.0.90
        Released    2025-12-04

それぞれ確認して、アップデートしていきます。

uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git

specify init --here --force --ai copilot

複数エージェントを使っている場合は、それぞれ実行します。

specify init --here --force --ai copilot
specify init --here --force --ai claude

constitution.md などカスタマイズしていたファイルは上書きされます。Git で復元してください。

git restore .specify/memory/constitution.md

以上で完了です。

ここからは実運用で得た知見を紹介します。

Spec Kit には2つのバージョンがあります。

種類	説明	更新頻度
CLI Version	`specify` コマンド本体	低（0.0.22 で安定）
Template Version	スラッシュコマンドやスクリプト	高（頻繁に更新）

CLI Version が 0.0.22 のままでも問題ありません。Template Version が更新されていれば新機能が使えます。

ファイル	アップグレード時の挙動
`.specify/memory/constitution.md`	上書きされる（要復元）
`.specify/scripts/`	上書きされる
`.github/`, `.claude/`	上書きされる
`specs/`	上書きされない（安全）

仕様ファイル（specs/）は保護されているので、安心してアップグレードできます。

コマンドで git restore しなくても、VSCode のソース管理パネルから「変更を破棄」で簡単に復元できます。アップグレード後に差分を確認しながら、必要なファイルだけ戻せるので便利です。git restoreとかあまり使わないので、VSCodeで変更を破棄するのがおすすめです。

Copilot と Claude Code では、生成されるディレクトリ構造が異なります。

Copilot（2層構造）

.github/
├── prompts/    # エントリーポイント（軽量）
└── agents/     # 実際のロジック

Claude Code（1層構造）

.claude/
└── commands/   # ロジックが直接入っている

構造は違いますが、使えるスラッシュコマンドは同じです。チーム内で異なるエージェントを使っていても、同じ specs/ ディレクトリの仕様ファイルを共有できます。

/speckit.taskstoissues コマンドが追加されました。タスクを GitHub Issues に自動変換する機能です。GitHub MCP サーバーとの連携が必要です。