| name | instructions-audit |
| description | CLAUDE.md/AGENTS.md・skills・context・rules等の指示ファイル監査。指示ファイルの「レビューして」「監査して」「整理・スリム化して」等の依頼時、/instructions-audit実行時に使用。ベストプラクティスrubricで4分類（削除候補/hook・deny移管/skill化・Read-when化/description・構造強化）の指摘を修正案付きで出す。user-level（~/.claude）とproject-level両対応。境界: 指摘の適用・個別知見の追記→update-inst、セッション内容からの知見反映→session-retro、新規スキル作成→create-skill、コード自体の監査→codebase-review。 |
Instructions Audit
指示ファイル（CLAUDE.md / skills / context / rules / settings.jsonのガード設定）を @context/claude-customization-guide.md のrubric（§7）で監査し、4分類の指摘を修正案付きで報告する。このスキルは指摘のみを行い、修正はユーザー承認後に別途実施する（read-only）。
使い方
/instructions-audit # 自動判定（./CLAUDE.md or ./.claude があればproject、なければuser）
/instructions-audit --user # user-level（~/.claude/）を監査
/instructions-audit --project # project-level（./CLAUDE.md, ./.claude/）を監査
/instructions-audit <path> # 指定ディレクトリを監査
既存設定との関係
- rubricの真実源: @context/claude-customization-guide.md §7（本スキルはrubricを重複記載しない）
- Phase 0-5（@context/workflow-rules.md）: 独立（監査は単発タスク。指摘の適用が複雑タスク化する場合のみPhase 0-5に乗せる）
ワークフロー
Step 1: 対象決定
引数から監査スコープを確定する。
- 完了基準: 監査対象のルートパスと、監査対象ファイル群（CLAUDE.md / context/ / skills/ / rules/ / settings.json）のリストが確定している。user-level の実体は
~/.claude/AGENTS.md（CLAUDE.md は互換symlink。修正提案の編集対象は実体側にする）
Step 2: インベントリ作成
対象の全指示ファイルを列挙し、規模を把握する:
- CLAUDE.mdと、そこから
@importされるファイルを再帰的に辿る（@importは毎セッション常駐のため、常駐行数はimport先を全て合算して計算する）
skills/*/SKILL.md の一覧・各行数・frontmatter（description長、allowed-tools有無）・references/の有無context/・rules/ の一覧と行数、どこから参照されているか（@import / プレーンパス / 未参照）settings.json の hooks / permissions.deny・allow
- 完了基準: 「常駐合計行数」「skill数とdescription合計」「未参照ファイル一覧」が数値で出ている
Step 3: rubric適用（監査本体）
@context/claude-customization-guide.md の§7 rubric（4分類）と§1-5の原則を対象に適用する。
対象が大きい場合（合計500行超）はサブエージェントに委譲する（コンテキスト保護。分割例: CLAUDE.md+context系 / skills系）。サブエージェントへの指示に含めること:
-
監査rubricとして claude-customization-guide.md を読むこと
-
指摘ごとに「対象ファイル:行」「4分類のどれか」「根拠となる原則（§番号）」「具体的な修正案」を返すこと
-
下記Gotchasを遵守すること
-
完了基準: 全対象ファイルが監査済みで、各指摘に分類・根拠・修正案が揃っている
Step 4: 報告
以下の構成で報告する（ファイル生成はユーザーが求めた場合のみ）:
- サマリ: 常駐行数・skill数・指摘件数（分類別）
- 指摘一覧: 4分類ごとに、影響の大きい順。各指摘は「対象 / 内容 / 根拠原則 / 修正案（diffまたは書き換え文）」
- 適用の提案: どの指摘から適用すべきかの推奨順。適用はユーザー承認後（個別の適用は
/update-inst スキルを実行する）
- 完了基準: ユーザーが各指摘にyes/noで判断できる粒度になっている
Gotchas（監査時の誤指摘防止）
- @importは毎セッション常駐（必要時ロードではない）。常駐行数の計算はimport再帰を含める
- allowed-toolsは事前承認であって制限ではない。「セキュリティのため制限せよ」という指摘は誤り。read-only skillへの指摘は「事前承認の欠如（permission prompt増）」として出し、実際の制限が必要な場合のみdisallowed-tools/denyを提案する
- コミュニティ由来の数値（行数上限等）を規範として指摘しない。目安として提示し、公式原則（「消したら間違えるか」）を判断基準にする
- 重複に見える記述が意図的な場合がある（冒頭・末尾への重要ルール再掲等）。削除提案時は意図の可能性を添える
- 監査対象に本スキルや claude-customization-guide.md 自身が含まれる場合も除外しない
