Vercel 60B Tokens 实测:AGENTS.md 八条铁律

Vercel Next.js 团队的老哥,烧了大概 60B tokens,最后就总结出一份 AGENTS.md,核心就 8 条规则。

60B tokens 什么概念?换算成钱,差不多六位数美元。

这 8 条规则说白了就一句话:别让你的 AI 编程助手像个刚入行的实习生,什么都想自己造一遍;要让它像干了十年的老油条一样,写最少的、最能用的代码。

直接上规则:

  1. 不保留向后兼容。过时的东西直接删,别加兼容层、别写迁移脚本、别留备用回退方案。
  2. 选能满足当前需求的最简单实现。别搞预防性抽象,也别加那些“万一以后用得上”的配置层。
  3. 系统要分层生长。先跑通一个最小的端到端版本,能跑了再往上加东西。绝对不要因为未来可能出现的复杂度,就去拆掉一个当前能正常工作的东西。
  4. 组件保持模块化,关注点要分离清楚。
  5. 优先用成熟的、有人维护的第三方库。没有特别硬的理由,别自己重写。
  6. 动手之前,先翻翻项目里已经有的依赖能做什么,再决定要不要加新包或自己写。别想当然地觉得库里肯定没有。
  7. 架构决策要往长远做。不接受“先凑合用,以后再说”这种临时方案。
  8. 先看成熟产品是怎么解决同一个问题的,用已经被验证过的模式,别从零开始发明。

就这 8 条,丢进你项目根目录的

AGENTS.md

文件里,Cursor、Claude Code、Codex、Windsurf 这些工具都会自动读取。

为什么它能省 token?因为 AI 写代码最大的浪费,其实不是写错,而是反复写多余的东西。

它给你引三个依赖、搭五个抽象层,解决一个标准库十行就能搞定的事;你让它改,它又给你补两百行。这 8 条规则就是在它动笔之前把它摁住:能不写的不写,能复用的复用,能简单的别搞复杂。

代码短了,返工少了,token 自然就省了。

之前我推荐过的 Ponytail 那个插件,干的是同一件事,只不过它是在运行时强制检查;而这个是在

AGENTS.md

里从源头约束。两个一起用,效果拔群。

但作者自己加了个非常实在的警告:

这套规则只适合 side projects,生产环境慎用。

他亲口说过,“不保留向后兼容”那条,曾经让 Agent 差点删了生产数据库的表,差点损失 2000 美元的数据。生产环境你得自己改,至少把第一条删掉,或者改得温和一点。

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

如果你要用在生产环境,自己把握好第一条和第七条之间的度,别让 AI 把你的库表删了。

省 token 的方法有很多——换便宜模型是一种,写好 prompt 是一种,但最有效的,是在项目根目录放一个文件,告诉 AI:

别整花活,写最少的、能跑的代码。

.md

.js

#AGENTS#Vercel#Next#AI编程#提示词#Cursor#ClaudeCode#省Token

关联工程母题系统与实测说明:

本篇「Vercel 60B Tokens 实测:AGENTS.md 八条铁律」由 整理收录于 qilaidav 工程知识库,围绕 企业协同与三库底座 (Spec/Prompt/Memory) 的生产环境架构设计、链路排障与确定性验证展开沉淀。完整系统模块、部署边界与技术规格请查阅方案主页:→ 查看 企业协同与三库底座 (Spec/Prompt/Memory) 详情(架构诊断与定制交流:Telegram @BD8888 · hello@qilaidav.com · GitHub @qilaidev)。

免责声明与评测方法:本文所涉开源工具、模型基准与工程配置均基于实测环境与公开技术资料整理,仅供系统架构研发参考,不构成任何商业背书或投资建议。

— qilai · 摘自 Telegram 频道 @AIKB8