CLAUDE.md 过时了吗：/doctor prompt-audit 怎么体检提示词
模型默认真换了（例如 Opus 5.5），仓库里的 CLAUDE.md、Skills、agents、斜杠命令 却还按半年前的习惯写——轻则啰嗦无效，重则互相打架。CLI 2.1.283 加了 /doctor prompt-audit（也可用 /checkup prompt-audit）：专门扫这些配置里面向旧模型的提示写法。
遥测变量被忽略时看 /status 与 doctor 的另一条线，见 遥测为什么没亮。本文只谈 prompt-audit。
它扫什么
公开说明：审计对象包括——
- CLAUDE.md（及同类项目指令文件）
- skills
- agents
- commands
目标不是「语法对不对」，而是：写给旧模型时代的 prompting 习惯是否该改。同版本还改进了报告排序——过期路径、过期命令、互相矛盾的指令文件会靠前；文档里已写明的 thinking 类关键词会被保留，避免误杀。
什么时候值得跑
优先跑：
- 刚把默认模型切到新一代（或组织锁定了新 id）。
- 仓库 CLAUDE.md / Skills 堆了很久，多人轮流加规则。
- 感觉 Claude「不听规则」或反复做互相打架的事——先排除配置过时。
- 合并一波社区 Skills / 插件后，想快速体检一遍。
不必每小时跑：它是配置体检，不是每次对话的必经步骤。大改配置或升级大版本后跑一次，性价比最高。
怎么用（交互里）
升级到 2.1.283+ 后，在会话中：
text
/doctor prompt-audit或：
text
/checkup prompt-audit看报告时建议顺序：
- 矛盾指令——两处 CLAUDE.md / skill 要求相反，先消歧。
- 失效路径与命令——指向已删除脚本、旧 CLI 子命令的条目。
- 旧模型口吻——过度「一步步想」「必须用某旧模型才懂」之类，按新模型能力重写。
- 再动手删改；改完可再跑一遍确认噪音下降。
具体文案与条目以你本机输出为准；changelog 保证的是「有这条审计能力 + 报告优先级改进」。
和普通 doctor / 遥测排查的区别
| 能力 | 大致用途 |
|---|---|
claude doctor / 启动提示里的遥测提示 | 环境、被忽略的遥测变量等 |
/doctor prompt-audit | 提示与配置文件是否像写给旧模型 |
/status | 当前会话状态快照 |
别指望 prompt-audit 帮你修 MCP 连不上或 400——那是网络 / 网关 / 历史会话问题。
实践建议
- 升级后第一周：对主仓库跑一次，把「矛盾 + 死路径」清掉。
- Skills 准入：新 skill 合入前过一遍 audit，少给后人留坑。
- 别盲删 thinking 词：报告已尽量保留文档认可的写法；以「冲突与失效」为先。
- 和 Hooks / MCP 分工：审计改的是「说明书」；运行时拦截仍靠 Hooks 与权限策略。
模型会换，仓库里的说明书也会锈。/doctor prompt-audit 把「锈在哪」摊开，比凭感觉删 CLAUDE.md 更安全。