什么是 DESIGN.md?
DESIGN.md 是一份写给机器读的设计系统:一个纯文本 markdown 文件,把配色、字体、间距、组件规则写得明确到 AI agent 无需猜测就能套用。这个格式由 Google Stitch 引入,后来作为开放规范发布——今天它早已超出 Stitch,在 Claude Code、Cursor 以及任何能读文本文件的 agent 里都能用。
DESIGN.md 是什么
DESIGN.md 是一个 Markdown 文件,以结构化、机器可读的形式编码一整套设计系统。它把机器可读的设计 token(通常是机器最先读的一段 YAML)与文字章节配在一起,把长相讲清楚——配色、字体、间距、形状、组件、动效——明确到 AI 无需猜测即可套用。
名字沿用了 README.md 的约定:一个纯文本文件,可版本化、可移植,任何工具都能打开。区别在于受众。README 把项目讲给人听;DESIGN.md 把设计讲给机器听——就是那个将把你的幻灯片、网站或产品装进这套风格里的 AI。
你不再用模糊的形容词去 prompt——「做得现代一点、干净一点」——而是把一份 DESIGN.md 放进项目里,agent 把你的精确样式应用到它做的每一样东西上。
格式从哪来:Google Stitch
DESIGN.md 走进主流,是通过 Google Stitch——Google Labs 的 AI 设计工具。Stitch 用一个 design.md 文件充当设计系统的持久记忆:它存下色板、字体和样式规则,让 AI 生成的每一屏都保持一致,而不是随每次 prompt 漂移。
2026 年,Google Labs 把 DESIGN.md 作为开放规范发布,同一个文件从此可以跨工具、跨平台使用,不再被 Stitch 锁定。此后一个围绕这个格式的生态长了起来——Claude Code、Cursor、Codex 这类编码 agent 会从项目根目录读它,现成 DESIGN.md 文件的库也出现了:从 awesome-design-md 这样的社区 GitHub 收藏,到 Curio 这样的精选目录。
这就是这个格式重要的原因:它正在变成设计系统与 AI agent 之间的通用语言。一个文件,写一次,你下一个用的 AI 工具都能懂。
DESIGN.md 里面有什么
元数据在最前:风格的名字、一句话的精髓,以及诸如「浅色还是深色」这样的标志位。这是机器在读其它一切之前先获取的定位。
接着是 token 章节,每一项都以具体的值给出,而非形容词:配色章节(一套命名色板——背景、墨色、强调色——以 <hex> 这样的精确值表示)、字体章节(字体家族、字重,以及以 <px>/rem 表示的字阶)、间距章节(以 <px> 表示的节奏),以及形状、阴影、动效章节(圆角、层级、缓动)。
最后是应用指引:组件逻辑(在这套风格里按钮、卡片、输入框该长什么样)与用法说明(这套风格适合哪儿、不适合哪儿)。正是这套组合,让 AI 从「我知道规则」走到「我把这屏做出来了」——而无需自己编造数值。
Curio 库里的每种风格,都以这个形状的完整文件交付。结构是开放的,任何人都能看清一份 DESIGN.md 是怎么组装的;每种风格的精确 token 值,是付费产品。骨架公开;具体的 <hex> 与 <px>,才是你解锁的东西。
机器可读为什么胜过截图
截图或「感觉」是有损的:AI 必须推断什么才重要,而且每次推断都不同——抄了颜色却漏了间距逻辑,借了字体却没要网格。DESIGN.md 去掉了猜测。数值是明写的,于是 AI 精确套用,每个屏幕都一样。
因为它是一个确定性的文件,它也是一致且可复用的。同一份 DESIGN.md 既管第一张幻灯片,也管第四十张;既管这周的落地页,也管下月的仪表板。这就是「偶然撞到一次的长相」与「可以依赖的系统」之间的区别。
又因为它是纯文本,它天然适配软件团队既有的工作方式:待在仓库里,随 Git 流转,设计系统的每次变更都是一条可 review 的 diff,而不是查无对证的漂移。
AI 怎么使用 DESIGN.md
你以适合自己工具的方式把文件交给 AI:放进项目根目录让编码 agent 自己找到、贴进聊天窗口、发一个分享链接,或通过 MCP 连接让 AI 按需拉取。从那以后,模型读取这些 token 并套用——生成的组件、幻灯片或页面一开始就匹配这套风格,而不是漂向平均值。
因为格式就是普通 Markdown,它不被任何单一助手锁定。无论你的 AI 活在聊天窗口、编程工具还是 agent 流水线里,同一份 DESIGN.md 都能用——规范随工作一起走。
该自己写一份,还是直接挑一份?
当设计系统已经存在且属于你——你的品牌、你产品的长相——就自己写一份 DESIGN.md。编码一次,此后你用的每个 AI 工具都会忠实套用它。
当你想要的是一种成熟风格——包豪斯、瑞士国际主义、某种品牌级的当代长相——又不想自己逆向工程,那就直接挑一份现成的。这正是 DESIGN.md 库存在的意义:Curio 以完整 DESIGN.md 交付数百种真实设计风格,你的 AI 通过 MCP、分享链接或下载,几秒钟就能套上。
常见问题
DESIGN.md 是谁创造的?
这个格式由 Google Stitch(Google Labs 的 AI 设计工具)引入,是 Stitch 存放你的设计系统的文件。Google Labs 后来把 DESIGN.md 作为开放规范发布,让它可以跨工具、跨平台使用——这也是为什么今天 Claude Code、Cursor 这类编码 agent 和 Curio 这样的库都认它。
DESIGN.md 是官方标准吗?
它是 Google Labs 发布的开放规范,而非 W3C 那种正式标准。实践中这点区别不大:格式就是带结构化 token 的普通 Markdown,任何 AI 或工具都能读,不需要专门的解析器或私有文件类型。
DESIGN.md 只能配 Google Stitch 用吗?
不是。格式起于 Stitch,但因为规范开放、文件就是普通 Markdown,任何能读文本的 AI 都能用:Claude Code、Cursor、Codex、聊天助手,或你自己的 agent 流水线。把文件放进项目,或用链接递过去,agent 就会套用。
能免费看到真实的 token 值吗?
DESIGN.md 的结构是开放的——你能看清它长什么样、包含哪些章节。在 Curio,每种风格的精确数值(确切的颜色、尺寸、字体栈)是付费产品,因为正是这些数值让风格可以被直接使用;免费档也含一批免费风格。
这跟设计 token 或 Figma 文件有什么不同?
设计 token 和 Figma 文件是为设计工具与流水线而建的。DESIGN.md 是为 AI 一次读完而建的:token 与应用指引合在一起,装在一个模型可直接消费的纯文本文件里——而不是一种必须先导出的、被工具锁定的格式。