スキルルーティングのデバッグ
スキルがトリガーされない(または頻繁にトリガーされすぎる)場合、以下のチェックを行います。
チェックリスト
- スキーマ: スキルが
npm run skills:validateを通過することを確認する。 - フェーズ:
phaseが変更されたファイル(Upstream/Midstream/Downstream)と一致していることを確認する。 - applyTo グロブ: パターンが PR 内のパスと一致しているか確認する。スキルをトリガーすべき最小限のテストファイルを使用してください。
- 重要度/タグ: ランナーのフィルタが、スキルを除外するタグや重要度を使用していないか確認する。
- 最近の変更: スキルファイルの git履歴を確認し、ルーティングロジックが変更されていないか見直す。
クイックテスト
スキルの applyTo グロブに一致するファイルを変更するドラフト PR を開く。発見事項が表示されない場合は、デバッグログを追加するか、一時的にグロブを既知の単一パスに絞り込んでから、ワークフローを再実行する。