トップ > Spec Kit > GitHub Spec Kitのアップデート方法と注意点

GitHub Spec Kitのアップデート方法と注意点

Spec Kit
記事タイトルとURLをコピーする

こんにちは、サーバーワークスで生成AIの活用推進を担当している針生です。

前回の記事では、Kiro CLIでGitHub Spec Kitの仕様駆動開発を実践する方法についてご紹介しました。

blog.serverworks.co.jp

Spec Kitは非常に活発に開発が進んでおり、頻繁に改善が行われています。

最新の機能を最大限に活用するためには、Spec Kit自体を適切にアップデートする必要があります。

本ブログでは、アップデート方法と注意点を公式のアップグレードガイドから抜粋して簡潔にお伝えしたいと思います。

Spec Kitのアップデートには2つのステップがある

Spec Kitのアップデートは、大きく分けて「CLI ツール本体」と「プロジェクト内のテンプレートファイル」の2段階で行います。

ステップ 1：CLI ツール（specify）の更新

まずは、手元の環境にある CLIツールを最新にします。uv をお使いの場合は、以下のコマンドで強制的に再インストールを行うのが確実です。

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

正しく更新されたかは、specify check コマンドで確認できます。

ステップ 2：プロジェクトファイルの更新

CLIを新しくしただけでは、プロジェクト内の .claude/commands/ や .amazonq/prompts/ にあるファイルは古いままです。これらを最新のテンプレートに更新する必要があります。

# --here フラグで現在のディレクトリを指定し、--force でテンプレートを上書きします
specify init --here --force --ai <your-agent>

※ <your-agent> には copilot, claude, q など、お使いの AI エージェントを指定してください。

ワンライナーで更新する（uvxを使う方法）

uvx を使えば、CLIのインストール不要で常に最新版を直接実行できます。ステップ1・2をまとめて1コマンドで完了させたい場合はこちらが便利です。

uvx --from git+https://github.com/github/spec-kit.git specify init --here --force --ai <your-agent>

この方法では毎回最新版がダウンロードされるため、CLI本体の更新を意識する必要がありません。

アップデートで「上書きされるもの」と「上書きされないもの」

アップデート時「上書き（--force）」はしますが、Spec Kitは「開発者が書いた成果物」は上書きしない設計になっています。

上書きされるもの（インフラ系）

  • スラッシュコマンド（.claude/ や .amazonq/ 配下）
  • テンプレートファイル（.specify/templates/）
  • メモリ設定（.specify/memory/） ※要注意

※メモリ設定については、注意点に記載した点を確認してください。

上書きされないもの（成果物系）

  • specs/ ディレクトリ内の全ファイル（仕様書、計画書、タスクリスト）
  • 生成したソースコード
  • Gitのコミット履歴

このように、核となる仕様書やコードが消えることはありませんので、その点はご安心ください。

注意点

安全な設計ではありますが、いくつか手動での対応が必要な「注意ポイント」があります。

1. constitution.md が初期化される

現在の仕様では、specify init --here --force を実行すると、プロジェクトの基本原則を記した .specify/memory/constitution.md がデフォルトのテンプレートで上書きされてしまいます。

対策： アップデート前に Git でコミットしておくか、一時的に別名でコピーして避難させておきましょう。アップデート完了後に元の内容を書き戻せばOKです。

2. IDE上でコマンドが重複して見える

Windsurf, Roo CodeなどのIDE統合型エージェントを使用している場合、アップデート後に古いコマンドと新しいコマンドが混在して表示されることがあります。 その場合は、エージェントの設定フォルダを確認して、古いファイルを手動で削除し、IDEを再起動してください。

まとめ

Spec Kitのアップデートで押さえておきたいポイントは3つです。

  • 2段階で更新する — CLIツールを更新した後、プロジェクトファイルも忘れずに更新。ワンライナーで更新することも可能
  • 仕様書・コードは安全 — specs/ 配下やソースコードは上書きされない設計なので、これまでの成果物が消える心配はない
  • constitution.md だけは要注意 — 現時点では上書きされてしまうため、アップデート前にバックアップを取っておく

Spec Kitは活発に改善が続いています。定期的にアップデートをして、最新の機能を活用し効率的に仕様駆動開発を実践していきましょう。

参考リンク

本記事の内容は執筆時点の情報です。Spec Kitは活発に開発が進んでいるため、最新のアップデート手順や注意点については、公式のアップグレードガイドを必ずご確認ください。

GitHub Spec Kit - Upgrade Guide

針生 泰有(執筆記事の一覧)

サーバーワークスで生成AIの活用推進を担当