mcpField
S
speckit-check

speckit-check

github.com/full-stack-skillsエージェントワークフロー062 回インストール4 週間前に更新
リポジトリ

speckit-check について

speckit-checkは、`specify check`を実行し、Spec Kit CLIと必要なツールがインストールされ検出可能かを確認するスキルです。不足項目をまとめ、次の対応を案内します。

主な機能

  1. 01Specify CLI環境の確認
  2. 02Git、エージェント、エディターの検出
  3. 03不足ツールの要約
  4. 04次の対応の提案

活用シーン

  1. 01初期化後の環境確認
  2. 02スラッシュコマンドが使えない場合の調査
  3. 03CIやスクリプトでの依存関係確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/full-stack-skills/speckit-skills --skill speckit-check

インストール後、Claude Code で/speckit-checkを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yamlexamples/sample-output.md

詳細

Spec Kit チェック スキル

specify check を実行して、Spec Kit CLI と必須ツール（git、AI エージェント、エディター）がインストールされ、検出可能であることを確認します。環境を確認するために speckit-install または speckit-initial の後に実行するか、スラッシュコマンドが見つからない、または specify が動作しないとユーザーから報告があった場合に使用します。

使用するタイミング

  • speckit-initial でプロジェクトを初期化した後、環境を確認するとき。
  • スラッシュコマンドが表示されない場合、またはユーザーが「specify が動作しない」と伝えたとき。
  • Spec Kit の手順を実行する前に依存関係がそろっていることを確認するため、CI やスクリプトで使用するとき。

前提条件

  • Specify CLI がインストールされている必要があります（speckit-install を参照）。specify が PATH にない場合は、specify check を実行する前に speckit-install を案内してください。

ワークフロー

  1. CLI が利用可能であることを確認する

    • ユーザーが CLI をインストールしていない場合、または「specify: command not found」と報告した場合は、まず speckit-install を案内してください。specify が利用可能になるまでは specify check を実行しないでください。

  2. チェックを実行する

    • プロジェクトのルート（または対象ディレクトリ）から実行します：specify check
    • このコマンドは、検出されたツール（例：git、claude、gemini、code、cursor-agent、windsurf、qwen、opencode、codex、shai、qoder）と、見つからないツールや PATH にないツールを報告します。

  3. 出力を解釈する

    • 必須ツールがすべてそろっている場合：環境は準備完了です。speckit-constitution または speckit-specify に進むよう提案してください。
    • CLI が見つからない場合：speckit-install を案内してください。
    • エージェントまたはエディターが見つからない場合：該当するエージェント／エディターをインストールするか、その実行ファイルを PATH に追加するよう提案してください。スラッシュコマンドは不要で、テンプレートと .specify/ だけが必要な場合は、--ignore-agent-tools を付けて speckit-initial を再実行するよう提案してください。

  4. 要約して推奨事項を示す

    • 問題ない項目と不足している項目を簡潔にまとめます。
    • 具体的な次の手順（CLI のインストール（speckit-install）、別のエージェントを使った再初期化（speckit-initial）、または PATH の修正／エージェントのインストール）を示します。

出力

  • 要約：検出されたツールと不足しているツール。
  • 推奨事項：次のアクションの一覧（CLI のインストール、初期化の実行、エージェントのインストール、PATH への追加、または specify init --ignore-agent-tools の使用）。

次のステップ

  • 不足しているものがある場合：speckit-install（CLI の場合）または speckit-initial（再初期化、または --ignore-agent-tools を使用する場合）を使うか、不足しているエージェント／エディターをインストールします。
  • チェックに合格した場合：speckit-constitution または speckit-specify に進みます。

出力例（参考）

specify check の出力例とその解釈方法については、examples/sample-output.md を参照してください。

トラブルシューティング

  • 「specify: command not found」：speckit-install を使用してください。
  • エージェントが見つからないと報告される：エージェントアプリがインストールされ、その CLI または実行ファイルが PATH にあることを確認してください。テンプレートだけが必要な場合は、specify init --ignore-agent-tools を使用してください。
  • Git が見つからない：git をインストールするか、ワークフローで git が不要な場合は specify init --no-git を実行してください。

参考資料

コメント

Markdown 対応