skill-auditlisted

# skill-audit — Agent Skills 棚卸し監査 ## 目的 `.claude/skills/` + `.claude/commands/` を定期的に棚卸しし、トリガー精度の劣化・死蔵・陳腐化・肥大化・ 責務重複・欠落を機械検証込みで検出する。過去 2 回（#131・2026-07-02 第2回）はアドホック実施だったため 定型化し、同一観点・同一出力フォーマットで再現できるようにする。 ## 実行フロー ### Step 1: 対象列挙・行数集計 ```bash wc -l .claude/skills/*/SKILL.md .claude/skills/*/reference.md .claude/commands/*.md 2>/dev/null ``` 各ファイルの `name` / `description`（frontmatter）を読み、一覧表を作る（スキル名・行数・description 文字数）。 ### Step 2: 参照実在チェック（機械検証・目視に依存しない） ```bash python3 tools/check_skill_references.py --json ``` SKILL.md / commands **および `docs/rules/` のルール本体**（#349 で対象拡張）の本文中の `tools/*.py`・`docs/rules/*.md`・`.claude/**`・`content/**` への言及を正規表現抽出し、リポジトリ上の 実在を検証する。exit code 1 = リンク切れ or 肥大化検出（肥大化判定は SKILL.md / commands のみ・ 既定閾値 500 行。ルール本体は行数の性質が違うため参照検証のみ）。 **除外規約（#350・明示マーカーのみ）**: 誤検知しうる参照は **行単位** で除外する。 | 手段 | 使う場面 | | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | | 該当行末に `<!-- refcheck:ignore -->`（表なら最終セル内） | 実行時生成物・ローカル専用ファイル・「存在しない」と明示した否定文脈・歴史的言及・出自プロジェクト由来のファイル名 | | `<!-- refcheck:ignore-start -->` 〜 `<!-- refcheck:ignore-end -->` | 長い表・一覧をまとめて外すとき（範囲内に実在参照を含めないこと） | > 🔴 **自然言語の注意書き（「出自プロジェクトの実例