skill-trace-debugger について
ライブの動作テスト前に、リポジトリ内のスキルの静的なトレースおよび評価準備状況を確認するスキルです。評価の実行やセッションログの収集は行わず、単一スキルまたはリポジトリ全体のカバレッジ情報を報告します。
主な機能
- 01単一スキルのトレース準備状況を確認
- 02リポジトリ全体の準備状況を集約
- 03評価とバリデーターのシグナルを確認
- 04明示的な呼び出しのカバレッジ不足を特定
- 05機械可読なレポートを出力
活用シーン
- 01動作評価前のスキル確認
- 02スキル間のトレース不足の発見
- 03準備状況シグナルの不足確認
- 04リポジトリ全体の準備状況レポート作成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/skill-trace-debuggerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
evals/evals.jsonscripts/check.pytrace_report.pyscripts/asset_toolkit/validate_hooks.py詳細
スキルトレースデバッガー
ライブでの動作実行前に、リポジトリ内のスキルのトレースと評価のカバレッジ不足を明らかにします。
対象範囲： 静的なトレース準備状況のチェックのみです。ライブ評価の実行やセッションログの収集は行いません。
ディスパッチ
| $ARGUMENTS | アクション |
|---|---|
<name> | 1 つのスキルのトレース準備状況レポート |
repo / --all | 全スキルのトレース準備状況の概要 |
--format json | 機械可読なレポート |
| 空 | トレースシグナルのチェックリストを表示 |
トレース準備状況チェックリスト
| シグナル | 意味 |
|---|---|
evals/evals.json | 事後採点用の動作ケースが存在します |
scripts/check.py | 移植可能なバリデーターの契約が組み込まれています |
| 明示的な呼び出しケース | 評価にスラッシュコマンドまたは名前付きディスパッチプロンプトが含まれています |
| NOT-for 境界 | 説明で、適切な代替スキルが指定されています |
ワークフロー
uv run python skills/skill-trace-debugger/scripts/trace_report.py <name>
uv run python skills/skill-trace-debugger/scripts/trace_report.py --all --format json
ライブトレースの採点は、agent-eval-runner またはメンテナーの CI ワークフローに振り分けてください。
バリデーション契約
uv run python skills/skill-trace-debugger/scripts/check.py
重要なルール
- 静的レポートだけに基づいて、ライブトレースを取得したと主張してはいけません。
- 明示的な呼び出しの評価ケースがない場合は、内部スキルに対する重大な失敗ではなく、カバレッジ不足として扱ってください。
- メンテナーの承認なしに、評価マニフェストを変更しないでください。
- 新しいケースを追加する場合は、トレースレポートと skill-eval-scaffolder を併用してください。
- プロンプトは各スキルのディスパッチテーブルに沿った内容にしてください。
コメント
Markdown 対応