DESIGN.md 正在重新定义 AI 和设计的关系。
今年3月,Google 为其 AI 辅助设计工具 Stitch 带来了一次重大更新。这次更新本身或许不算重磅新闻,但其中蕴含着一个极易被忽略的功能点却可能改变游戏规则:DESIGN.md。
它只是一个纯 Markdown 文件,作用是用文本描述一整套设计系统。
令人玩味的是,在此后的一周内,知名设计工具 Figma 的股价下跌了 12%。科技媒体 Fast Company 的报道标题更是直指核心:「Figma takes a hit as Google doubles down on vibe design」。
然而,真正让这个概念引爆社区的,并非 Google 官方,而是开源社区的自发力量。一个名为 Awesome Design MD 的项目在 GitHub 上迅速斩获 超过 9300 颗星 —— 有人通过逆向工程,将 55 家知名公司的完整设计系统打包成了标准化的 DESIGN.md 文件,免费开放使用。

Apple、Stripe、Airbnb、Spotify、Linear、Notion、Vercel、Figma、SpaceX、BMW…… 你能叫得出名字的顶尖科技与设计公司,其设计风格基本都被收录在内。
现在,如果你想让你的 AI 助手生成 Stripe 那种经典风格的界面,只需要三步:从仓库里复制对应的 .md 文件,粘贴到你项目的根目录,然后告诉 AI “参照这个规范来设计”。就这么简单。
. . . . .
AI 生成 UI 的同质化困局
时至今日,让 AI 辅助编写代码已不再是新鲜事。无论是 Claude Code、Cursor 还是 GitHub Copilot,它们都能轻松地根据一句自然语言描述生成一个功能完整的页面。
但你有没有发现一个普遍存在的痛点?
AI 生成的所有 UI,看起来都差不多。
灰色背景、蓝色按钮、卡片式布局、Tailwind 的默认配色方案…… 每次让 AI 写前端代码,产出的界面都像是同一套 Bootstrap 模板的不同变体。功能或许能跑,但绝对称不上“精致”或“独特”。更关键的是,这些界面与你现有产品的设计风格往往格格不入。
问题的根源不在于 AI 写不好 CSS,而在于它不理解“什么是好看”——更确切地说,它不知道“什么是符合你品牌调性的好看”。
你当然可以在每次对话的开头,不厌其烦地描述一遍设计规范:“主色调用 #533afd,标题字重设为 300,圆角统一为 4-8px,避免使用药丸形状的按钮……” 但这不仅效率低下,而且你几乎必然会遗漏某些细节,导致不同页面间的风格出现割裂。
这就像在一个没有建立统一设计规范的团队里开发产品——每个页面都依赖开发者个人的理解,最终成品看起来像是七拼八凑出来的。
AI 缺的并非生成 UI 的能力,而是一个持久的、结构化的、可供它持续参考的设计规范。
. . . . .
DESIGN.md:用文本文件编码一整套设计系统
Google Stitch 给出的解决方案简单到近乎“粗暴”:将整个设计系统写成一个 Markdown 文件。
没有复杂的 Figma 导出流程,没有需要解析的 JSON Schema,也没有专门的设计 Token 配置工具。就只是一个后缀为 .md 的纯文本文件,用自然语言结合清晰的结构化数据,完整描述一个品牌的视觉规范。
一份标准的 DESIGN.md 文件通常包含 9 个核心章节:
- Visual Theme & Atmosphere:描述整体视觉氛围。是极简冷淡还是丰富热情?是强调技术感还是传递温暖感?界面元素是紧凑密集还是宽松留白?
- Color Palette & Roles:定义包含 30+ 颜色的完整色板,并为每个颜色赋予明确的语义角色。不仅仅是提供一堆 HEX 色值,而是明确告诉 AI:这个颜色专用于主按钮(CTA),那个颜色用于错误提示,另一个颜色仅限装饰性渐变使用。
- Typography Rules:详尽的字体排版规则,定义 16 种或更多的文本样式。涵盖字体族、字重、字号、行高、字间距等,精确到每一个像素。
- Component Stylings:核心组件(按钮、卡片、输入框、导航栏等)的具体样式规范,包括不同状态(悬停、激活、禁用)下的视觉变化。
- Layout Principles:间距系统(通常基于 8px 的基数)、网格定义以及整体的留白哲学。
- Depth & Elevation:阴影的层级系统和不同“海拔”表面的视觉效果定义。
- Do‘s and Don’ts:设计红线。明确列出哪些设计做法是绝对禁止的。
- Responsive Behavior:响应式断点定义、触控目标的最小尺寸、折叠区域的应对策略。
- Agent Prompt Guide:为 AI 助手准备的即用型提示词,指导它如何最有效地利用此文件。
以 Stripe 的设计系统为例
我们来看看逆向工程后的 Stripe DESIGN.md 文件里具体包含了什么。
色板的定义精确到了语义层面:
主色调 Stripe Purple #533afd——用于所有核心交互和行动号召元素。
标题色深海军蓝 #061b31——专用于各级标题。
正文字体色石板灰 #64748d——用于段落正文。
背景为纯白 #ffffff,沉浸式内容区块使用品牌深色 #1c1e54。

