Vercel团队烧了60B Tokens总结的8条AGENTS.md铁律,让AI写出能跑的代码
你有没有这种感觉——让 AI 帮你写代码,它写得比你还多?
不是写得快,是写得多。三个依赖、五个抽象层、两百行返工——标准库十行就能搞定的事,它给你绕出一个迷宫。
这不是 AI 的问题,是你没给它立规矩。
烧了 60B Tokens 换来的 8 条铁律
Vercel Next.js 团队有个工程师,跑了约 60B tokens(大概烧了六位数美元),总结出一份 AGENTS.md,核心就 8 条规则。本质就一句话:让你的 AI 编程 Agent 别像个实习生什么都想自己造,要像个干了十年的老油条一样写代码。
这 8 条规则最近在一篇推文里被扒出来,疯传了 2400 多赞。
直接上规则
1. 不保留向后兼容。 过时的直接删,别加兼容层、别写 migration、别留 fallback。
2. 选能满足当前需求的最简单实现。 不要预防性抽象,不要多此一举的配置层。
3. 系统分层长,先跑通最小端到端版本。 绝不为了未完成的复杂度拆掉能跑的东西。
4. 组件保持模块化,关注点分离。
5. 优先用成熟的、有人维护的库。 没有明确理由别自己重写。
6. 先翻项目里已有的依赖能做什么,再考虑加新包。 别上来就假设库里没有。
7. 架构决策往长了做。 不接受”先这样以后再换”的临时方案。
8. 先看成熟产品怎么解决同一个问题,用已验证的模式,别从零发明。
为什么能省 Token?
AI 写代码最大的浪费不是写错,是重复写多。它引三个依赖写五个抽象层来解决一个标准库十行就能搞定的事,你让它改,它再给你写两百行。
这 8 条规则就是在它动笔之前先把它摁住:能不写的不写,能复用的复用,能简单的别复杂。 代码短了,返工少了,Token 自然就省了。
警告:生产环境慎用!
作者自己加了个非常重要的警告——“不保留向后兼容”那条曾经让 Agent 差点删了生产数据库的表,差点丢了 2000 美元的数据。
所以如果你在做 side project、做内部工具、做原型,把这 8 条抄进 AGENTS.md,你会感觉 AI 写出来的代码突然像个人了。
如果你在生产环境用,把第一条和第七条之间的度自己把握好,别让 AI 把你库表删了。
怎么用?
把上面 8 条规则复制到项目根目录的 AGENTS.md 里,Cursor、Claude Code、Codex、Windsurf 全都会自动读取。
配合之前推荐过的 Ponytail 插件(运行时强制检查),从源头约束加运行时检查一起用,效果拔群。
省 Token 的方法有很多种,换便宜模型是一种,写好 prompt 是一种,但最有效的,是在项目根目录放一个文件,告诉 AI:
别给我整花活,写最少的能跑的代码。
GitHub:https://github.com/vercel/next.js
评论区
登录后可评论。