google-labs-code/design.md

解决的问题

编码代理在生成 UI 时往往难以保持一致的视觉身份。DESIGN.md 为描述设计系统提供了一种标准化的持久格式，使 AI 代理既能理解精确的数值（Token），也能理解视觉品牌背后的逻辑（文本）。

工作原理

该系统使用双层文件格式：

1. YAML Front Matter：包含颜色、排版、间距和组件特定属性（例如按钮颜色）的机器可读设计 Token。
2. Markdown Body：包含组织在特定章节（例如概述、颜色、排版）中的人类可读设计原理和指南。

它包含一个 CLI 工具，用于检查这些文件的结构正确性、检查 WCAG 对比度、检测损坏的 Token 引用，并将 Token 导出为 Tailwind CSS (v3 和 v4) 或 W3C Design Tokens Format 等格式。

适用对象

希望确保生成的 UI 与特定品牌身份和设计系统保持一致的、正在使用 AI 编码代理的开发人员和设计师。

亮点

• 混合格式：将结构化的 YAML Token 与描述性的 Markdown 文本相结合。
• 无障碍检查：内置针对 WCAG AA 对比度的 Lint 检查。
• WriteLine 导出：支持导出到 Tailwind CSS 和 W3C DTCG 格式。
• 面向代理设计：包含一个 spec 命令，用于输出格式规范以便注入到代理提示词中。