用途：DESIGN.md 是 Google 的开放规范（Apache-2.0，google-labs-code/design.md），用于向编码智能体描述视觉识别体系。一个文件同时包含 YAML 前置元数据（机器可读的设计令牌，即规范值）和 Markdown 正文（人类可读的理由说明，按规范章节组织）。令牌给出精确值，正文告诉智能体这些值为何存在、如何应用。
主要能力：CLI（npx @google/design.md）可校验结构与 WCAG 对比度、比对版本回归、导出为 Tailwind 或 W3C DTCG JSON。令牌类型包括颜色（# 加十六进制 sRGB）、尺寸（数字加 px/em/rem 单位）、令牌引用（{path.to.token}）、排版对象（fontFamily、fontSize、fontWeight、lineHeight、letterSpacing、fontFeature、fontVariation）。组件属性白名单为 backgroundColor、textColor、typography、rounded、padding、size、height、width；变体（hover、active、pressed）是独立组件条目，如 button-primary-hover，不嵌套。规范章节顺序为 Overview（别名 Brand & Style）、Colors、Typography、Layout（别名 Layout & Spacing）、Elevation & Depth（别名 Elevation）、Shapes、Components、Do's and Don'ts；章节可选，但出现时必须按此顺序，重复标题会拒绝文件。未知章节会保留而非报错，未知令牌名只要值类型有效即接受，未知组件属性产生警告。
使用方式：编写时在项目根目录写入 DESIGN.md，至少包含 name: 和 colors:，组件区用令牌引用而非重复十六进制值，随后 lint 并修复断链引用或 WCAG 失败项；已有项目可同时导出 tailwind.theme.json 或 tokens.json。常用命令：npx -y @google/design.md lint DESIGN.md；npx -y @google/design.md diff DESIGN.md DESIGN-v2.md；npx -y @google/design.md export --format tailwind DESIGN.md > tailwind.theme.json；npx -y @google/design.md export --format dtcg DESIGN.md > tokens.json；npx -y @google/design.md spec --rules-only --format json。所有命令支持 - 作为标准输入，lint 出错返回退出码 1。
适用场景：用户要求 DESIGN.md 文件、设计令牌或设计系统规范；希望多个项目或工具间 UI/品牌一致；粘贴现有 DESIGN.md 要求校验、比对、导出或扩展；把风格指南移植为智能体可消费的格式；对配色做对比度/WCAG 无障碍校验。纯视觉灵感或布局示例应改用 popular-web-designs；从零设计一次性 HTML 产物（原型、演示、落地页、组件实验室）的流程与品味应改用 claude-design。
限制与注意：不要嵌套组件变体；十六进制颜色必须加引号，否则 YAML 会因 # 出错或截断；负尺寸也需引号，如 letterSpacing: "-0.02em"；章节顺序强制；version: alpha 是当前规范版本（截至 2026 年 4 月），规范标记为 alpha，需留意破坏性变更；令牌引用按点路径解析，{colors.primary} 有效而 {primary} 无效。lint 的 7 条规则涵盖 broken-ref、duplicate-section、invalid-color、invalid-dimension、invalid-typography（错误），wcag-contrast（警告/信息，按 WCAG AA 4.5:1 与 AAA 7:1 检查组件 textColor 与 backgroundColor 比值），unknown-component-property（警告）。生成的 DESIGN.md 文件许可证随用户项目，规范本身为 Apache-2.0。