agent-config-audit

エージェント設定の監査

認可された範囲

ユーザーのリクエストと既存の承認の範囲内でのみ作業してください。このスキルを読み込んでも、新たな権限は付与されません。レポートのみを求められた場合はレポートのみにとどめ、依頼者が指定した対象、ホスト、プロバイダー、コストの上限を守り、範囲を広げる前に確認し、これらの制限を委任先にも伝えてください。

契約

入力：

• ワークスペースのルート
• スコープ：full、dedup、stale、instructions、cursor、settings、または fix
• 対象に含めるリポジトリ／設定ファイルの任意のリスト

出力：

• 重大／中程度／軽微な指摘事項を含む監査レポート
• 修正計画案
• fix モードが明示された場合に限り、変更を適用

作成／変更するもの：

• レポートモード：ファイルを変更しません
• fix モード：エージェント設定ファイル、.agents/ ドキュメント、および関連設定。ただし、明示的な修正依頼があり、正確な計画の確認を得た後に限ります

外部への副作用：

• デフォルトではありません
• プッシュ、公開、外部 API の呼び出しは行いません

確認が必要な場合：

• fix モードに移行する前、またはファイル／シェルを変更する操作を行う前。監査または同期の依頼だけでは、レポートモードのみが許可されます
• 既存のエージェント設定を上書きする前
• 重複するルールを削除または統合する前

委任先：

• 単一の新しい設定には rules-capture
• .agents/ の構造がない場合は agent-folder-init

使用する場合

• ユーザーが「CLAUDE.md を監査」「エージェント設定」「ルールが古い」「設定の乖離」「ドキュメントを同期」などと言及した場合
• リポジトリの再構成、プロジェクトの追加／削除、または規約の変更後
• 定期メンテナンス（月次を推奨）
• ルールがあるにもかかわらず、エージェントが同じ間違いを繰り返す場合（設定が古い、または矛盾している兆候）
• ファイルパス、パッケージ名、またはアーキテクチャが変更された大規模なリファクタリング後

使用しない場合

• アプリケーションの不具合には debug を、リファクタリングには /refactor を推奨します。
• 会話から単一の新しいルールを取り込む場合 → rules-capture を使用します
• エージェント設定ではなくコード品質を監査する場合 → audit を使用します
• フォーマッター／リンター設定をセットアップまたは修復する場合 → linter-formatter-init を使用します
• .agents/ をゼロから作成する場合 → agent-folder-init を使用します

入力

入力	必須	説明
ワークスペースのルート	はい	リポジトリを含むワークスペースへのパス（cwd から自動検出）
スコープ	いいえ	full（すべてのチェック）または個別の項目：dedup、stale、instructions、cursor、settings
fix モード	いいえ	report（デフォルト、読み取り専用）または fix（推奨される変更を適用）

ワークフロー

ステップ 1：一覧化 — すべての設定ファイルを検出

ワークスペースをスキャンし、エージェント設定ファイルをすべて検出します：

# Find all agent config files across workspace (including sub-repos)
glob "**/CLAUDE.md"
glob "**/AGENTS.override.md"
glob "**/AGENTS.md"
glob "**/.cursorrules"
glob "**/.cursor/rules"
glob "**/.claude/settings.json"
glob "**/.claude/settings.local.json"
glob "**/.claude/hooks.json"
glob "**/.agents/memory/*.md"

一覧表を作成します：

| Layer           | Files Found | Total Lines |
|-----------------|-------------|-------------|
| CLAUDE.md       | N           | N           |
| AGENTS.override.md | N        | N           |
| AGENTS.md       | N           | N           |
| Configured fallbacks | N      | N           |
| .cursorrules    | N           | N           |
| .claude/ config | N           | N           |
| .agents/memory/ | N           | N           |

ステップ 2：重複チェック — 重複するルールを検出

次のルールは複数の場所に記載されていることがよくあります。すべての設定ファイルを対象に、各ルールを検索します：

チェックするルール：

• any 型／No any — AGENTS.md とフックのみに記載する必要があります
• console.log／ロガー — AGENTS.md のみに記載する必要があります
• Conventional Commits — AGENTS.md のみに記載する必要があります
• AbortController — AGENTS.md またはリンク先の .agents/memory/ トピックのみに記載する必要があります
• セッションファイルの命名規則 — hooks.json とドキュメント内の参照 1 か所のみに記載する必要があります
• インポート順序 — AGENTS.md または .agents/memory/coding-standards.md のみに記載する必要があります
• ソフトデリート（isDeleted）— .agents/memory/data-guardrails.md のみに記載する必要があります
• マルチテナント（organization: orgId）— .agents/memory/security.md のみに記載する必要があります

