用途:DESIGN.md 是 Google 的开放规范(Apache-2.0,google-labs-code/design.md),用一个文件向编码智能体描述视觉识别:YAML front matter 存机器可读的设计令牌(规范性数值),Markdown 正文写人类可读的理由,并按规范章节组织。适用于用户要求生成 DESIGN.md、设计令牌或设计系统规范,希望跨项目保持一致 UI/品牌,或粘贴已有文件要求 lint、diff、export、扩展,以及需要对配色做对比度/WCAG 校验时。纯视觉灵感或布局示例应使用 popular-web-designs;一次性 HTML 产物设计流程应使用 claude-design。
主要能力:令牌类型包括颜色(任意 CSS 颜色)、尺寸(数字+单位)、令牌引用({path.to.token})、排版对象(fontFamily、fontSize、fontWeight、lineHeight、letterSpacing、fontFeature、fontVariation)。组件属性白名单为 backgroundColor、textColor、typography、rounded、padding、size、height、width;变体应作为独立组件条目(如 button-primary-hover),不可嵌套。规范章节顺序为 Overview、Colors、Typography、Layout、Elevation & Depth、Shapes、Components、Do's and Don'ts,可选但存在时须按此顺序。
使用方式:CLI 为 @google/design.md(Node),用 npx 无需全局安装。校验:npx -y @google/design.md lint DESIGN.md;版本对比:npx -y @google/design.md diff DESIGN.md DESIGN-v2.md;导出:--format json-tailwind、css-tailwind 或 dtcg,输出重定向到文件;注入提示可用 spec --rules-only --format json。所有命令接受 - 作为 stdin,输出默认 JSON。Windows 上 bin 名 design.md 可能与 .md 关联冲突,改用 designmd lint DESIGN.md。
限制:version: alpha 为当前版本(CLI 0.3.0,2026年7月),规范标为 alpha,可能有破坏性变更。十六进制颜色和负尺寸必须加引号;令牌引用用点路径;排版子属性拼写错误会被静默丢弃。linter 只对章节顺序告警,但合规消费者期望顺序正确。export 不因 lint 问题失败,需单独运行 lint 门禁。