大部分人写的 AGENTS.md 都在说「别碰这个」「别改那个」。
Vercel 工程师的版本思路相反——它告诉 AI 怎么思考软件工程。效果?省掉 80% 的无效 token 消耗。
完整模板,直接放到项目根目录:
# AGENTS.md
不要维护向后兼容性。废弃的代码路径直接删,不留兼容层和回退方案。
在满足当前需求的前提下,用最简单的方式实现。别加没必要的抽象和配置项。
渐进式构建。先做出能端到端跑通的最小版本,再在稳定的基础上加功能。
组件模块化。不同职责之间划清边界。
优先用成熟、维护良好的库。不要重新发明轮子,除非有明确理由。
加新依赖之前,先看看已有依赖能不能干这件事。先读文档,别凭感觉下判断。
架构决策要能服务长期。别写那种你知道迟早要重写的临时方案。
设计之前,先研究成熟产品怎么解决同类问题。用被验证过的模式,别从零另搞一套。
这不是限制。这是工程直觉。
给 AI agent 一个导航系统,不是一条狗链。
顯示更多