用途
Context Audit 用于审计 Claude Code 的配置，找出其中的 token 浪费与上下文膨胀。其核心判断是：臃肿的上下文会带来双重代价——用量额度消耗更快，同时输出质量下降，因为模型对长上下文窗口中段内容的注意力更低。该技能定位为发现浪费并告知用户应当削减什么，同时给出每项修复预计每轮节省的 token 数。
建议投入程度：过滤规则复核与报告撰写为中等，审计脚本执行为低。
工作流
技能按以下顺序推进，每个阶段为下一阶段提供输入：
context-snapshot → audit-script → reconcile-filters → report → offer-fixes
其中脚本负责确定性工作（文件扫描、评分、候选规则预过滤），模型负责判断性工作（过滤规则复核、叙述性报告）。
上下文加载策略
参考资料按需在需要它的阶段加载，绝不预先全部加载。脚本输出是事实基础，参考资料解释如何解读并基于它采取行动。
- context-snapshot：不加载任何内容，若可用则向用户索取 /context 输出
- audit-script：不加载任何内容，运行 scripts/audit.py 并读取其 JSON
- reconcile-filters：加载 filters.md
- report：加载 templates/report.md，仅在解释扣分项时加载 scoring.md
- offer-fixes：不加载任何内容，询问用户要应用哪些修改并展示 diff
checks.md 仅在排查扫描器异常结果时加载。
触发条件
- 审计上下文、检查设置、「为什么 Claude 变慢」：对应 filters.md（在 reconcile 阶段加载）
- 解释某扣分项或评分组成：对应 scoring.md
- 撰写审计报告：对应 report.md
- 排查扫描器发现项：对应 checks.md
注：scoring.md 与 checks.md 不是直接触发器，而是在审计工作流中按需加载——当模型需要为一个数字提供依据，或调查扫描器的异常输出时。
交叉引用
- filters.md → scripts/audit.py（脚本负责预过滤，此文件是判断层）
- templates/report.md → scoring.md（报告引用分数，评分规则位于此处）
- checks.md → scripts/audit.py（checks 文档解释每个扫描器检查什么）
- context-audit → wrap-up（建议在会话笔记中周期性重跑）
准则
应当做到：
- 报告以每轮预计节省的 token 开头，这是面向用户的价值所在
- 为每一项变更展示 diff，包括 settings.json——一个错误的键会破坏会话
- 在 /context 输出可用时从中提取 MCP token 估算；仅当用户无法运行 /context 时，才回退到每服务器约 15,000 token
- 将 scripts/audit.py 的输出视为事实基础，不手动重新扫描文件
- 结合 filters.md 的判断，确认或重新分类脚本预过滤出的规则
- 在问题之前，用「What's working」章节呈现正面发现
- 纳入脚本无法完成的跨文件检查：项目级与用户级 CLAUDE.md 之间的矛盾与冗余
不应做：
- 在应用 settings.json 变更前跳过 diff
- 在 /context 输出存在时估算 MCP token 成本
- 重新扫描脚本已覆盖的文件
- 不结合上下文就盲目信任预过滤标记
- 在未先展示 diff 的情况下自动应用修复
- 报告以分数开头
输出
默认模式：聊天内的 Markdown 内联报告。 长审计或重复审查：若用户要求保存，写入 .artifacts/context-audit/YYYY-MM-DD-report.md。
scripts/audit.py 的审计 JSON 是临时的，除非用户要求否则不保存。位于 .claude/.audit-baseline.json 的基线文件是唯一的持久化产物，由 scripts/baseline.py 写入，用于跨运行追踪漂移。
错误处理
- 未提供 /context 输出：继续仅基于文件的审计，估算值以 ~ 前缀标记
- 无 ~/.claude/settings.json：跳过用户作用域检查，并在报告中说明
- 无项目 .claude/：进行仅文件审计，并注明无法扫描 commands、agents、hooks
- 任何位置都无 CLAUDE.md：报告「未检测到项目规则」，不扣分
- audit.py 因文件格式错误崩溃：报告是哪个文件出错，继续处理其余部分
- --compare 时缺少基线文件：指示用户先运行 --save
- 用户在一次询问后拒绝运行 /context：不要循环追问，继续进行仅文件审计