Vercel 实验的结果是什么？
Vercel 用同一份考卷，让两种给 AI 提供最新知识的方式对决。一种是 Skill，即需要时才取用的专业手册合集；另一种是 AGENTS.md，即项目文件夹里始终摊开的一张文本。题目故意出得很难，只用模型训练截止之后才出现的新功能。
分数说明了一切。什么支持都没有的裸考 53 分，给了 Skill 却让它自便，还是 53 分，明确要求必须用，79 分，而 AGENTS.md 得了 100 分，构建、检查、测试全部满分。精巧的方式输给了朴拙的方式。
Skill 为什么输了？
第一，AI 不去翻手册。明知手册存在，十次里约有六次直接略过。它知道手册在那儿，却凭旧的记忆知识去做，于是出错。
第二，Skill 过于敏感。仅仅调换语序，‘先看手册’与‘先看项目再看手册’，分数就大幅波动。这意味着若不把指示下得极其精确，它随时可能跑偏。
AGENTS.md 为什么赢了？
原因出人意料地简单：它根本不让 AI 做选择。Skill 让 AI 每一刻都要纠结现在要不要取用，而纠结的那个点正是失误爆发之处。AGENTS.md 已经摆在眼前，就不必去纠结要不要看、何时看、按什么顺序看。
让它选择就会错，不让它选择就不会错。我们以为加上更聪明的工具就会更好，可工具越聪明，AI 越会在权衡用不用时失手。不如把信息始终摊在眼前。
那么 Skill 什么时候用？
Skill 并没有死。对于你在选定时刻主动发起的大活儿，比如把整个项目迁移到新版本、或者重构整体结构，Skill 正合适。
总之，不是二选一。把日常的基础知识用 AGENTS.md 始终摊开，把特殊的重活按需用 Skill 唤起，这种分工才是答案。
在实务中如何应用？
在项目最上层文件夹建一个 AGENTS.md，不要长篇大论，只像目录一样记下核心要点。Vercel 实际把文档从 40k 压到 8k，砍掉 80%，分数依然是 100。只留提纲而非全文，反而更清爽。
然后在文档最上方务必加上这一句：先看这份文档再判断，别用记住的知识。AI 总想凭旧记忆做事，而这一句正好把它挡住。拉开 100 分与 53 分差距的，就是这一行。