validator-commit について
validator-commit は、Agent Validator の利用を明示したコミット向けのスキルです。対象ゲートを検出し、意図に応じて全検証、チェックのみ、または検証のスキップを行ってからコミットします。
主な機能
- 01対象となる検証ゲートの検出
- 02全検証またはチェックのみの実行
- 03明示的な検証スキップ
- 04検証フロー後のコミット
活用シーン
- 01全検証ゲート通過後のコミット
- 02コミット前のチェックのみ実行
- 03コミット時の検証スキップ
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ codagent-ai/ agent-validator --skill validator-commitインストール後、Claude Code で/validator-commitを入力して読み込まれたか確認します。
詳細
/validator-commit $ARGUMENTS
バリデーターによる検証を明示的に意図してコミットします。まず agent-validate detect を実行し、意図(完全実行、チェックのみ、またはスキップ)に基づいて検証し、失敗を処理してからコミットします。
呼び出しポリシー
このスキルは、完全な検証、チェックのみの検証、またはコミットの一環としてバリデーターの状態を意図的にスキップすることを含め、ユーザーがコミットフローに Agent Validator を関与させるよう明示的に依頼した場合にのみ使用してください。
validator、gauntlet、checks、validation、skip に言及していない、単なる「commit」「make a commit」「commit these changes」というリクエストでは、このスキルを選択しないでください。
ステップ 1 - 変更の検出
Bash を使用して agent-validate detect を実行します:
agent-validate detect 2>&1; echo "DETECT_EXIT:$?"
DETECT_EXIT: 行の終了コードを確認します:
- 終了コード 0 → ゲートが実行されるため、ステップ 2 に進みます
- 終了コード 2 → ゲートが実行されないため(変更なし、または該当するゲートなし)、ステップ 4 にスキップします(直接コミット)
- 終了コード 1 → エラー。エラーをユーザーに報告して停止します
- その他の終了コード → エラーとして扱い、出力をユーザーに報告して停止します
ステップ 2 - 検証の意図の判定
$ARGUMENTS を解析して検証の意図を判定します。明確な意図が見つかった場合はユーザーにプロンプトを表示しないでください。
| ARGUMENTS のパターン | アクション |
|---|---|
| 「check」または「checks」を含む | /validator-check を呼び出します(ステップ 3b) |
| 「run」、「full」、または「all gates」を含む | /validator-run を呼び出します(ステップ 3a) |
| 「skip」を含む | agent-validate skip 2>&1 を実行し(ステップ 3c)、その後ステップ 4 に進みます |
| 空、または明確な意図なし | 以下の 3 つの選択肢をユーザーに提示し、選択を待ちます |
「run checks before commit」のようなフレーズが /validator-check を選択するよう、汎用的な「run」パターンより先に「check」または「checks」パターンを評価してください。
ユーザーにプロンプトを表示する場合、以下の選択肢を提示します:
- すべてのゲートを実行 — 完全な検証(チェック + レビュー)
- チェックのみを実行 — AI レビューなしのチェック
- バリデーターをスキップ — ゲートを一切実行せずにベースラインを進めます
その後、ユーザーの選択に対応するステップに進みます。
ステップ 3a - 完全な検証(validator-run)
/validator-run を呼び出します。
- 成功した場合 → ステップ 4 に進みます
- 失敗した場合 →
/validator-runスキルが修正と再実行を処理します。そのスキルが完了した後、ユーザーに 「コミットする準備はできましたか?」 と尋ねます。確認があった場合にのみステップ 4 に進みます。
ステップ 3b - チェックのみの検証(validator-check)
/validator-check を呼び出します。
- 成功した場合 → ステップ 4 に進みます
- 失敗した場合 →
/validator-checkスキルが修正と再実行を処理します。そのスキルが完了した後、ユーザーに 「コミットする準備はできましたか?」 と尋ねます。確認があった場合にのみステップ 4 に進みます。
ステップ 3c - 検証のスキップ
実行します:
agent-validate skip 2>&1
コマンドの出力をユーザーに報告し、その後ステップ 4 に進みます。
ステップ 4 - コミット
git の変更をコミットするためのスキルが利用可能かどうかを確認します(自己呼び出しを避けるため、validator-commit 自体は除きます)。
- コミットスキルが見つかった場合 → そのスキルを呼び出してコミットを実行します
- コミットスキルが見つからない場合 → 追跡されているすべての変更をステージングし、conventional commits 形式(
<type>: <description>)に従ったコミットメッセージを提案してから、git commit -m "<message>"を実行します