validator-check について
validator-check は、AI レビューを行わずに Agent Validator のチェックを実行するスキルです。実行状態を確認し、失敗内容の抽出と修正を行い、必要に応じて再実行します。
主な機能
- 01AIレビューなしでチェックを実行
- 02実行状態の明示的な確認
- 03チェック失敗の詳細抽出
- 04修正後のチェック再実行
活用シーン
- 01AIレビューなしの静的チェック実行
- 02検証チェック失敗の原因調査
- 03再実行による修正の検証
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ codagent-ai/ agent-validator --skill validator-checkインストール後、Claude Code で/validator-checkを入力して読み込まれたか確認します。
詳細
/validator-check
バリデータチェックのみを実行します — AI レビューは行いません。
呼び出しポリシー
このスキルは、ユーザーがバリデータチェックのみ、レビューなしのチェック、静的チェック、または AI レビューなしの検証を明示的に求めた場合にのみ使用してください。
一般的な「バリデータを実行して」「gauntlet を実行して」「検証を実行して」、または最終確認のリクエストにはこのスキルを選択しないでください。そのような場合は /validator-run を使用してください。
手順
ステップ 1 - ログのクリーンアップ
agent-validate clean を実行して、以前のログファイルをアーカイブします。
ステップ 2 - チェックの実行
Bash で timeout: 300000 を指定して agent-validate check を実行します。必ずコマンド出力を最後まで待って読み込んでから次に進んでください。続行する前に、出力に Status: 行があることを確認してください。
ステップ 3 - ステータスの確認
決して成功と決めつけないでください — 続行する前に、明示的な Status: 行を確認する必要があります。それを確認し、次のように振り分けます:
Status: Passed→ ステップ 7 へ進みます。Status: Passed with warnings→ ステップ 7 へ進みます。Status: Failed→ ステップ 4 へ続きます。必ず続行してください — ここで停止してはいけません。Status: Retry limit exceeded→agent-validate cleanを実行してログをアーカイブします。ステップ 7 へ進みます。- ステータス行が見当たらない → 既知の問題: Bun が stdout/stderr をすべて破棄することがあります。コンソールログファイルを読み込んでステータスを取得してください。バリデータログディレクトリ内の最新の
console.*.log(例:validator_logs/console.1.log)を見つけ、そこにあるStatus:行を探します。そこにコンソールログが見つからない場合は、validator_logs/previous/にある直近のアーカイブ済み実行のログも確認してください。どちらの場所にもコンソールログが存在しない場合、コマンドがタイムアウトしたか実行に失敗した可能性があります — より長いタイムアウトで再実行するか、エラーを調査してください。合格したものとして進めないでください。
ステップ 4 - 失敗の抽出
ステータスが Failed の場合に必須です:
- コンソール出力内のファイルパスからログディレクトリを推測します(例:出力が
validator_logs/check_._lint.1.logを参照している場合、ログディレクトリはvalidator_logs/です) - 利用可能な最初の戦略を使用してログの失敗を抽出します:
a. Task ツール(Claude Code):
Taskをsubagent_type="general-purpose"、model="haiku"、prompt=に Extract Prompt(以下の付録から)+"\n\nLog directory: <推測したパス>"を指定して実行します。Task 呼び出しは同期的でなければなりません — 決してrun_in_background: trueを使用しないでください。 b. サブエージェントへの委任:環境がサブエージェントへの作業委任をサポートしているが Task ツールはサポートしていない場合、Extract Prompt の指示をログディレクトリとともにサブエージェントに委任して処理させます。 c. インラインフォールバック:サブエージェント機能が利用できない場合、Extract Prompt の指示に従って自身でログファイルを読み込み、簡潔な失敗サマリーを作成します。
ステップ 5 - 修正
失敗したすべてのチェックを修正します:
- Fix Skill が指定された CHECK の失敗:指定されたスキルを呼び出します
- Fix Instructions が指定された CHECK の失敗:指示に従います
ステップ 6 - 検証の再実行
このステップを決して省略しないでください — 実行が失敗した場合、必ず修正して再実行する必要があります。Bash で timeout: 300000 を指定して agent-validate check を再度実行します。再試行の間に agent-validate clean を実行しないでください。ツールは既存のログを検出し、自動的に検証モードに切り替わります。ステップ 3 に戻り、ステータス行を確認して繰り返します。
ステップ 7 - セッションのサマリー
セッションのサマリーを提供します:
- 最終ステータス:(Passed / Passed with warnings / Retry limit exceeded)
- 修正したチェック:(主な修正を列挙)
- 未解決の失敗:(再試行制限を超えた場合、未検証の修正と残っている問題を列挙)
付録:サブエージェントプロンプト
Extract Prompt
あなたは EXTRACT サブエージェントです。あなたの役割は、バリデータチェックのログファイルを読み込み、簡潔なエラーサマリーを返すことです。
入力
唯一の入力としてログディレクトリのパスを受け取ります。
処理
- ログディレクトリ直下のファイルを一覧表示します
- 最も番号の大きい
console.N.logファイルを探します(例:console.3.log>console.2.log) - それを読み込み、
[FAIL]を含むすべての行を探します - 各
[FAIL]行について、参照されている.logファイルのパスを抽出します - 参照された各ログファイルを読み込み、エラー出力を抽出します。
--- Fix Instructions ---セクションと--- Fix Skill: <name> ---セクションを探します。それらの内容をすべて含めます。
出力形式
次の形式を厳密に使用して、プレーンテキストのサマリーを返します:
CHECKS:
[fail] <gate_label>
<concise error description>
Fix Instructions: <extracted text if present, otherwise omit this line>
Fix Skill: <skill name if present, otherwise omit this line>
例
入力例
ログディレクトリ: validator_logs/
ディレクトリの内容:
console.2.logcheck_src_lint.2.log
console.2.log の内容:
[START] check:src:lint
[FAIL] check:src:lint (1.23s) - Exited with code 1
Log: validator_logs/check_src_lint.2.log
check_src_lint.2.log の内容:
[2026-02-15T10:23:45.123Z] Starting check: lint
Executing command: bun run lint
Working directory: /Users/user/project/src
src/helpers.ts:3:5 - error: Unexpected var, use let or const instead
Command failed: bun run lint
Result: fail - Exited with code 1
--- Fix Instructions ---
Replace all `var` declarations with `const` or `let`.
出力例
CHECKS:
[fail] check:src:lint
src/helpers.ts:3:5 - error: Unexpected var, use let or const instead
Fix Instructions: Replace all `var` declarations with `const` or `let`.
ルール
- 要約したり編集したりしないでください — 可能な限りエラーの詳細をそのままコピーしてください
[FAIL]エントリをスキップしないでください- 出力はコンパクトに保ってください — チェック失敗ごとに 1 エントリとします
Fix Instructions/Fix Skillの行は、存在する場合にのみ含めてください