context-audit

コンテキスト監査

コンテキストウィンドウを消費している要因を分析し、最適化を提案します。3 つの監査モードは、個別にも組み合わせても実行できます。

クイックスタート

• /context-audit または「コンテキストを監査して」 — 3 つすべての監査を実行します
• 「静的監査」または「コンテキストの一覧」 — ファイルの一覧表示のみ
• 「セッション分析」 — JSONL のトークン解析のみ
• 「コンテキストスコア」 — スコアリングと提案のみ

監査モード

1. 静的インベントリ

scripts/audit-context を実行すると、静的インベントリを自動生成できます。構造化出力の --json、問題のみを表示する --flagged、サイズの大きい項目を表示する --top N をサポートしています。

このスクリプトは、コンテキストに寄与するすべてのソースをスキャンします。

• スキル（SKILL.md、rules/、references/）
• CLAUDE.md ファイル（グローバル、プロジェクト、サブディレクトリ）
• 自動メモリファイル（~/.claude/projects/*/memory/*.md）
• プラグイン（プラグインごとのツール数の推定値を含む）
• MCP サーバー

しきい値： SKILL.md が 500 語を超える場合、rules/ ディレクトリがある場合、CLAUDE.md が 2KB を超える場合、MCP サーバーが 5 つ以上ある場合、ツールが 10 個以上あるプラグインにフラグを付けます。

2. ライブコンテキストウィンドウ（/context）

静的インベントリを実行した後、組み込みの /context コマンドについてユーザーに伝えます。

• リアルタイムのトークン使用状況（現在のトークン数、最大容量、使用率）を表示します
• 現在コンテキストウィンドウに含まれている内容（システムプロンプト、会話、ツールの結果）を内訳表示します
• ライブのトークンデータを確認するため、ユーザー自身で /context を実行するよう勧めてください。静的インベントリを補完する情報が得られます
• ユーザーが /context の出力を共有した場合は、スコアリング（セッション効率の項目）に反映してください

3. セッショントークン分析

現在のセッションの JSONL を解析し、コンテキストの増加を追跡します。

1. ~/.claude/projects/ からアクティブなセッションの JSONL を探します
2. 各ターンの usage.input_tokens と usage.cache_read_input_tokens を抽出します
3. 連続するターン間で最も大きいトークン増加を 5 つ特定します
4. 増加を、その前のターンでのツール呼び出しと照合します
5. 各急増の原因を報告します

JSONL の解析手順の詳細については、references/audit-procedures.md を参照してください。

4. 提案とスコアリング

実行可能な提案と、評価（A～F、0～100）を作成します。

スコアの重み：

項目	重み
スキルの健全性	30%
CLAUDE.md の健全性	25%
プラグイン／MCP の健全性	25%
セッション効率	20%

出力形式

次のセクションを含む単一のレポートを作成します。

1. 静的インベントリの表（audit-context スクリプトの出力に基づく）
2. /context に関する注記 — ライブのトークン内訳を確認するため、ユーザーに /context の実行を促します
3. セッション分析（JSONL が利用できる場合）
4. 主な提案
5. スコア

手順、スコアリング基準、提案のルールについて詳しくは、references/audit-procedures.md を参照してください。