看完我的AGENTS.md-你将看到我和不说人话且over-engineering的模型搏斗的这一生
一句话概括
腾讯技术工程用一份带有夸张惩罚语气的 AGENTS.md 展示如何把 AI Coding 的沟通偏差、过度设计和不可靠执行写成强制规则,核心要求包括快速失败、真实验证、明确边界、禁止假测试与禁止无依据的 Git 回退。
实践内容
将协作约定写成可执行契约
文章要求模型遵守明确的语言、方案和行为约束:避免无意义的对比和总结,不堆砌无关搜索结果,不使用单字缩写或黑话,不把多个未经验证的方案包装成阶段计划,并在描述操作时使用完整的动作与对象。规则的价值不在语气,而在于将作者对“什么算可接受交付”的判断放进仓库上下文。
Fast-fail 与真实验证
AGENTS.md 要求依赖直接导入、错误在发生处暴露,不用宽泛的 try-except 或 fallback 掩盖问题;实现和测试必须运行真实代码,不能用 mock、假数据或只为通过测试的绕过方式。每次改动后都要实施、运行、测试和迭代,不能把验证责任推给用户。
工具和仓库边界
规则明确禁止擅自进入计划模式、禁止使用 Git 回滚代码、禁止读写 /tmp,并要求网页链接先完整阅读再执行。它还提醒代理尊重用户在中途撤回或修改的内容:后续操作应重新读取当前文件状态,不得把已经删掉的部分自动加回。文章以强烈的讽刺口吻说明,越多“看似帮助”的额外动作,越容易偏离真实任务。
摘录
AGENTS.md 中的规则被定义为强制性约束,临时操作、一次性命令以及“出于好意、为了进度”的例外都不自动豁免。这个设定把平时依赖口头提醒的协作习惯,转换成每次 Agent 运行都能加载的仓库级行为契约。
文章反复要求实现、测试和验证必须使用真实路径,不能用 mock、假的实现或仅为通过测试而绕过问题;代码应当在出错位置快速失败,而不是用捕获异常、fallback 或宽松的替代行为把错误推迟到更远的地方。
当作者删除或修改上一轮新增的内容时,Agent 必须重新读取文件并以当前状态继续,不得根据自己的历史记忆把被删除的段落加回来。这条规则把“用户修改后的工作区才是真实状态”明确成了协作边界。
涉及实体
- Harness-Engineering —— 将规则、工具、验证和状态组织成 Agent 运行时护栏
- Claude-Code —— AGENTS.md/CLAUDE.md 等仓库上下文文件的典型消费方
- Spec-Driven-Development —— 把验收标准和约束前置为可追踪契约
- Prompt评估体系 —— 真实测试、回归与失败暴露为 Prompt 质量提供证据