要更好地理解 DESIGN.md 这个技术,你可以将其核心定位为:“专门给 AI 编码助手(AI Coding Agents)阅读的‘UI/UX 说明书’或‘设计系统提示词(System Prompt)’”。
以下是帮助你深度、立体理解这项技术的 5 个关键维度:
1. 理解它的核心痛点:为什么需要它?
在 DESIGN.md 出现之前,如果你对 AI 说“帮我写一个设置页面”,AI 会基于它在互联网上学习到的通用代码逻辑来生成 UI,这往往会导致:
- 风格不一致:这次生成的按钮是圆角的,下次生成的变方了;页面 A 的蓝色和页面 B 的蓝色有色差。
- 缺乏品牌感:生成出来的界面通常非常“大众脸(Generic)”,没有企业的品牌规范。
- 难以约束:将复杂的 Figma 导出文件或厚重的 JSON 规范喂给 AI,往往因为上下文过大、格式不匹配导致 AI 理解偏差。
DESIGN.md 正是为了解决这个问题而诞生的。它给 AI 建立了一个持久的、结构化的上下文,让 AI 在写每一行 UI 代码前,都先翻看这本“规范指南”。
2. 掌握它的“双层结构”(核心机制)
DESIGN.md 的精妙之处在于它采用了人类与 AI 共同最擅长阅读的 Markdown + YAML 混合格式。它的文件结构分为两个图层:
- YAML Front Matter(机器可读层):
- 位于文件顶部,由
---包裹。 - 内容:精密的“设计令牌(Design Tokens)”,如具体的颜色 Hex 码、字体大小缩放(Typography)、圆角大小(Rounded)、间距(Spacing)等。
- 作用:让 AI 精准掌握规范的客观数值,防止 AI 在写 CSS 时“瞎编”参数。

