搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

google-labs-code/design.md

开发工具

用 Markdown 加 YAML 描述设计系统,让编程 Agent 按固定 token 和设计理由生成一致的界面。

28,958
2,320
TypeScript
Apache-2.0
创建于 7 个月前

项目介绍

DESIGN.md 定义了一种把视觉身份交给编程 Agent 的文件格式。一个文件里同时包含机器可读的设计 token(颜色、字体、间距、圆角、动效、组件)和人类可读的设计理由,Agent 既拿到精确数值,也知道这些数值为什么存在、该怎么用。

仓库提供格式规范和配套的 TypeScript CLI,用于校验、对比和导出这类文件。适合希望 Agent 产出的界面风格稳定、而不是每次重新猜样式的团队。

快速使用

需要 Node.js 和 npm,并能访问公共 npm 注册表 npm。先按 README 中的示例编写 DESIGN.md:顶部 YAML front matter 写 token,下面用 ## 小节写设计理由。

校验文件:

npx @google/design.md lint DESIGN.md

输出为 JSON,含 findings 和 errors、warnings、infos 的汇总。还可以比较两个版本并导出 token:

npx @google/design.md diff DESIGN.md DESIGN-v2.md
npx @google/design.md export --format css-tailwind DESIGN.md > theme.css

lint 有错误时返回退出码 1,diff 检测到回退时返回 1。export 支持 Tailwind v3 JSON、Tailwind v4 CSS 和 DTCG JSON 三种格式。linter 也可以从 @google/design.md/linter 作为库引入。

在 Windows 上,design.md 这个命令名会和 Markdown 文件关联冲突,README 建议改用不带点号后缀的别名:

npx -p @google/design.md designmd lint DESIGN.md

格式要点

Token 放在 YAML front matter 或围栏 YAML 代码块中,Markdown 正文按固定顺序组织为 ## 小节(Overview、Colors、Typography、Layout、Elevation、Shapes、Motion、Voice、Components、Do's and Don'ts),可以省略但不能乱序。Token 引用使用 {path.to.token} 语法。校验规则会报告失效引用、缺少 primary 颜色或字体、组件配色低于 WCAG AA 对比度、小节顺序错误等问题。未知的小节和 token 名称会被保留而不是拒绝,便于自行扩展。完整规范见 docs/spec.md,精简版在在线文档。

使用约束

格式目前是 alpha 版本,规范、token schema 和 CLI 都在积极开发,格式可能变化。CLI 依赖 Node.js 和 npm,npx 从公共注册表拉取;如果公司镜像尚未同步 @google/design.md,会出现 ENOVERSIONS 错误,需要检查 registry 配置。许可证为 Apache-2.0。项目说明不参与 Google 开源软件漏洞奖励计划。

HotRepo 点评

2026 年 6 月下旬,该项目连续出现在全部语言日榜:单日新增从约 500 星升到 2,300 多星,6 月 26 日达到记录的 2,319 星;11 月中旬又以 143 星的新增进入 TypeScript 周榜第 16 名。这个走势更像早期集中爆发、之后保持小幅增长。

HN 讨论有 37 分和 4 条评论。有评论者认为主题配置和组件文件已经承载了这些设计值,质疑长期设计文档是否必要(讨论);也有人追问它和 Figma tokens、tailwind.config.js、AGENTS.md 的关系,以及谁才是唯一可信来源(讨论)。这些集成问题在 alpha 规范里还没有完全答案,而 diff 和 export 命令是目前让文件与既有 token 源保持同步的具体手段。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

Hacker News 讨论

Design.md: A format spec for describing a visual identity to coding agents
▲ 37 · 4 条评论 · 2026年4月24日

相关推荐

  1. elayadesign/ai-design-skills一份 markdown 规则文件,让 AI 编程工具按固定流程搭落地页的结构、文案与视觉系统。9,086
  2. emilkowalski/skills为设计者和工程师提供界面与动效设计规则的 Agent 技能集合,帮助编程助手做出更合适的 UI 决策。Markdown54,032
  3. humanlayer/skills一套可安装的 Claude Code/Codex 技能集,覆盖调研实现、可视化 PR、CLAUDE.md 改写和智能体循环设计。TypeScript5,592
  4. avenoxai/avenoxbeyin面向 AI 编程代理的本地 Markdown 记忆系统,让决策和任务跨会话可保存、可检索。Python436
  5. mattpocock/skills一套可与编码 Agent 组合搭配的技能,覆盖需求追问、写规格、TDD、调试与代码库设计。Shell321,398