GitHub 5.8 万 Star,DESIGN.md 凭什么爆火?

31 阅读6分钟

前言

"让 AI 写个页面,结果首页用蓝色、详情页变绿色、设置页又成了黑白风……"

这大概是每个用 AI 编程的开发者都经历过的噩梦。AI 生成代码很强,但生成出来的 UI 风格每次都不一样,拼在一起简直像"设计界的弗兰肯斯坦"。

2026 年 3 月,Google Labs 的 Stitch 项目提出了一个简洁到令人拍大腿的方案:用一个 Markdown 文件,把设计规则"喂"给 AI。

这个文件就叫 DESIGN.md

今天这篇文章,我会带你搞清楚:DESIGN.md 到底是什么、为什么突然爆火、怎么在 Claude Code 里用起来、以及围绕它已经长出了哪些工具和生态。


一、DESIGN.md 到底是什么

一句话:DESIGN.md 是一个用 Markdown 格式编写的设计规范文件,AI 编码工具读取它之后,就能按照统一的风格生成 UI。

它里面包含什么?大致是这些东西:

  • 🎨 颜色体系(主色、辅色、背景色、状态色)
  • 🔤 字体规范(字体族、字号层级、字重)
  • 📐 间距规则(padding、margin、栅格系统)
  • 🧩 组件规范(按钮样式、卡片风格、表单布局)
  • 🖼️ 阴影、圆角、动效等视觉参数

本质上,它就是把设计师脑中的"设计系统",翻译成了 AI 能读懂的纯文本


二、Google Stitch — 这一切的起点

DESIGN.md 的概念来自 Google Labs 的 Stitch 项目。

Stitch 是一个 AI 原生的设计工具,你可以用自然语言描述需求,它直接生成高保真 UI。2026 年 3 月的重大更新中,Stitch 引入了 DESIGN.md 机制:

用户可以上传一份 DESIGN.md 文件,Stitch 在生成 UI 之前会先读取这份文件,确保所有产出都遵循同一套设计规则。

这解决了一个核心痛点:

没有 DESIGN.md有 DESIGN.md
每次生成的 UI 风格随机所有 UI 风格统一
需要反复手动调样式AI 自动遵守设计约束
多人协作时风格混乱团队共享一份规范文件

Google Stitch 官方地址: stitch.withgoogle.com/

Google 官方博客介绍: blog.google/innovation-…


三、为什么突然爆火

DESIGN.md 爆火的背景,是整个 AI 编程圈正在经历一场"从能用→到好用"的升级。

核心逻辑很简单:

AI 编程工具都有自己的规则入口文件:

  • CLAUDE.md → Claude Code 的行为规则
  • AGENTS.md → Codex 等 Agent 工具的行为规则

它们解决的是"AI 怎么写代码"的问题。

DESIGN.md 解决的是另一个维度:"AI 生成的 UI 长什么样"。

两个维度配齐,AI 编程就能从"玩具级"进化到"产品级":

  • 规则文件(CLAUDE.md 等)→ 控制代码质量和行为
  • 设计文件(DESIGN.md)→ 控制 UI 视觉风格

GitHub 上 VoltAgent 团队维护的 awesome-design-md 仓库,收录了 55+ 套仿照知名品牌(Stripe、Vercel 等)的设计系统文件,10 天破 3.5 万 star,如今已突破 5.8 万,直接引爆了这个概念。

awesome-design-md 仓库地址: github.com/VoltAgent/a…


四、designmd.ai — 围绕 DESIGN.md 出现的第一个生态平台

designmd.ai/ 是目前最活跃的 DESIGN.md 工具平台。

它做了三件事:

1️⃣ 设计系统社区

收录了 100+ 套免费设计系统,按风格标签分类(dark、minimal、saas、fintech 等),可以直接浏览和下载。

2️⃣ CLI 工具

安装方式:

npm install -g designmd

核心命令:

# 搜索设计系统
designmd search "dark fintech"

# 按标签筛选
designmd search --tag minimal --tag saas

# 下载到项目根目录
designmd download shafius/neon-fintech

# 上传你自己的设计系统
designmd upload ./DESIGN.md --name "My Kit" --tags dark,saas

3️⃣ MCP Server

designmd.ai 还提供了 MCP(Model Context Protocol)服务,可以直接集成到 Claude Code 中。

安装后,你可以直接用自然语言对 Claude Code 说:

  • "搜一个暗色风格的 fintech 设计系统"
  • "下载 Neon Fintech 设计系统并保存为 DESIGN.md"
  • "帮我上传当前的 DESIGN.md 到社区"

