エージェント指示ファイルの監査
目的：指示ファイル内の間違っている、古くなっている、曖昧な、または危険な行を見つけ、より短く正確なバージョンを提案すること。実行したことのないコマンドや確認していないパスを決して「修正」しないでください。
手順
- ファイルを見つける。
AGENTS.md、CLAUDE.md、CLAUDE.local.md、.claude/rules/*.md、.cursor/rules/*.mdc、.cursorrules、.github/copilot-instructions.md、.github/instructions/*.mdを探します。見つかったものと、各ファイルを誰が読むかをリストアップします。 - チェッカーを実行する リポジトリルートから、まず機械的な発見を得ます：
python3 scripts/audit_instructions.py <file> [<file> ...]（パスはこのスキルのフォルダからの相対パスです。インストールされたスキルへのフルパスを使用してください。）チェッカーは、長さ、壊れたファイルパス、存在しないスクリプトやmakeターゲットを指定するコマンド、曖昧なフレーズ、残っている[BRACKET]プレースホルダー、重複行、秘密文字列を報告します。Pythonが利用できない場合は、同じチェックを手動で行ってください。 - 各コマンドを自分で確認する。 ファイル内のすべてのコマンドについて、それが存在することを確認します（
package.jsonのスクリプト、Makefileのターゲット、pyproject.tomlのエントリ）。安価で安全なもの（lint、単体テスト、型チェック）は実行します。デプロイ、移行、削除コマンドは実行しないでください。「未確認」としてリストします。 - スクリプトでは判断できない部分をチェックする：
- リンターやフォーマッターが既に強制しているルール（削除候補）。
- 互いに矛盾するルール、または別の指示ファイルと矛盾するルール。
- エージェントがリポジトリから数秒で読み取れる事実（フレームワーク名、フォルダ一覧）。
- テスト可能な意味を持たないルール（「きれいなコードを書く」など）。
- ルートファイルではなく、パススコープのルールに属するもの。
- 報告する その後、編集の前に承認を待ちます。
報告フォーマット
## 指示ファイル監査: <file>
長さ: <n> 行 (<判定>)
### 修正必須（間違っている、または危険）
- 行 <n>: <何が問題か>, <証拠: コマンド出力または欠落パス>
### 削除推奨（価値が低い）
- 行 <n>: <削除できる理由>
### 矛盾
- <ファイルA 行n> 対 <ファイルB 行m>: <競合内容>
### 未確認
- <コマンド>: <実行しなかった理由>
### 提案バージョン
<短くしたファイル、または差分>
ルール
- 証拠は意見に勝る：「修正必須」はすべて出力か欠落ファイルを引用します。
- 所有者の口調と、実際のインシデントやハードな制約をコード化したルールは維持します。
- 監査中は新しいルールを追加しないでください。別途、最後に最大3つ提案してください。
- 秘密文字列のように見えるものは実際のものとして扱います：ユーザーにそれをローテーションするよう伝え、レポート内でその値を繰り返さないでください。