如果你用过 AI 编程助手(Claude、Cursor、Copilot)生成前端页面,大概率经历过这种对话:
"帮我做一个登录页面,要好看一点" → AI 给你一个朴素的蓝白配色页面
"不对,我想要高级感,像 Notion 那样" → AI 改了一下间距和字体,但还是差点意思
"算了,你照着 Stripe 官网来吧" → AI 依然凭印象生成,效果参差不齐
问题不在 AI 不够聪明,而在于「你没有给它一份精确的设计说明书」。
这就是 「DESIGN.md」 —— 一种专门写给 AI 看的设计规范文件。今天这篇文章,我会讲清楚它是什么、怎么用,以及怎么「一句话就让 AI 生成大厂级别的 UI」。
为什么你描述的"好看",AI 永远听不懂?
AI 确实"见过"这些大厂网站,但它只有模糊的印象,没有「精确的设计规范」。
就像你让一个画家"画一幅毕加索风格的画"——如果不给他看毕加索的作品集和创作手法,他只能凭印象去猜。
看看这个对比就明白了:
「自然语言的设计描述太模糊了」。你需要把模糊的设计意图,变成精确的设计规范。
DESIGN.md 是什么?
「DESIGN.md」 是由 Google Stitch 团队提出的一种"AI 可读的设计系统文档"格式。
说白了,它就是一个用 Markdown 写的设计规范文件,「专门给 AI 看的」。
如果你做前端开发,肯定知道这两个文件:
「README.md」:告诉人类这个项目是什么 「AGENTS.md」:告诉 AI 怎么构建项目(技术栈、编码规范)
「DESIGN.md 是第三块拼图」——告诉 AI 项目应该「长什么样」。
| 「DESIGN.md」 | 「AI」 | 「长什么样」 |
当你告诉 AI "按照 DESIGN.md 构建一个登录页面",它就能读取:
精确的品牌色值( #c96442而不是"橙色")字体层级(标题 Serif 64px,正文 Sans 16px) 组件样式(按钮圆角 12px,阴影用 ring-based shadow) 间距规范(基于 8px 的间距系统)
「效果立竿见影」——我之前做一个落地页,反复调了四五轮都不满意。后来放了一个 DESIGN.md 进去,一次生成就有八九成还原度,体感差别很大。
60+ 大厂设计规范随便用:awesome-design-md
手动分析一个品牌的设计系统——提取配色、字体、间距、组件样式——工作量不小。
好消息是有人已经做了这件事。
「VoltAgent」 团队的开源项目 awesome-design-md,系统分析了 「60+ 个知名品牌」的设计系统,全部转化为标准 DESIGN.md 文件。
配套网站 「getdesign.md」 支持在线预览(亮色/暗色模式)和一键获取。
一个 DESIGN.md 文件里到底有什么?
拿 Claude 的 DESIGN.md 举个例子。一个标准文件包含 「9 个核心部分」,我挑几个最关键的说:
视觉主题:用自然语言定义"氛围"
❝Claude's interface is a literary salon reimagined — warm, unhurried, and quietly intellectual. The entire experience is built on a parchment-toned canvas (#f5f4ed).
❞
这段话告诉 AI:Claude 的设计是"温暖的、书卷气的",不是冷冰冰的科技感。「AI 会真的按这个氛围去选择配色和排版」。
色彩板:每个颜色都有"角色"
- **Anthropic Near Black** (#141413): 主要文本- **Terracotta Brand** (#c96442): 品牌色,主 CTA 按钮- **Parchment** (#f5f4ed): 主背景——温暖的奶油色不是给 AI 一个"橙色",而是告诉它:#c96442 这个颜色叫 Terracotta,「专门用在主按钮上」。
组件样式:精确到像素
**Brand Terracotta Button**- Background: #c96442- Text: #faf9f5- Radius: 8–12px- Shadow: ring-based (0px 0px 0px 1px #c96442)Do's and Don'ts:防止 AI 踩坑
这部分我觉得特别实用——直接告诉 AI 「什么不能做」, 比如:
其他部分(排版规则、间距系统、响应式行为、AI 提示指南)结构类似,都是「精确到具体数值」的规范定义。这里就不逐个展开了,感兴趣的直接去 GitHub 上看原文件,比我转述更直观。
更省心的方式:brand-ui-builder Skill
看到这里你可能想:每次都要手动下载 DESIGN.md、放到项目里、再提示 AI 去读取……有没有更省心的?
有。我写了一个 「brand-ui-builder Skill」,把整个流程自动化了。
你只需要说一句话: "帮我做一个 「Claude 风格」 的登录页面"
Skill 会「自动激活」,引导你获取对应品牌的 DESIGN.md,然后 AI 严格按设计规范生成代码。
「不需要记命令,说出品牌名就够了。」
甚至支持混搭——"整体布局参考 Notion,配色用 Stripe 的渐变效果",Skill 会分别获取两个品牌的规范然后融合。
跟手动操作的对比:
「Skill 的核心价值是:把"会用 DESIGN.md"的门槛降到零。」
什么场景适合用?
AI 辅助开发的下一步:把"好设计"变成 AI 能读懂的语言
以前,"好看的设计"是设计师脑子里的东西——开发者看着 Figma 标注一点点还原。
现在通过 DESIGN.md,设计规范被结构化、文档化,「AI 能直接读取、理解、执行」。
我个人感受最深的一点是:自从用了 DESIGN.md,跟 AI 协作生成前端页面的效率至少翻了一倍。以前要反复调样式的时间,现在基本一次到位。
这不只是一个工具的进步,而是「人机协作方式在 UI 层面的一次跃迁」。当 AI 能准确理解什么是好设计,我们就能把精力放在创意和业务逻辑上,而不是纠结于像素级还原。
「你在用 AI 做前端的时候,有没有遇到过"怎么描述都不对"的时候?」
评论区聊聊你的体验,看看大家都踩了哪些坑。
如果需要 「brand-ui-builder Skill」,评论留言,直接发你。
❝觉得有用的话,「点赞👍 + 在看👀 + 收藏⭐」 一键三连,下次找起来方便,也能让更多人看到。
❞
夜雨聆风