用途:DESIGN.md 是一种向编程智能体描述视觉识别的格式规范,把机器可读的设计令牌(YAML front matter)与人类可读的设计理由(Markdown 正文)结合,让智能体持久、结构化地理解设计系统。
主要能力:文件分两层——YAML 前置元数据承载颜色、排版、圆角、间距、组件等令牌;Markdown 正文按固定顺序组织 Overview、Colors、Typography、Layout、Elevation & Depth、Shapes、Components、Do's and Don'ts 等章节(均可选)。令牌类型包括 Color(# 前缀十六进制)、Typography(字体族、字号、字重、行高、字距)、Dimension(px/em/rem)、Token Reference({path.to.token})。组件属性支持 backgroundColor、textColor、typography、rounded、padding、size、height、width。
使用方式:安装 npm install @google/design.md,或直接用 npx @google/design.md。CLI 提供 lint(校验结构、断链引用、WCAG 对比度)、diff(比较两版令牌变化与回归)、export(导出 json-tailwind、css-tailwind、dtcg)、spec(输出规范,可加 --rules 或 --rules-only)。也提供编程 API,如 import { lint } from '@google/design.md/linter'。Windows 在 package.json 脚本中应使用 designmd 别名而非 design.md。
适用场景:为 AI 编程智能体建立设计系统上下文、在 CI/CD 或 pre-commit 中校验设计文件、导出 Tailwind v3/v4 或 DTCG 令牌、追踪设计演进。
限制:version 当前为 alpha;lint 输出格式目前仅支持 json;对比度规则按 WCAG AA 4.5:1 提示;其余平台、收费与效果信息暂未提供。