speckit-initial

Spec Kit の初期化スキル

specify init を実行して Spec Kit プロジェクトを初期化します。.specify/（memory、scripts、templates、specs）を取得し、選択した AI エージェントに /speckit.* スラッシュコマンドを登録します。このスキルは Specify CLI がすでにインストールされていることを前提としています。インストールされていない場合は、まず speckit-install を案内してください。

使用するタイミング

• プロジェクトで初めて Spec Kit を有効にするとき（「Spec Kit を初期化」「ここに Spec Kit をセットアップ」）。
• AI エージェントを切り替えるとき（例：Claude から Cursor または Gemini に切り替える）。
• 新規または既存のディレクトリで初期化するとき。
• Windows で PowerShell スクリプトが必要なとき（--script ps）。

前提条件

• Specify CLI がインストールされていること（speckit-install を参照）。specify が PATH にない場合は、続行する前に speckit-install を実行するよう案内してください。
• Git（任意。プロジェクトが git リポジトリでない場合、または git 関連のセットアップを省略する場合は --no-git を使用します）。

ワークフロー

1. CLI を確認する

   • ユーザーから「specify command not found」と報告された場合、または CLI が未インストールの場合は、まず speckit-install を案内してください。それ以外の場合は続行します。

2. パラメーターを選択する

   • --ai（スラッシュコマンドに必須）：claude | cursor-agent | gemini | copilot | windsurf | qwen | opencode | codex | qoder | amp | shai | bob | kilocode | auggie | roo | codebuddy — このプロジェクトでユーザーが使用するエージェントを選びます。
   • --script：sh（デフォルト、Bash）または ps（PowerShell）。Windows で PowerShell スクリプトが必要な場合は ps を使用します。
   • 対象：現在のディレクトリでは specify init . または specify init --here、新しいサブディレクトリでは specify init <project_name> を使用します。
   • --force：既存の .specify/ がある場合は上書きします（慎重に使用してください）。
   • --no-git：git 関連のセットアップを省略します。
   • --ignore-agent-tools：エージェント固有のツールをインストールまたは確認せず、テンプレートと .specify/ の構成のみを取得します。
   • --github-token または GITHUB_TOKEN：プライベートリポジトリまたはアクセスがレート制限されている場合に使用します。

3. コマンドを実行する

   • ユーザーの OS と選択したエージェントに応じた具体的なコマンドを提示します。例：
     • 現在のディレクトリ、Cursor：specify init . --ai cursor-agent
     • 現在のディレクトリ、Claude：specify init . --ai claude
     • Windows、Copilot、PowerShell スクリプト：specify init . --ai copilot --script ps
     • 新しいサブディレクトリ：specify init my-app --ai gemini

4. 出力を確認する

   • 成功後、プロジェクトに .specify/（memory、scripts、templates、specs）が含まれ、エージェントで /speckit.* スラッシュコマンドを使用できることを確認します。

出力

• プロジェクト：memory、scripts、templates、specs を含む .specify/ ディレクトリ。
• エージェント：選択した AI エージェントで使用できるスラッシュコマンド（例：/speckit.constitution、/speckit.specify、/speckit.plan）。

次のステップ

• speckit-check を実行して環境を確認します（任意ですが推奨）。
• 次に speckit-constitution または speckit-specify を使用して Spec Kit のワークフローを開始します。

環境ごとの設定例

環境	例
Linux / macOS、Cursor	specify init . --ai cursor-agent
Linux / macOS、Claude	specify init . --ai claude
Windows、Copilot、PowerShell	specify init . --ai copilot --script ps
新しいサブディレクトリ	specify init my-project --ai gemini
既存の .specify を上書き	specify init . --ai claude --force
git なし	specify init . --ai claude --no-git
テンプレートのみ（エージェントツールなし）	specify init . --ai claude --ignore-agent-tools

トラブルシューティング

• 「specify: command not found」：まず speckit-install を使用してください。
• Windows でスラッシュコマンドが表示されない：エージェントが PowerShell を必要とする場合は --script ps を使用したこと、およびエージェントがプロジェクトからコマンドを読み込むよう設定されていることを確認してください。
• プライベートリポジトリ／レート制限：GITHUB_TOKEN を設定するか、spec-kit のドキュメントに従って --github-token <token> を渡してください。

参考資料

• GitHub spec-kit — はじめに：プロジェクトを初期化する