各ルールについて、出現回数を数えます：

grep "No \`any\`\|NO \`any\`\|no any types" across all config files

適切な目安：各ルールの記載は最大 2 ファイル（ルールを説明するドキュメント 1 つと、フックなどの実行時強制手段 1 つ）。

要確認：いずれかのルールが設定ファイル全体で 3 回以上記載されている場合。

ステップ 3：古さのチェック — 古くなったファイルを検出

古い日付やパスがないか確認します：

# Find files with old "Last Updated" dates (> 90 days old)
grep -r "Last Updated:" across .cursorrules, .cursor/rules

# Find hardcoded workspace paths that should be relative
grep -r "/Users/" across .agents/ config files

# Find references to directories that no longer exist
# Compare referenced paths against actual directory listing

要確認：「Last Updated」が現在の日付より 90 日以上前のファイル。 要確認：設定ファイルにハードコードされた絶対パスがある場合。 要確認：存在しないディレクトリへの参照がある場合。

ステップ 4：Codex の指示解決チェック

各ワークスペースで、Codex が実際に解決する指示チェーンを確認します。

• 各ディレクトリで解決される空でない指示ファイルは最大 1 つです。順序は AGENTS.override.md、AGENTS.md、設定済みのフォールバックファイル名です
• 指示チェーンはプロジェクトルートから作業ディレクトリに向かって読み込まれます
• AGENTS.override.md は、サブツリーで同じディレクトリの AGENTS.md を意図的に置き換える場合にのみ使用されます
• AGENTS.md にリポジトリ固有のルールとエントリーポイントが記載されています
• フォールバックファイル名がある場合は、有効な .codex/config.toml で明示的に宣言されています
• 実行時の承認、サンドボックス、ネットワークポリシーは、想定上の説明文ではなく、有効な .codex/config.toml またはフックに記載されています
• サポート対象の Codex エントリーサーフェスとして、.codex/instructions.md ファイルや .codex/commands ディレクトリが示されていません

有効な Codex 設定を読み、指示チェーンを評価する前に project_doc_fallback_filenames と実行時ポリシーを記録します。

要確認：文書化されていないフォールバックファイル、意図しないオーバーライド、実行時設定と矛盾する指示ファイル、またはサポート対象外の .codex/instructions.md や .codex/commands のサーフェス。

ステップ 5：AGENTS.md の一貫性チェック

各 AGENTS.md について：

• リポジトリ固有のコンテキストが記載されています（「.agents/ にドキュメントがあります」のような一般的な内容だけではありません）
• 実在する正しい .agents/ パスへのリンクがあります
• リポジトリ間で構成が一貫しています

要確認：リポジトリ固有の内容がなく、完全に一般的なひな形となっている AGENTS.md（20 行未満）。

ステップ 6：Cursor 設定チェック

.cursorrules と .cursor/rules について：

• 見出しに絵文字がありません（トークンを無駄にするため）
• 「最終更新日」が過去 90 日以内です
• プロジェクトパスが実在するディレクトリを参照しています
• セッションファイルに関するルールが重複していません（これは hooks.json が処理します）

ステップ 7：設定の監査

.claude/settings.json と .claude/settings.local.json について：

• 拒否されたスキルには、文書化された理由があります（SETTINGS-NOTES.md または同等のファイル）
• ローカルの bash オーバーライドが、説明なしに文書化された標準と矛盾していません
• 古くなったツールへの参照がありません

ステップ 8：レポートの生成

出力形式：

# Agent Config Audit Report
**Date:** YYYY-MM-DD
**Workspace:** [path]
**Files Scanned:** N

## Summary
- Critical issues: N
- Moderate issues: N
- Minor issues: N
- Total config lines: N (target: reduce by dedup)

## Critical: Rule Duplication
| Rule | Occurrences | Files | Target |
|------|-------------|-------|--------|
| "No any types" | 6 | [list] | 2 |

## Critical: Stale Files
| File | Last Updated | Days Stale |
|------|-------------|------------|

