CLAUDE.md 进阶维护

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

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

什么应该留在 CLAUDE.md

维护检查模板

请只读审查当前 CLAUDE.md。

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

什么时候更新

• 项目启动方式变了。
• 目录结构变了。
• 团队验收规则变了。
• 某条规则反复被纠正。
• 新增了固定检查方式。
• 某个流程稳定到可以沉淀。

不要把 CLAUDE.md 当许愿池

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

• “代码要优雅。”
• “尽量不要出错。”
• “所有任务都要完美完成。”
• “遇到问题自己解决。”
• “按最佳实践实现。”

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

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

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

更新频率建议

什么时候删除

• 规则已经过期。
• 某个目录不再存在。
• 某个命令不能用了。
• 内容只是某次临时任务。
• 写得太泛，无法指导行为。

常见变坏方式

CLAUDE.md 太长怎么办

请帮我精简 CLAUDE.md。

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

和 Skill、Hook 怎么分工

维护时先做差异审查

不要直接让 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. 是否还有需要团队确认的规则。

验收结果

• CLAUDE.md 只保留长期有效信息。
• 过期规则被清理。
• 重复流程拆到 Skill。
• 安全提醒拆到 Hook。
• 项目记忆保持短、准、可执行。