メインコンテンツまでスキップ

スキルスキーマを検証する

スキーマとバリデータを使用して、Upstream、Midstream、Downstream のチェック間でスキルの一貫性を保ちます。

手順

  1. skills/ 配下のスキルを編集または追加する。

  2. バリデータを実行する:

    npm run skills:validate
  3. スキーマチェックでエラーが発生した場合、以下の必須フィールドが存在することを確認する:

    • id
    • name
    • description
    • category(ルーティングの第一キー。phase は後方互換のため残る任意フィールド)
    • applyTo(または files / path_patterns
  4. category が意図したフローセグメント(core / upstream / midstream / downstream)と一致することを確認し、ノイズの多い一致を避けるために applyTo グロブを調整する。

  5. エラーがなくなるまでバリデータを再実行し、PR にコマンドの出力を含める。

ヒント

  • タグと重要度(severity)を、発見事項の優先順位付けに合わせて調整する。
  • 小さなサンプルファイルを追加してドラフト PR を開き、レビューアがスキルをどのようにルーティングするかを確認する。