把工程习惯写成行为约束,是AGENTS.md对AI编程最实际的价值:从Claude Code 2.1.277起,项目里没有CLAUDE.md时它会自动检查并使用AGENTS.md;这份规则文件让“先查同类项目再动手、改前先写测试、改完独立验证、权限最小化”不再靠人反复提醒,而是变成AI每次开工前必读的约束,直接减少返工、越权改动和“测试说通过却不可信”三类问题。
一、把“先调研再动手”固化成流程
检索优先:规则可要求AI遇到不熟悉功能先检索GitHub上维护活跃、许可证明确的同类项目,比较实现思路、依赖和已知问题,再决定是否自己写,避免自信造轮子。
经验编码:把人类工程师“先看边界、常见坑、现成轮子”的习惯写进规则,等于把经验直觉转成AI行为约束,减少一上来就实现导致的返工。
工作流前置:Vibe Coding真正跑得顺的关键不是让AI写得更快,而是让它在正确时机停下来查资料、减少返工。
二、用规格与验收标准防跑偏
六格规格:把含糊需求翻译成目标、输入、不变式、异常、产物、验收六格,生成代码前先写清,能消除大量低级事故。
禁止事项:明确列出禁止联网调用未授权API、禁止引入新依赖、禁止改写原始实验文件等,比“不要删文件”这类软提醒更可执行。
验收断言:把预期结果写成断言,如A=+5.0、B=+10.0,单元测试全失败则根因可定位;规则不是形式文档,而是人机协作的防漂移契约。
三、给权限和回滚留后手
最小权限:真正限制权限比口头叮嘱有效,规则可约束AI只能改指定目录、不能跨样本操作、不能更改输出路径与表头。
自动规则:把人工Code Review发现的问题转成可自动执行的规则,用编译器、框架和静态分析CI硬约束,减少依赖主观判断。
可信闭环:先定义规格再制定计划,先建测试再改代码,修改后独立验证,确认可信再提交,并用Git保留可回滚快照。
本文由AI生成











