Wink Pings

Google 团队开始给 AI 写说明书了,三个 .md 文件管住 coding agent

Annie Wang 和 Tilde Thurium 在 Google Cloud Tech 的视频里拆了三个 markdown 规格文件:DESIGN.md、AGENTS.md、SKILL.md。它们不是给人看的文档,是给 agent 看的。

Google Cloud Tech 放了一段视频,Annie Wang 和 Tilde Thurium 讲团队怎么把 agentic coding 的实践铺开。核心不是某个新模型,而是三个 markdown 文件:

  • DESIGN.md
  • AGENTS.md
  • SKILL.md

按视频里的说法,这些规格文件定义你的 agent 应该怎么思考、怎么设计、怎么在你的代码库里执行任务。

原帖链接:goo.gle/4f0Q5H1

下面这条回复把 AGENTS.md 说得很直白:

wait so AGENTS.md is basically a readme for the robot, love that

给机器人看的 README。这个类比成立。人类进新项目先翻 README 搞清楚怎么跑、代码在哪、有什么坑;agent 进代码库,读的就是 AGENTS.md。

更有意思的是 DESIGN.md。Fernando Ruiz 的回复点到了痛处:

DESIGN.md is the one I'm most curious about. Spacing rules and component decisions usually live in a Figma file the agent never sees, so writing them down for it makes a lot of sense.

间距规则、组件选型这些东西,平时躺在 Figma 里,agent 根本看不到。你让它改个按钮,它不知道这个项目 8px 网格是铁律,也不知道哪种场景该用哪种卡片。把这些写进 DESIGN.md,等于把设计师脑子里的隐性约束摊开成 agent 能读的文本。

三个文件分工大致是这样:DESIGN.md 管视觉和组件决策,AGENTS.md 管项目约定和协作方式,SKILL.md 管具体任务的执行步骤。都用 markdown,纯文本,丢进版本库,跟代码一起走。

这件事值得留意的点在于方向。过去几年大家忙着给模型喂更多上下文、更长窗口,现在开始有人认真写「给 agent 看的文档」。文档的读者变了,写法也得变:给人看的可以省略前提,给 agent 看的必须把前提写死。

至于这套东西能不能真的 scale 到整个团队,视频里没给结论。但至少它承认了一个现实:agent 不会自动知道你的项目长什么样,你得告诉它。

发布时间: 2026-11-19 01:29