Anthropic官方CLAUDE.md最佳实践：6大模块让AI编程效率提升10倍
Boris Cherny（Anthropic Claude Code创造者）分享的内部最佳实践，整理成CLAUDE.md文件，6大核心模块：工作流编排、子Agent策略、自我改进循环、完成前验证、追求优雅、自主bug修复。
两大误区
| 误区 | 真相 |
|---|
| AI越强越不需要规范 | 需求描述不清晰、规范不明确，效果大打折扣 |
| 把AI当工具不是合作者 | 没有规则和反馈机制，AI永远是"听话的工具" |
六大核心模块
1. 工作流编排（Workflow Orchestration）
| 规则 | 说明 |
|---|
| 非平凡任务进入规划模式 | 3个以上步骤或涉及架构决策 |
| 出问题立即停止重新规划 | 不要强行推进 |
| 验证步骤也用规划模式 | 不只在构建时用 |
| 前期写详细规范 | 减少歧义 |
2. 子Agent策略（Subagent Strategy）
| 规则 | 说明 |
|---|
| 大量使用子Agent | 保持主上下文窗口整洁 |
| 卸载研究、探索、并行分析 | 给子Agent做 |
| 复杂问题投入更多算力 | 通过子Agent实现 |
| 每个子Agent专注一个任务 | 精准执行 |
3. 自我改进循环（Self-Improvement Loop）
| 规则 | 说明 |
|---|
用户纠正后更新tasks/lessons.md | 记录模式 |
| 为自己写规则防止重复犯错 | 自我约束 |
| 无情迭代经验教训 | 直到错误率下降 |
| 会话开始时审查经验教训 | 避免重蹈覆辙 |
4. 完成前验证（Verification Before Done）
| 规则 | 说明 |
|---|
| 没证明有效不标记完成 | 先验证再标记 |
| 对比主分支和修改的行为差异 | 确认变更正确 |
| 问自己：高级工程师会批准吗？ | 高标准 |
| 运行测试、检查日志、证明正确性 | 实证驱动 |
5. 追求优雅（Demand Elegance，平衡）
| 规则 | 说明 |
|---|
| 非平凡修改先问：有更优雅的方式吗？ | 暂停思考 |
| 修复方案像补丁就重新实现 | 基于所知实现优雅方案 |
| 简单明显的修复跳过这一步 | 不要过度设计 |
| 展示工作前挑战自己的方案 | 自我审视 |
6. 自主bug修复（Autonomous Bug Fixing）
| 规则 | 说明 |
|---|
| 收到bug报告直接修复 | 不寻求手把手指导 |
| 指出日志、错误、失败测试然后解决 | 自主定位 |
| 用户无需上下文切换 | 无缝体验 |
| 直接修复失败的CI测试 | 不用被告知怎么做 |
任务管理
| 步骤 | 说明 |
|---|
| 1 | 先规划：写入tasks/todo.md，包含可勾选项 |
| 2 | 验证计划：开始实现前先确认 |
| 3 | 跟踪进度：逐步标记完成项 |
| 4 | 解释变更：每步提供高层级摘要 |
| 5 | 记录结果：在tasks/todo.md中添加审查部分 |
| 6 | 捕获经验：纠正后更新tasks/lessons.md |
核心原则
| 原则 | 说明 |
|---|
| 简单优先 | 每个变更尽可能简单，只影响必要代码 |
| 不偷懒 | 找根本原因，不做临时修复，高级开发标准 |
| 最小影响 | 变更只触及必要部分，避免引入bug |
总结
一句话总结：6大模块（规划+子Agent+自我改进+验证+优雅+自主修复）+任务管理+3条核心原则=Anthropic官方CLAUDE.md最佳实践，越用错误率越低。
