跑一遍 /doctor prompt-audit,给仓库的 CLAUDE.md 做体检
字

字节笔记本

2026年11月13日 · 约 3 分钟读完

跑一遍 /doctor prompt-audit,给仓库的 CLAUDE.md 做体检

赞助API中转
¥120

Anthropic Claude Code 团队成员 Lydia Hallie 11 月 12 日发了一条简短的提醒:在你的 Claude Code 仓库里运行 /doctor prompt-audit——如果你还没有跑过的话。个人主页署名「Claude Code @AnthropicAI」的团队成员专门点名推荐,这条命令值得展开讲讲。

Claude Code 官网页首图

它审什么

/doctor prompt-audit(别名 /checkup prompt-audit)是官方 changelog 里明确记录的内置命令:审计你的 CLAUDE.md 文件、技能、agents 与命令中「为旧模型写的提示词模式」。后续版本迭代又加强过它——过期路径、过期命令、互相矛盾的指令文件会排在报告最前面,而 Claude Code 官方文档认可的相关关键词会被保留,不误杀。

「为旧模型写的模式」是关键词。仓库的记忆文件是长期累积的:某个模型阶段需要绕行的写法、当时必要的强调、彼时正确的路径,会一直留在 CLAUDE.md 和 AGENTS.md 里。模型更新之后,这些陈旧指令轻则占用上下文,重则与新行为直接冲突——比如两份指令文件对同一件事给出相反的要求,agent 每次都要自行裁决。

怎么用

用法三步:把 Claude Code 更新到 2.1.283 或更新版本(claude update);打开项目;输入 /doctor prompt-audit 或 /checkup prompt-audit。命令会读取仓库里的记忆文件与配置,输出审计报告,按问题严重度排序。

配套动作还有一个:官方同批给 claude-api 技能也加了 prompt-audit 子命令,用于审计直接面向模型 API 的 prompt 与工具描述——两类审计对象(仓库记忆、API 提示词)各归各的入口。

anthropics/claude-code 仓库页

为什么值得当成例行体检

CLAUDE.md 膨胀是社区长期讨论的问题,第三方审计工具已有不少;官方把这件事做成一条内置命令,意味着清理旧提示词模式从「个人习惯」变成「产品功能」。团队成员在社交平台上点名提醒,可以读作官方对记忆文件卫生的表态——这是本文的解读,不是官方口径。

对维护多个仓库的团队来说,更实际的做法是把它排进例行流程:版本升级后跑一遍,大改 CLAUDE.md 之后跑一遍。

数据快照

帖子互动为发稿时快照:100 回复、73 转帖、1,903 收藏。收藏数接近转帖数的二十六倍——命令类帖子的典型分布:先存下来,回工位就跑。

相关文章

分享: