Vercel 团队烧了 600 亿 tokens，总结出 8 条 AI 编程铁律，写进项目就能让代码质量飙升

你有没有这种感觉：AI 帮你写代码，越写越乱，token 烧得离谱，但项目还是一堆 technical debt？

Vercel Next.js 团队烧了约 600 亿 tokens（换算成人民币大概六位数美元），总结出 8 条规则，写成一个 AGENTS.md 文件。核心只有一句话：让你的 AI 编程 Agent 像个干了十年的老油条，别像个实习生什么都想自己造。

这 8 条规则是什么

把下面这些规则复制到你项目根目录的 AGENTS.md 文件里，Cursor、Claude Code、Codex、Windsurf 这些工具会自动读取并遵循：

• 不保留向后兼容。 过时的代码直接删，别加兼容层、别写 migration、别留 fallback。
• 选能满足当前需求的最简单实现。 不要预防性抽象，不要多此一举的配置层。
• 系统分层长。 先跑通一个最小的端到端版本，再往上加东西。绝不为了未完成的复杂度拆掉能跑的东西。
• 组件保持模块化。 关注点分离。
• 优先用成熟的、有人维护的库。 没有明确理由别自己重写。
• 先翻项目里已有的依赖能做什么。 再考虑加新包或自己写。别上来就假设库里没有。
• 架构决策往长了做。 不接受”先这样以后再换”的临时方案。
• 先看成熟产品怎么解决同一个问题。 用已验证的模式，别从零发明。

为什么这能省 token

AI 写代码最大的浪费不是写错，是重复写多。它给你引入三个依赖、写五个抽象层，来解决一个标准库十行就能搞定的事。你让它改，它再给你写两百行。

这 8 条规则就是在它动笔之前先把它摁住：能不写的不写，能复用的复用，能简单的别复杂。代码短了，返工少了，token 自然就省了。

警告：生产环境慎用

作者自己加了个非常重要的提示——”不保留向后兼容”这一条曾经让 Agent 差点删了生产数据库的表，差点丢了 2000 美元的数据。生产环境一定要自己改规则，至少把第一条删掉或改温和点。

如果你在做 side project、做内部工具、做原型，把这 8 条抄进 AGENTS.md，AI 写出来的代码突然就”像个人”了。

总结

Vercel 把 10 余年的 React/Next.js 开发经验打包成了一套 Agent Skills，里面包含 react-best-practices（40+ 条规则，8 个优先级类别），以及 web-design-guidelines（100+ 条规则）。安装方式：

npx add-skill vercel-labs/agent-skills

装完不需要配置，AI 自动检测使用场景。把经验结构化让 AI 能理解并执行，比文档好用太多了。

GitHub：https://github.com/vercel-labs/agent-skills

GitHub: https://github.com/vercel-labs/agent-skills