DESIGN.md 是什么?

它是 Google Labs 提出的一个文件格式规范,专门用来给 AI Coding Agents 描述项目的视觉设计系统。
简单来说,它就是一个放在项目根目录里的 Markdown 文件,作用有点像 README.md,但它主要不是给人看的,而是给 AI 看的。
它解决什么问题?
每次让 AI(比如 Cursor、Claude Code、Copilot 等)生成 UI 代码的时候,它都会随意乱用颜色、字体、间距,最后做出来的东西完全不符合品牌风格。
或者每开一个新项目,你都得重新告诉 AI:
“主色是 #1A73E8”
“字体用 Inter”
“按钮圆角 12px”
“卡片阴影不要太重”……
DESIGN.md 本质上就是在解决这个问题。
它的作用,是给 AI 一个长期、结构化、可复用的设计系统认知,让它后续生成代码时自动遵循你的设计规范,而不是每次都靠猜。
它包含哪些内容?
一个标准的 DESIGN.md 文件通常描述
| 内容 | 示例 |
| 调色板 | 主色、辅助色、语义色(错误/成功) |
| 字体系统 | 字体家族、字号层级、行高 |
| 间距规则 | 基础单位、padding/margin 规范 |
| 组件风格 | 按钮、卡片、输入框的视觉规则 |
| 设计原则 | 品牌调性、风格描述 |
你只需要把 DESIGN.md 放到项目根目录里,支持它的 AI 工具(比如 Cursor、Claude Code)就会自动读取并参考里面的规则。
而且它还能在不同项目之间复用,你不用每次重新定义一套设计语言。
当然,这本身只是一个规范模板,并不意味着你必须严格照着写。
重点其实只有一个:
让 AI 能够“清晰理解”你的设计体系。
你完全可以用自己的方式描述,只要表达足够清楚即可。
目前比较常见的几种生成方式:
方式 A:给 AI 看设计稿, 截图或描述
把 Figma 截图、品牌色板、UI 页面截图发给 Claude 或 ChatGPT,然后用类似这样的 Prompt:
“请根据以下设计内容,生成标准的 DESIGN.md 文件。
格式要求:
1. 顶部用 YAML front matter 定义所有设计 token(颜色、字体、间距、圆角、阴影)
2. 正文用 Markdown 说明每个 token 的使用场景和禁止事项
3. 包含 Components 章节,描述主要组件的视觉规则
设计内容如下:[粘贴你的描述 / 上传截图]
这个方式其实非常实用,我最近主要也是这么做的。
方式 B:从 Figma Variables 导出
如果你本身就在用 Figma Variables / Design Tokens:
可以直接导出 JSON
再让 AI 自动转换成 DESIGN.md
这样效率会更高。
方式 C:Google Stitch 自动生成
Google Stitch 本身支持直接导出 DESIGN.md。
如果你已经在用 Stitch 做项目,那这个应该是最省事的方式了,一键就能生成。
方式 D:直接使用现成的 DESIGN.md 模板
现在 GitHub 上已经有不少现成的 DESIGN.md 模板了,包括很多独立开发者网站也会分享。

很多人会专门去研究一些设计非常优秀的网站,然后把它们的设计体系整理成 Markdown 格式,最终变成一份完整的 DESIGN.md。
这样你其实就不用从零开始写。
你可以直接把这些模板下载下来,丢进自己的项目里,再交给 Claude Code、Codex、Cursor 这种 AI Agent。
比如直接一句:
“按照这个 DESIGN.md 的风格,帮我生成一个 SaaS 官网”
AI 基本就能直接开始按那个视觉体系输出页面了。
后面你自己再补充品牌内容、文案、图片、业务逻辑即可。
That’s it.
来源公众号: 独立站与SEO艺术(ID:gh_5c4e7feba94e)一点心得与分享,希望对你有用
本文由 @独立站与SEO艺术 原创发布于奇赞平台,未经许可,禁止转载、采集。
该文观点仅代表作者本人,奇赞平台仅提供信息存储空间服务。