CLI 和 MCP 的区别: CLI 是命令行工具,只在需要时调用,零 token 消耗;MCP 是常驻服务,每次对话都会占用上下文窗口。如果你的项目 token 预算紧张,推荐用 CLI。

designmd.ai 官方地址: designmd.ai/

designmd.ai CLI 文档: designmd.ai/cli

designmd.ai MCP 文档: designmd.ai/mcp


五、怎么在 Claude Code 里用起来

方式一:直接下载 DESIGN.md 文件(最简单)

  1. 去 designmd.ai 或 awesome-design-md 仓库,找一个你喜欢的设计系统
  2. 下载 DESIGN.md 文件,放到项目根目录
  3. 在 CLAUDE.md 中加一句提示:
# Design System
Use the @DESIGN.md file and style my app accordingly.

4. 正常使用 Claude Code,AI 会自动读取 DESIGN.md 并遵循设计规范

项目目录结构长这样:

my-project/
├── CLAUDE.md        ← AI 行为配置
├── DESIGN.md        ← 设计系统规范(新加入)
├── README.md
├── package.json
└── src/

方式二:通过 CLI 动态获取

  1. 安装 CLI:npm install -g designmd
  2. 配置 API Key(免费申请):
export DESIGNMD_API_KEY=dk_your-key-here

3. 在项目的 CLAUDE.md 中添加:

# Design System
Use the `designmd` CLI to search and download design systems from designmd.ai.
Run `designmd --help` for available commands.

之后你可以直接对 Claude Code 说"帮我找一个极简风格的 SaaS 设计系统",它会自动调用 CLI 帮你搜索和下载。

关于 Skill 安装

DESIGN.md 不是 Claude Code 的 Skill。它不需要通过 /skill 安装,本质就是一个 Markdown 文件。你只需要:

  1. 把文件放到项目根目录
  2. 在 CLAUDE.md 中提示 AI 去读它

就这么简单。CLI 工具(designmd)是通过 npm 全局安装的,也不走 Skill 机制。


六、同类工具和竞品一览

围绕 DESIGN.md 这个概念,目前已经形成了一个小生态:

工具/项目类型说明
Google Stitch官方平台DESIGN.md 概念的提出者,AI 原生设计工具
designmd.ai社区平台 + CLI + MCP100+ 免费设计系统,支持搜索/下载/上传
awesome-design-mdGitHub 开源合集VoltAgent 维护,55+ 套品牌设计系统文件
v0 by VercelAI UI 构建器可以消费 DESIGN.md 文件生成统一风格 UI
LovableAI 全栈构建器兼容 awesome-design-md 生态
Figma Make AIFigma 内置 AI竞品路线,闭源设计系统方案
UX PilotAI 设计助手提供自己的设计系统方案
ReplitAI 应用构建器2026 最佳 AI 应用构建器之一

核心区别:

DESIGN.md 生态走的是开源开放路线 —— 一个 Markdown 文件,任何 AI 工具都能读。而 Figma、UX Pilot 等走的是闭源平台路线,设计系统被锁定在自家工具里。

这就像是:

  • DESIGN.md = 开放标准(类似 HTTP)
  • 闭源平台 = 私有协议(类似各家的 RPC)

七、我的建议:要不要上 DESIGN.md

如果你符合以下任一场景,强烈建议试试:

  • ✅ 用 Claude Code 做前端项目,觉得 UI 风格不统一
  • ✅ 团队协作,需要 AI 生成符合品牌规范的 UI
  • ✅ 经常用 AI 做 side project,想要专业级的视觉输出
  • ✅ 做产品原型,需要快速出高保真设计

上手成本极低 —— 下载一个 DESIGN.md 文件扔进项目就行,5 分钟搞定。


总结

DESIGN.md 的爆火不是偶然。它精准地解决了一个 AI 编程的核心痛点:UI 不一致

整个趋势可以用一句话概括:

把设计系统从设计师的 Figma 文件,变成 AI 能读懂的纯文本。

Google 提出了标准,社区做出了工具,AI 编码工具争相接入。这不是某个公司的产品,而是一整个新范式。

如果你已经在用 Claude Code 做前端,今天就可以去 designmd.ai 下载一份 DESIGN.md 试试 —— 你会发现,AI 生成的 UI 终于"像出自同一个设计师之手了"。


欢迎关注公众号 FishTech Notes,一块交流使用心得!