字体方面,Stripe 使用其自定义的 sohne-var 可变字体。一个关键细节是:标题的字重仅为 300——这是一种极轻的字重,意在传达自信而非通过粗体来张扬。标题的字间距(letter-spacing)设置为 -1.4px(在 56px 字号下),字号越大,字符排列越紧凑。对于金融数据,则启用 "tnum" 特性使用等宽表格数字。
阴影系统是 Stripe 的标志性设计之一——双层阴影,使用蓝调色 rgba(50,50,93,0.25) 混合中性黑 rgba(0,0,0,0.1),创造出一种带有“空气感”的层次,而非冰冷的技术投影感。
圆角被严格限制在 4-8px 的范围内,明确禁止使用全高的“药丸”形状。
这正是 Stripe 的界面总能保持高度一致性的原因——并非因为设计师拥有超凡的直觉,而是因为所有规则都被定义得极其清晰。 现在,这套规则以 Markdown 文本的形式存在,任何 AI 助手都能准确读取并严格执行。
. . . . .
Awesome Design MD:开箱即用的设计系统资源库
如果说 DESIGN.md 是一个开创性的概念,那么 Awesome Design MD 则是将概念变为可立即执行方案的终极资源库。
这个在 GitHub 上火爆的开源项目做了一件极具社区精神的事:通过逆向工程,为 55 家全球知名的科技公司创建了标准的 DESIGN.md 文件,并且为每个设计系统都配套提供了亮色与暗色主题的预览 HTML 页面。
55 家公司被系统地划分为 6 大类别:
- AI / 机器学习(12 家):Claude、Cohere、ElevenLabs、Minimax、Mistral AI 等。
- 开发者工具(14 家):Cursor、Linear、Raycast、Sentry、Vercel、Supabase 等。
- 基础设施 / 云服务(6 家):Stripe、MongoDB、HashiCorp、ClickHouse 等。
- 设计 / 生产力工具(10 家):Figma、Notion、Airtable、Framer、Miro 等。
- 金融科技(4 家):Coinbase、Revolut、Kraken、Wise。
- 企业 / 消费级产品(8 家):Apple、Airbnb、Spotify、NVIDIA、BMW、SpaceX 等。
使用方法极其简单:
- 在仓库中找到你心仪的设计风格(例如 Stripe 或 Linear),下载其 DESIGN.md 文件。
- 将该文件放置在你项目的根目录下。
- 指示你的 AI 助手(如 Claude Code)“参考项目根目录下的 DESIGN.md 文件规范来生成 UI”。
至此,一切就绪。
在社交媒体上,相关讨论热度空前。用户 @heynavtoor 的一条推文获得了 超过 3400 次点赞 和数十万浏览量,内容直白有力:“有人逆向工程了 Apple、Spotify、Airbnb 等 30 多家市值超百亿美元公司的设计系统,全部打包成单个文件,免费开源。”

. . . . .

