CLAUDE.md 进阶维护

CLAUDE.md 不是越长越好。要定期清理过时规则、拆出 Skill、避免临时需求污染长期记忆,让项目记忆保持准确、简短、可执行。

教程基准:Claude Code v2.1.224(当前最新版,核验于 2026-08-07) · 内容更新:2026-08-07

团队工作流

CLAUDE.md 是项目长期记忆,不是聊天记录仓库。写进去的内容会影响后续任务,所以要定期维护。

什么应该留在 CLAUDE.md

内容是否适合
项目目录结构适合
启动、构建、测试方式适合
团队固定约定适合
不要修改的目录适合
本次临时需求不适合
某次 Bug 的排查过程不适合
过期脚本和旧命令不适合

维护检查模板

请只读审查当前 CLAUDE.md。

请检查:
1. 是否有过时内容。
2. 是否有临时任务信息。
3. 是否有太长、太泛的规则。
4. 是否有应该拆成 Skill 的重复流程。
5. 是否有密钥、内部地址或隐私风险。
6. 给出修改建议,不要直接写文件。

什么时候更新

不要把 CLAUDE.md 当许愿池

这些写法看起来有用,实际会降低质量:

它们太空泛,不能指导 CC 行动。更好的写法是:

修改前先说明影响文件;涉及权限、数据库、配置时必须先只读分析;修改后输出已验证项和未验证项。

规则越具体,越能真正约束行为。

更新频率建议

场景建议
个人小项目重要规则变化时更新
团队项目每次流程或目录变化后更新
快速迭代期每周或每个里程碑复查
发布前检查启动、构建、验收规则是否准确

什么时候删除

常见变坏方式

问题表现处理
太长CC 抓不住重点精简成规则和事实
太旧命令、目录已经不存在删除或更新
太临时写了某次任务细节移到交接总结
太空泛“代码要优雅”改成可执行检查
太重复多处表达同一规则合并

CLAUDE.md 太长怎么办

请帮我精简 CLAUDE.md。

要求:
1. 保留长期有效的项目事实。
2. 删除临时任务记录。
3. 删除重复规则。
4. 把可复用流程建议拆到 Skill。
5. 把安全拦截建议拆到 Hook。
6. 输出精简方案,先不要修改文件。

和 Skill、Hook 怎么分工

内容放哪里
项目事实CLAUDE.md
反复执行的流程Skill
自动提醒或拦截Hook
外部资料来源MCP
当前一次任务普通对话

维护时先做差异审查

不要直接让 CC 重写 CLAUDE.md。先让它比较“当前文件”和“项目现状”:

请对照当前项目,只读审查 CLAUDE.md 和真实项目是否一致。

输出:
1. 准确且应该保留的内容。
2. 已过时的内容和证据。
3. 太泛、不可执行的内容。
4. 建议拆到 Skill 或 Hook 的内容。
5. 不确定、需要人工确认的内容。

先审查,再修改,维护会稳很多。

更新后的验收

请验收 CLAUDE.md 更新。

请确认:
1. 没有写入密钥或隐私。
2. 没有临时任务污染长期记忆。
3. 规则简短可执行。
4. 启动、构建、测试信息仍然准确。
5. 是否需要同步 Skill 或 Hook。

维护记录怎么写

请为这次 CLAUDE.md 维护生成记录。

请说明:
1. 删除了什么过期内容。
2. 新增了什么长期规则。
3. 哪些内容建议拆到 Skill。
4. 哪些内容建议拆到 Hook。
5. 是否还有需要团队确认的规则。

把维护变成可审查的 diff

维护 CLAUDE.md 时一次只处理一类问题:删除过期命令、收紧模糊规则、迁移重复流程,三类不要混在一次大改里。修改前后分别记录文件行数和关键规则,让团队能从 diff 看出为什么删、为什么留。

如果规则只针对少数目录,把它迁移到 .claude/rules/ 并设置路径范围;如果是 Claude 在本机发现的排障经验,先留在 auto memory,确认对团队普遍有效后再提升为项目规则。这样能减少每次会话无条件加载的内容,也避免个人经验过早变成团队约束。

维护完成后用两个相反案例验证:一个应该触发规则,一个不应该触发规则。只有两者都符合预期,才能说明规则边界写清楚了。

验收结果