【design.md】用一份纯文本文件，让AI精准掌握你的设计规范
在AI辅助编程日益普及的今天，如何让大模型准确理解并严格遵循既定的视觉规范一直是个难题。该项目提出了一种名为 DESIGN.md 的文本格式标准，旨在为AI编码代理（Agent）提供持久、结构化的设计系统认知，从而彻底解决AI生成代码时风格漂移、忽略设计细节的痛点。
核心功能与特性
– 人机协同的双层结构： 文件顶部使用 YAML 前置元数据存放机器可精确解析的设计令牌（颜色、排版、圆角、间距等），正文使用 Markdown 撰写人类可读的设计理念与应用指南，兼顾精确度与可读性。
– 自动化规范校验： 内置 Lint 工具，可自动检测令牌引用断裂、组件颜色对比度是否低于 WCAG AA 标准（4.5:1）、段落顺序是否正确等，并输出结构化 JSON 报告供 AI 直接消费修正。
– 版本差异精准对比： 提供 diff 功能，可对比两份设计文件的令牌级变更，自动统计新增、移除、修改项，并快速识别设计回归。
– 主流工程格式导出： 支持将设计令牌一键导出为 Tailwind v3/v4 配置、CSS 自定义属性或 W3C DTCG 标准格式，无缝衔接现代前端工作流。
– 可编程集成： 除了命令行工具，还提供了 TypeScript 库，方便开发者在构建流程中直接调用校验逻辑。
安装与使用示例
该项目通过 npm 发布，安装后即可快速校验、对比或导出设计文件：
# 安装工具包
npm install @google/design.md
# 校验 DESIGN.md 文件是否符合规范并输出 JSON 报告
npx @google/design.md lint DESIGN.md
# 对比两个版本的设计文件差异
npx @google/design.md diff DESIGN.md DESIGN-v2.md
# 将设计令牌导出为 Tailwind v4 所需的 CSS 主题块
npx @google/design.md export --format css-tailwind DESIGN.md > theme.css
Windows 用户提示：若直接使用
npx @google/design.md被系统误识别为打开 Markdown 文件，请使用内置别名designmd替代，例如：npx -p @google/design.md designmd lint DESIGN.md，效果完全一致。
适用场景与目标用户
该工具非常适合引入 AI 辅助前端开发的团队与独立开发者。对于前端工程师与设计系统维护者，它提供了一种轻量、纯文本的方式来集中管理视觉资产，并通过自动化拦截提前发现对比度不达标或引用丢失等隐患。对于 Prompt 工程师与 AI 应用构建者，该格式能将复杂的品牌指南转化为大模型可直接读取的结构化指令，大幅降低代码生成时的样式偏差。此外，需要对接 Tailwind 或遵循 W3C 令牌标准的工程团队也能通过导出功能快速迁移现有规范。
总结
DESIGN.md 以极简的 Markdown 为载体，巧妙弥合了人类设计意图与 AI 代码生成之间的语义鸿沟。其内置的校验、对比与多格式导出能力覆盖了设计资产工程化的关键环节，为构建高一致性、可自动化的 AI 辅助开发工作流提供了扎实的基础设施。目前该项目仍处于 Alpha 阶段，规范与工具链正在持续迭代，建议访问其主页获取更详细信息。