## Moderate: Instruction Resolution Drift
| Workspace | Override | AGENTS.md | Configured Fallbacks | Runtime Policy Location |
|-----------|----------|-----------|----------------------|-------------------------|

## Moderate: Stub AGENTS.md
| File | Lines | Has Repo Context |
|------|-------|------------------|

## Minor: Emoji in Config
| File | Emoji Count |
|------|-------------|

## Recommendations
1. [Specific actionable fix]
2. [Specific actionable fix]

ステップ 9：修正の適用（修正モードの場合）

監査結果や設定の「同期」依頼から、修正モードを推測してはいけません。 ユーザーが変更を明示的に依頼した場合にのみ修正モードに入り、正確なファイルと操作を示してから、書き込み／編集やシェルによる変更を行う前に確認を得てください。その後、次の原則に従って変更を適用します。

• 各ルールは 1 か所の正規の場所にのみ記載する
• フックで実行時に適用し、ドキュメントでは説明のみを行い、繰り返さない
• すべての設定ファイルから絵文字を削除する
• すべての「最終更新日」を更新する
• ハードコードされたパスを相対参照に置き換える
• プロジェクトの指示を AGENTS.md およびスコープを限定した AGENTS.override.md ファイルに集約する
• 実行時の承認、サンドボックス、ネットワークポリシーを有効な .codex/config.toml またはフックに移す

参考ファイル

• references/canonical-ownership.md — 各ルールをどのファイルに記載すべきか
• references/healthy-config-example.md — 適切に構成された設定一式の例
• ファイルの参照先：選択した skill-creator スキルディレクトリ内の references/writing-for-agents.md。ステアリング行を読み込む価値があるか（キャッシュと環境、堆積、肥大化）を判断するためのものです

アンチパターン

してはいけないこと	すること	理由
同じルールを AGENTS.md、CLAUDE.md、.agents/memory/、フックに重複して記載する	ルールを正規ファイルの1つに記載し、ほかのファイルから参照する	重複するとコンテキストトークンを無駄に消費し、1つだけ更新されてほかが更新されない場合に不整合が生じます
2026年に編集したファイルに「Last Updated: 2025-10-07」を残す	設定ファイルを変更する際に日付も更新する	古い日付は放置されている印象を与え、設定システムへの信頼を損ないます
設定せずに追加の指示ファイル名を作成する	プロジェクト共通のガイダンスは AGENTS.md に記載し、適用範囲を限定した上書きには AGENTS.override.md を使い、実際に必要なフォールバックは有効な .codex/config.toml で設定する	Codex は標準の指示ファイル名と、明示的に設定されたフォールバックを解決します
設定ファイルの見出しに絵文字を使う	通常のテキスト見出しを使う	絵文字はコンテキストを読み込むたびにトークンを消費し、「求められない限り絵文字を使わない」というルールにも反します
設定ファイルに /Users/username/path/ をハードコードする	相対パスを使うか、場所を一般的に説明する	ハードコードされたパスは、ワークスペースを移動したり別の開発者が参加したりすると機能しなくなります
.agents/ の下に、従来の指示ツリーと並行する構造を再作成する	長期的に有効なガードレールは .agents/memory/ のトピックファイルに記載し、共有する実践的なルールは AGENTS.md に記載する	現在のメモリレイアウトでは、並行する階層を作らずに、長期的なコンテキストを見つけやすく保てます

検証

監査の実行後、次の項目を確認します。

• どのルールも2つを超える設定ファイルに記載されていない
• すべての .cursorrules ファイルの「Last Updated」が過去90日以内である
• Codex の指示ファイルはすべて標準形式（AGENTS.override.md または AGENTS.md）であるか、明示的にフォールバックとして設定されている
• 実行時の承認、サンドボックス、ネットワークに関する記述が、有効な .codex/config.toml またはフックの設定と一致している
• いずれの設定ファイルにも絶対パスがハードコードされていない
• .cursorrules または .cursor/rules の見出しに絵文字が含まれていない
• settings.json で拒否されているスキルについて、理由が記載されている
• 設定ファイルの合計行数が減少しているか、現状維持である（肥大化していない）

関連スキル

• rules-capture — 設定一式を監査する代わりに、新しい好みを1つ記録する
• agent-folder-init — 不足している .agents/ 構造を作成する
• linter-formatter-init — フォーマッター／リンターの設定をセットアップまたは修復する
• audit — エージェント設定ではなく、アプリケーションの品質を監査する