CLAUDE-md-12条规则摘要

本文介绍如何通过在项目根目录设置 CLAUDE.md 纯文本说明书，来规范 AI 助手（如 Claude）写代码的行为。从最初的 4 条基础规则扩充到 12 条后，实测能把 Claude 的代码错误率从 41% 大幅降到 3% 以下。

原始 4 条基础规则（解决单次写代码的错误）

1. 写代码前先思考：厘清所有模糊地带，不盲目猜测，遇到不清楚立刻发问。
2. 简单至上：用最少的代码解决当下问题，严拒过度工程化或多余的抽象层。
3. 手术式修改：精准改动相关范围，绝不顺手改善或重构旁边没坏的代码。
4. 目标导向执行：把任务转化为可验证的具体目标（如让测试通过），建立检查点。

新增 8 条扩充规则（解决复杂 AI 代理协作的盲点）

5. 只让 AI 做需要判断力的事：用于分类、摘要、起草等；确定性任务（如状态码判断、重试）交由纯代码执行。
6. 强制设置词元预算上限：规范任务（如 4k tokens）与对话（如 30k tokens）的上限，快耗尽时主动总结并重开对话，避免陷入死循环。
7. 冲突要摊开讲，禁止混合写法：面对代码库新旧写法冲突时，选一种并说明理由，绝不「平均融合」写出四不像的代码。
8. 写代码前先读懂周边代码：修改前必须先读取文件输出、调用者函数及共用工具，完全理解结构后再动手。
9. 测试要验证「为什么」，不只是「有没有」：测试必须真实反映业务逻辑的运作，而非为了亮绿灯而把返回值写死。
10. 多步骤任务每完成一步就要回报：长时间开发需在每步完成后回报进度；若丢失上下文，必须立刻中止并重新厘清。
11. 遵从现有惯例，不要偷偷引入新风格：完全配合既有的命名规则（如 snake_case）或既有架构，禁止擅自引入新框架。
12. 主动揭露错误，禁止隐性失败：有疑问或无法完整验证时必须明确回报异常，绝不允许隐瞒不确定性。