validator-status について
validator-status は、直近の Agent Validator セッションの状態やゲート結果を確認し、失敗したチェックやレビューの詳細をまとめるスキルです。
主な機能
- 01セッション状態と実行概要
- 02ゲート結果の一覧
- 03ログから失敗詳細を抽出
- 04レビュー違反の項目表示
活用シーン
- 01直近の検証セッションの確認
- 02ゲート失敗の原因特定
- 03ファイルや状態別のレビュー違反追跡
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ codagent-ai/ agent-validator --skill validator-statusインストール後、Claude Code で/validator-statusを入力して読み込まれたか確認します。
詳細
/validator-status
直近のバリデータセッションの詳細なサマリーを表示します。
ステップ 1: ステータススクリプトを実行する
agent-validate status 2>&1
このスクリプトは .debug.log を解析してセッションレベルのデータ(実行回数、ゲート結果、合格/不合格ステータス)を取得し、すべてのログファイルをそのパスとサイズとともに一覧表示します。
ステップ 2: 失敗したゲートの詳細を確認する
Gate Results テーブルで FAIL とマークされた各ゲートについて、対応するログファイルを読み込み、失敗の詳細を抽出します。
- チェックの失敗(例:
check:src:code-health): 一致するcheck_*.logファイルを読み込みます。チェックログの形式はツール(リンター、テストランナー、コードヘルスアナライザー)によって異なります — ファイルを読み込み、関連するエラー/警告の出力を抽出してください。 - レビューの失敗(例:
review:.:code-quality): 一致するreview_*.jsonファイルを読み込みます。これらには、file、line、issue、priority、statusフィールドを持つ構造化された違反データが含まれています。
スクリプト出力の「Log Files」セクションにあるファイルパスを使用してください。ゲート ID をファイル名に対応付けます: check:.:lint は check_._lint.*.log に、review:.:code-quality は review_._code-quality_*.{log,json} に対応します。
ステップ 3: 結果を提示する
スクリプトのセッションサマリーと詳細な失敗情報を組み合わせて、包括的なレポートを作成します。
- セッションの概要(ステータス、イテレーション、所要時間、修正済み/スキップ/失敗の件数)
- ゲート結果テーブル
- 失敗したゲートがある場合: ログファイルから得られた具体的なエラー、違反、またはテストの失敗
- 違反のあるレビューの場合: 各違反を file、line、issue、priority、および現在のステータス(fixed/skipped/outstanding)とともに列挙
コメント
Markdown 対応