你是否曾为反复向AI工具描述“按钮该用什么颜色、字体、圆角?”而疲惫不堪?DESIGN.md 正是 Google Labs 推出的开源解决方案——它不是UI框架,也不是设计工具,而是一份能让AI编码助手真正理解品牌视觉语言的“人机共读设计说明书”。通过一份结构清晰的 Markdown 文件,它同时满足设计师的表达需求与AI模型的解析能力,把抽象的设计决策(比如“为什么主色是深墨黑而非纯黑?”)转化为可执行的代码指令。
核心功能
- 双模态设计描述:前言区(YAML)提供机器可读的设计令牌(如
colors.primary: "#1A1C1E"),正文区(Markdown)用自然语言阐述设计哲学(如“深墨黑象征印刷级庄重感”),兼顾精准性与语义深度 - 跨Agent通用协议:不绑定特定大模型或开发平台,任何支持文件解析的AI编码助手(如Cursor、GitHub Copilot、自研Agent)均可直接加载并遵循其中规范生成一致UI
- 设计系统持久化:告别散落在Figma评论、Notion文档或口头沟通中的设计约定,将整套视觉规范固化为单个
DESIGN.md文件,随项目代码一同版本管理、协同更新 - 语义化Token分层:支持按语义组织设计值(如
typography.h1而非font-size-32),让AI理解“这是标题样式”,而非仅复制像素值,提升生成结果的合理性 - 轻量零依赖:纯文本格式,无需安装插件、构建工具或运行时环境,开箱即用,Git友好,Diff清晰,设计师和工程师都能直接编辑
- 渐进式采用友好:可从单个颜色变量开始定义,逐步扩展至动效、暗色模式、响应式断点等完整体系,降低团队落地门槛
适合哪些人用
前端工程师:快速将设计系统注入AI辅助开发流程,减少手动查色值、翻Figma、重复写CSS的耗时;UI/UX设计师:用自己熟悉的语言(中文/英文)撰写设计 rationale,确保AI生成界面不偏离品牌调性;AI应用开发者:为自研编码Agent提供标准化设计输入接口,提升UI生成质量稳定性;中小团队技术负责人:用一份轻量文件统一设计交付物与前端实现标准,缓解设计-开发协作断层。
快速上手
无需安装!只需在项目根目录新建一个 DESIGN.md 文件,按示例结构编写即可。例如:
第一部分写YAML前言(用三个短横线 --- 包裹),定义颜色、字体、间距等数值;第二部分写Markdown正文,用标题和段落说明每个设计选择背后的业务目标与用户体验考量。保存后,将该文件路径告知你的AI编码工具(如在Cursor中设置“Design Context File”),Agent便会优先依据此文件生成符合品牌规范的代码。官方提供多个行业模板(新闻站、SaaS后台、创意工作室等),可直接复用修改。
项目信息
google-labs-code/design.md
GitHub
A format specification for describing a visual identity to coding agents. DESIGN.md gives agents a persistent, structured understanding of a design sy
编程语言:TypeScript|Star 数:6345|开源协议:Apache-2.0|GitHub 项目地址
这不仅是Google Labs的前沿探索,更是人机协同设计范式的务实突破——它不替代设计师,而是让设计师的智慧真正“可计算、可传承、可规模化”。


