来源丨经授权转自 逛逛GitHub(ID:ggGithub)
作者丨逛逛
因为训练的偏好,AI 写网页的时候喜欢偷懒,它生成的网页上来就是 Tailwind 默认颜色、Inter 字体。
但是,五年前 Tailwind 创始人将 TailwindUI 中的每个按钮都设为 bg-indigo-500,这导致地球上每个 AI 生成的 UI 也都是靛蓝色的。
这种配色一看就是 AI 写的模板味。

![]()
让它换风格,它就把紫色换成橙色,仅此而已。
但是我们又表达不出很精确专业的指导,只能说高级一些、炫酷一些。
往往这些很模糊、抽象的表达,让 AI 没办法生成真的符合预期的效果。
最近几个月,GitHub 上涌现了一大批设计相关,或者说让 AI 生成的网页更美观的开源项目。
改天搞一个合集,整体聊一聊。
今天看到 Google Labs 出了个开源项目叫 design.md,就是针对这个问题提供了一个规范和方法。
去 GitHub 一看,近 2 万 Star。
01
它到底是个啥
DESIGN.md 是写给 AI Agent 看的设计系统规范文件。
类比一下你可能更清楚。
最近一年大家都在写 CLAUDE.md、AGENTS.md,那是教 AI 怎么写代码,用什么框架、什么命名风格、什么测试规范。
DESIGN.md 是教 AI 怎么写长得对的代码。
它最早是 Google 自家 AI 设计工具 Stitch 内部在用的,让设计师在 Stitch 里调出风格后,AI 能稳定输出符合那种风格的 UI。
2026 年 4 月,Google 把这套规范抽出来开源成了 design.md 这个项目。
和 Awesome Design.md 是啥区别呢?
我之前推荐过一个开源项目,叫做 Awesome Design.md。
它把 Claude、Notion、Apple 这些知名网站的视觉风格,逆向翻译成 DESIGN.md 文件。
已经有 70+ 个真实品牌的样本,可以直接拿来用。
谷歌的 design.md 是定义 DESIGN.md 文件的标准格式:YAML front matter 放机器可读的设计 token,Markdown 正文放人可读的设计理念。
可以理解为 Google 立规矩,VoltAgent 顺着规矩填内容。谷歌的这个告诉你文件该怎么写,VoltAgent 的那个是把各大网站的扒了下来。
02
核心设计
DESIGN.md 文件分两层。
第一层是 YAML front matter,放机器可读的设计 token,颜色十六进制、字号、间距、圆角这些精确值。
第二层是 Markdown 正文,放人可读的设计理念:为什么主色是这个、为什么这个按钮要做成圆角。
这是它最聪明的地方。
AI 既拿到了精确数值可以执行,又理解了设计意图可以判断。下面这段是官方的 Heritage 示例:
---name: Heritagecolors: primary: "#1A1C1E" secondary: "#6C7278" tertiary: "#B8422E" neutral: "#F7F5F2"typography: h1: fontFamily: Public Sans fontSize: 3remrounded: sm: 4px md: 8pxspacing: sm: 8px md: 16px---
建筑极简主义遇上报刊庄重感。UI 呈现高级哑光质感——像高端大报或当代画廊。
色彩系统建立在高对比中性色加单一强调色之上。- **主色(- **次色(- **强调色(- **中性色(
AI 读了这个文件,就会输出一个 Public Sans 字体的深色标题、温暖米色背景、Boston Clay 红色 CTA 按钮的页面。
每个值都有出处,每段意图都有解释。
03
配套 CLI:四条命令够用了
CLI 工具叫 @google/design.md,零配置,npx 直接跑:
npx @google/design.md lint DESIGN.md
校验结果输出 JSON,AI agent 可以直接消费:
```json{ "findings": [ { "severity": "warning",
"path": "components.button-primary", "message": "textColor (#ffffff) on backgroundColor (#1A1C1E) has contrast ratio 15.42:1 — passes WCAG AA." } ], "summary": { "errors": 0, "warnings": 1, "info": 1 }}```
四条命令分别干这几件事:
lint:校验文件,自动跑 8 条规则,比如 broken 引用、缺失主色、WCAG 对比度、孤立 token、章节顺序等diff:对比两个版本的 DESIGN.md,发现 token 级别的回归export:导出 Tailwind 主题配置 / W3C DTCG 标准 token,跟主流设计工具无缝衔接spec:输出规范文档,可以塞进 AI 的 system prompt 里让它完整理解格式不用装包,不用配置文件,开箱即用。
04
最爽的玩法是配合 Stitch

![]()
设计师在 Stitch 里调好一个设计,Stitch 自动从画布生成对应的 DESIGN.md。
把这个文件丢进项目仓库根目录,Claude Code 读它生成 UI,颜色、字体、间距就不会跑偏。
这个其实就是 Google 想给 AI 一个共享的设计语言,让设计师、开发者、agent 三方有一套标准的描述方式。
生态也起来了。
除了官方的 design.md 和 VoltAgent 的范例库,已经有 designkit.sh、getdesign.md 这种第三方聚合站,专门收集和浏览 DESIGN.md 文件。
05
怎么用起来
三步就行了:
touch DESIGN.mdnpx @google/design.md lint DESIGN.md
如果你的项目已经用了 Tailwind,可以一行命令导出主题配置:
npx @google/design.md export--format tailwind DESIGN.md > tailwind.theme.json
配合 Claude Code 的 frontend-design skill 食用更佳。
在 CLAUDE.md 里加一行让它去读项目根目录的 DESIGN.md,它就会把里面的 token 当作生成 UI 的依据。
06
写在最后
用 AI Agent 绕不开一个核心问题:怎么把自己脑子里那个好设计的标准,稳定地传给 AI。
代码层面,AGENTS.md 和 CLAUDE.md 已经给了答案。
设计层面,DESIGN.md 现在补上了这块。当 AI 写代码成为常态,怎么告诉 AI 什么是好设计会变成新的硬技能。
门槛低到一份 Markdown 文件,但效果立竿见影。