AYi@AYi_AInotes
39AI 编辑部评分,满分 100
2026-08-04 14:10· 1天前
AI 导读

Vercel Next.js团队基于约60B tokens的实践,总结出一份仅含8条规则的AGENTS.md,核心是让AI编程智能体避免过度设计、优先复用成熟方案。规则包括不保留向后兼容、选最简单实现、先跑通最小端到端版本、优先用成熟库等。作者警告该规则仅适合side projects,生产环境需谨慎,曾因“不保留向后兼容”险些删除生产数据库表。

简直就是省Token焚决!!!

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

60B tokens什么概念?大概六位数美元。

这8条规则的本质就一句话:让你的AI编程Agent别像个实习生什么都想自己造,要像个干了十年的老油条一样写代码。

直接上规则:

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

就这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:

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

Marcos HernanzAfter doing ~60B tokens, this is my full AGENTS.md

来源:AYi · x.com

AYi · @AYi_AInotes · X·2026-08-04 14:10·1天前
AI 导读

Vercel Next.js团队基于约60B tokens的实践,总结出一份仅含8条规则的AGENTS.md,核心是让AI编程智能体避免过度设计、优先复用成熟方案。规则包括不保留向后兼容、选最简单实现、先跑通最小端到端版本、优先用成熟库等。作者警告该规则仅适合side projects,生产环境需谨慎,曾因“不保留向后兼容”险些删除生产数据库表。

简直就是省Token焚决!!!

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

60B tokens什么概念?大概六位数美元。

这8条规则的本质就一句话:让你的AI编程Agent别像个实习生什么都想自己造,要像个干了十年的老油条一样写代码。

直接上规则:

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

就这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:

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

Marcos HernanzAfter doing ~60B tokens, this is my full AGENTS.md

来源:AYi· x.com