实战:如何在 Claude Code 中使用 DESIGN.md
了解了概念和资源,我们来具体看看如何在实际开发中应用。
基础使用流程
假设你正在开发一个 SaaS 工具,希望其界面拥有 Linear 那种极简、专业的设计感。
第一步,从 Awesome Design MD 仓库下载 Linear 的 DESIGN.md 文件,放入你的项目根目录。
my-project/
├── DESIGN.md ← 这里是 Linear 的设计系统文件
├── CLAUDE.md ← Claude Code 的项目配置文件
├── src/
└── ... ← 其他项目文件
第二步,在你的 CLAUDE.md 文件(这是 Claude Code 用于读取项目级配置的文件)中添加明确的指令:
## 设计规范
始终参考并遵循项目根目录下的 DESIGN.md 文件。
生成任何 UI 代码时,必须只使用 DESIGN.md 中定义的颜色、字体、间距及组件样式。
禁止使用 Tailwind 默认色板或自行创建样式。
第三步,像往常一样与 Claude Code 对话。例如,你可以直接说:“帮我创建一个项目任务看板页面。” Claude Code 会自动读取根目录的 DESIGN.md,并生成完全符合 Linear 设计规范的代码。
进阶使用技巧
对于有经验的开发者,可以采取更保险的双重策略——将 DESIGN.md 中的设计 Token 转换为 tailwind.config.js 配置文件。
你可以直接要求 AI 完成这项工作:
请根据项目根目录下的 DESIGN.md 文件,生成一份 tailwind.config.js 配置文件。
要求:将文件中定义的所有颜色、字体、间距、圆角等值,映射为 Tailwind 的自定义 Token。
这样一来,即使 AI 在生成代码时没有显式引用 DESIGN.md 中的描述,Tailwind 框架本身的配置也会强制它使用你定义好的品牌色和间距系统,实现了双保险。
社区里还有更激进的玩法:有人从 Dribbble 的设计稿截图出发,先让 AI 分析截图并自动生成一份初步的 DESIGN.md,然后再用这份文件指导 AI 生成完整的页面代码。实现了从视觉灵感,到设计系统,再到可运行代码的 AI 全链路辅助。
. . . . .
深层趋势:Markdown 正成为 AI 的“操作系统”
如果你关注近期 AI 与开发融合的趋势,会发现一个有趣的共性。
无论是此前引发讨论的“LLM Wiki”概念,还是现在的 DESIGN.md,其核心逻辑如出一辙:用一个结构化的 Markdown 文件,赋予 AI 持久、可执行的“记忆”与“规则”。
- LLM Wiki 的核心是
SCHEMA.md 文件,它告诉 AI 如何像一个知识库管理员一样去组织和维护信息。
- DESIGN.md 的核心也是一个
.md 文件,它告诉 AI 如何像一个遵循品牌手册的设计师一样去生成界面。
它们的共同点在于:
- 用 Markdown 为 AI 提供持久化上下文:无需在每次对话中重复描述复杂规则,一次编写,长期生效。
- 支持人机协同迭代规则:你不必一开始就写出完美的规范,可以在使用过程中与 AI 协作,共同完善 DESIGN.md。
- LLM 的原生友好格式:Markdown 是大型语言模型训练数据中最常见的格式之一,也是它们最擅长理解和生成的格式。无需格式转换,几乎没有信息损耗。
这预示着一个更大的趋势:一切可以被结构化的人类知识与规则,都在被编码成 Markdown 文件,成为 AI 可读取、可执行的“说明书”。
知识管理有了 SCHEMA.md,设计系统有了 DESIGN.md,代码规范有了 CLAUDE.md 或 .cursor/rules。接下来呢?产品需求文档(PRD.md)、业务逻辑流(BUSINESS.md)、安全合规策略(SECURITY.md)?
我们正在迈入一个与 AI 协作的新范式:不再是每次都从零开始、用自然语言向 AI 解释任务,而是将复杂的规则和知识编码成文件,让 AI 具备持久、稳定、可靠的执行依据。
. . . . .
Figma 会被取代吗?设计工具的未来
这可能是许多设计师和开发者当前最关心的问题。
先说结论:DESIGN.md 的目标并非取代 Figma,而是极大地压缩了从“设计概念”到“可用代码”之间的路径。
传统的协作流程通常是:设计师在 Figma 中完成高保真视觉稿 → 手动导出标注或使用插件生成样式代码 → 开发者解读这些标注并手工编写 CSS → 后续因理解偏差或需求变动而反复沟通修改。在这个过程中,信息丢失、风格走样几乎是家常便饭。
而 DESIGN.md 倡导的流程是:将设计规范直接编码成机器(AI)可读的文本 → AI 直接读取并生成严格遵守规范的代码 → 从源头上保证一致性。
Figma 的核心价值在于其强大的可视化协作、精细化界面设计、原型交互以及团队评审功能。它服务于设计创意和团队协同的早期与中期阶段。而像 Stitch 这类工具及 DESIGN.md 理念,则聚焦于快速原型构建和从设计到代码的无损、高效传递。
然而,真正的挑战或许并非来自 Google Stitch 这个产品本身,而在于 DESIGN.md 这个理念是跨平台、工具无关的。它可以与 Claude Code、Cursor、GitHub Copilot 乃至任何能读取项目文件的 AI 编码助手配合使用。一旦设计系统能够以纯文本这种通用格式被完美表达,传统设计工具所带来的生态锁定效应就会被显著削弱。
正如海外设计媒体 DesignWhine 的评论:DESIGN.md 可能才是此次 Stitch 更新中“真正的战略公告”——其长远影响甚至可能超过 AI 画布等新功能本身。
. . . . .
结语
让我们回到最初的问题:AI 辅助编写 UI 的瓶颈,从来不是“能否实现功能”,而是“能否产出具有品牌辨识度的高质量设计”。
DESIGN.md 首次为 AI 提供了一个关于“美”与“一致性”的明确标准答案——这个答案不依赖 AI 模糊的“审美直觉”,而是建立在清晰、可验证的规则之上。
主色、辅色、语义色分别是什么,用在何处。标题和正文的字体、字重、间距如何设定。阴影的层数与色调,圆角的大小范围。哪些做法值得鼓励,哪些雷区必须避免。
当所有这些被凝结成一个 Markdown 文件,AI 就能像一位经验丰富、严格遵守设计规范的前端工程师一样工作——既不会天马行空地擅自发挥,也不会粗心大意地遗漏关键细节。
而 Awesome Design MD 这类社区项目,更是将实践门槛降到了极致:不擅长撰写详细的设计规范?没关系,全球 55 家顶级公司的现成设计系统已为你“逆向”完毕。复制、粘贴,即可立刻体验顶级设计团队的风格。
在云栈社区,我们持续关注此类重塑开发工作流的前沿工具与理念。一个简单的 Markdown 文件,或许正在悄然重构 AI 与数字产品设计之间的关系。 这不仅是效率的提升,更是协作范式的一次进化。