为什么需要规则文件
和 AI 协作写代码，最大的成本往往是返工：它噼里啪啦写完一大堆，结果方向偏了、风格不对、还偷偷改了你没让它动的文件。问题通常不在模型，而在你没把「规矩」说清楚。规则文件（Claude 叫 CLAUDE.md，通用叫 AGENTS.md）就是把这些规矩一次性写死、每次自动加载的地方。
我实际沉淀的几条硬规则
- 不明确的需求，先沉淀成文档再写码。让 AI 先出方案/线框，人拍板后再动手，而不是一上来就改文件。
- 重大改动先看可视化预览。前端改动先出线框或截图，确认结构对了再填细节。
- 关键计算必须真实数据重测，禁止「标通过」。收益、盈亏、回测这类数字，拿真实流水跑一遍，不能凭模型「觉得对」。
- 只动该动的。明确文件边界，禁止顺手重构无关模块。
- 结论先行、结构化输出。长回答用表格/清单，少用废话。
文件放哪、怎么生效
规则文件一般放在项目根目录，AI 编码工具启动时会自动读取。层级上可以分：
~/.claude/CLAUDE.md或用户级配置 —— 跨项目永久生效的通用习惯；- 项目根目录的
CLAUDE.md/AGENTS.md—— 团队共享、跟随仓库走； - 子目录里的规则文件 —— 只对那个目录下的任务生效（适合多模块仓库）。
经验：规则文件宁可短而具体，不要长而空泛。每条都应该是「做某件事时，AI 必须/禁止……」的可执行约束，而不是愿景宣言。
一个最小可用模板
# 协作规则
- 需求不清时，先输出方案请我确认，不要直接改代码
- 改文件前说明要改哪些、为什么
- 涉及数字的结论，用真实数据重算，禁止凭空"标通过"
- 回复结论先行，重要结论用清单/表格
- 不重构本次任务之外的代码写好之后，每次新会话 AI 都会自动遵守，不用反复叮嘱——这正是「一次性配置、永久生效」的爽点。