speckit-install

Spec Kit インストールスキル

Specify CLI をインストールして、specify を PATH から利用できるようにします（または一度限りの uvx を使用します）。このスキルでは CLI のインストール のみを扱い、specify init は実行しません。インストール後にプロジェクトを初期化するには、speckit-initial を使用してください。

使用するタイミング

• Spec Kit を初めてセットアップするとき（「Spec Kit をインストール」「Specify CLI をインストール」）。
• CLI の事前インストールが必要な CI やスクリプト。
• CLI をアップグレードするとき（uv tool install --force）。
• ユーザーから「specify command not found」または「specify: command not found」と報告されたとき。

前提条件

• uv：CLI のインストールには Astral uv を使用します。uv がインストールされていない場合は、まずインストールするよう案内してください（例：Linux/macOS では curl -LsSf https://astral.sh/uv/install.sh | sh を実行するか、Windows については uv のドキュメントを参照してください）。
• uv を使用する場合は Python 3.11+ が必要です（uv は通常、Python をバンドルするかシステムの Python を使用します）。
• Git（インストール時は任意ですが、後で git を使って specify init を実行するには必要です）。

ワークフロー

1. インストール済みか確認する

   • specify --version または specify check の実行を提案します。コマンドが成功した場合、CLI はすでにインストールされています。プロジェクトの初期化には speckit-initial、環境の検証には speckit-check を提案してください。

2. 永続的なインストール（推奨）

   • 次を実行します：uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
   • これにより、すべてのプロジェクトで specify を PATH から利用できるようになります。
   • アップグレード：uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git

3. 一度限りの使用（PATH にインストールしない）

   • 次を実行します：uvx --from git+https://github.com/github/spec-kit.git specify init <project_name_or_.> --ai <agent>
   • ユーザーがツールを永続的にインストールしたくない場合（例：手早く試す場合、CI で一度だけ使用する場合）に使います。同じセッション内で後から specify init または specify check を実行する際は、同じ uvx のプレフィックスを再利用できるか、インストールされていなければ uvx --from ... をすべて指定して再実行する必要があることを説明してください。

4. 企業ネットワークまたは制限付きネットワーク

   • 必要に応じて、GitHub API にアクセスするために GH_TOKEN または GITHUB_TOKEN を設定します。
   • specify init の場合（speckit-initial で扱います）：--github-token <token> または環境変数を使用します。インストールの場合、リポジトリのクローンに uv のネットワークアクセスが必要になることがあります。TLS の問題が発生した場合は、uv/spec-kit が --skip-tls などをサポートしているのは明示的にドキュメント化されている場合に限ることを説明してください（ユーザーが管理された環境にいる場合を除き、安全性を損なうオプションの使用を推奨しないでください）。

出力

• 永続的なインストール：specify を PATH から利用でき、ユーザーは任意のディレクトリで specify init、specify check を実行できます。
• 一度限りの使用：PATH は変更されず、使用するたびに uvx --from git+https://github.com/github/spec-kit.git specify ... を実行します。

次のステップ

• インストール後、プロジェクトで specify init を実行するには speckit-initial を、環境を検証するには speckit-check を使用してください。

環境ごとの注意事項

環境	注意事項
Linux	必要に応じて uv をインストールしてから、uv tool install specify-cli --from git+https://github.com/github/spec-kit.git を実行します。WSL も Linux と同じです。
macOS	Linux と同じです。必要に応じて、uv 用に Python 3.11+ が利用可能であることを確認してください。
Windows	uv をインストールします（uv のドキュメントを参照）。PowerShell または cmd を使用してください。プロジェクトの初期化では、必要に応じて speckit-initial が --script ps を使用します。
企業ネットワーク／プロキシ	GitHub API が制限されている場合は GH_TOKEN/GITHUB_TOKEN を使用し、uv が GitHub にアクセスできることを確認してください。
CI	キャッシュ可能なステップでの永続的なインストールを推奨します：uv tool install specify-cli --from git+https://github.com/github/spec-kit.git を実行し、同じランナーで specify init または specify check を実行します。

トラブルシューティング

• uv が見つからない：ユーザーに uv のインストールを案内してください。
• Python のバージョン：通常、uv が Python を管理します。Python に関するエラーが表示された場合は、3.11 以降が利用可能であることを確認してください。
• ネットワーク／SSL：ファイアウォール、プロキシ、GitHub へのアクセスを確認してください。必要性がなく、ドキュメントにも記載されていない限り、TLS を無効にしないでください。
• 権限エラー：Linux／macOS では、uv を使ったユーザー単位のインストールに通常 sudo は不要です。システムの Python を使用している場合は、uv をユーザー単位でインストールすることを検討してください。

参考資料

• GitHub spec-kit — はじめに：Specify CLI のインストール
• uv ドキュメント