用途：审计 AI 指令文件的大小、相关性与结构，降低上下文窗口消耗。CLAUDE.md 每次会话都会加载，臃肿会导致 Claude 忽略实际指令；SKILL.md 每次调用都消耗 token，精简两者可降低延迟、成本与指令遵循失败。所有操作限定在项目根目录（$PWD），不修改仓库外文件。
使用时机：CLAUDE.md 过长且 Claude 忽略规则或追问已写明的问题；SKILL.md 超过约 120 行；frontmatter 或章节顺序不标准；多个技能内容重复；AGENTS.md 存在超过 30 行的内联指令块。
工作流（按阶段顺序执行，不适用的可跳过）：
- 盘点与分诊：列出所有 CLAUDE.md、.agents/skills/ 下的 SKILL.md 及 AGENTS.md，记录文件、行数、是否有 frontmatter、是否有规范章节，输出按行数降序的分诊表。
- 审计 CLAUDE.md：逐行用“删除它是否会导致 Claude 犯错”检验。保留猜测不到的 Bash 命令、非默认代码风格、测试说明与运行器、仓库礼仪、项目架构决策、开发环境怪癖、常见陷阱；删除可自行读代码得知的内容、标准语言约定、详细 API 文档（改为链接）、频繁变动的信息、长教程、逐文件描述、显而易见的要求。将领域工作流迁移到技能，用 @path/to/import 拆分大文件，慎用强调，对无例外的关键规则建议改为 hook。
- 降低 SKILL.md token：改为祈使句要点、压缩示例、删除冗余解释与列表空行，目标不超过 120 行，超出则移至 references/ 并加指引，多领域技能拆分为变体参考文件。
- 修复结构与 frontmatter：YAML 中 name 与目录一致（kebab-case）、description 以 “Use when” 开头；章节顺序为 H1 标题 → When to Use → Rules/Instructions → Quick Reference → Validation；删除空章节；全文用祈使语气。
- 跨技能去重：找出重复内容块（超过 5 行相似），移至根 CLAUDE.md、AGENTS.md 或共享技能，重复处改为一行指引用 “See <skill-name> for ...”，并改写重叠 description 使触发条件唯一。
- 抽取臃肿的 AGENTS.md 块：扫描超过 30 行的内联块，新建 .agents/skills/<name>/SKILL.md，原处替换为精简指引与 Quick Reference；如有同步脚本则运行。
输出优化报告，包含各文件修改前后行数、节省总行数、迁移到技能的内容数量。验证要点：每行 CLAUDE.md 通过检验、无 SKILL.md 超过 120 行、每个 SKILL.md 有含 name 与 description 的有效 YAML、无两个技能共享超过 5 行相同内容、AGENTS.md 中无超过 30 行且无技能指引的内联块、领域内容位于技能而非 CLAUDE.md。