笔记 · 设计 ·

用一份 DESIGN.md 管住 AI 的设计风格

把设计规范写成一个文件,让 AI 每次照着做,而不是每次重新猜。读完发现还漏了一步:要在 CLAUDE.md 里明确要求它遵守。

读书笔记原文:《把 Google Stitch 的 Design.md 和 Claude Code 结合,做出一致的界面》↗小互 · xiaohu.ai

为什么读

做这个网站时,我在选定风格之后、写代码之前,先写了一份 DESIGN.md。看到这篇讲的是同一件事,想对照一下自己做得全不全。

我记下的要点

  1. 问题: AI 每次生成界面都在重新猜设计,颜色、圆角、字体前后对不上。
  2. 办法: 把规范写进一个 DESIGN.md:颜色值、字体字号、间距、断点、组件各种状态、圆角阴影。它就是普通的 Markdown,可以放进 Git 管理。
  3. 三种来源: 用 Google Stitch 生成;让 Stitch 从一个现成网站里提取;直接用社区整理好的现成文件。
  4. 关键一步: 在项目的 CLAUDE.md 里写明「只用 DESIGN.md 里定义的值,不确定就先查它」。
  5. 验收办法: 问 AI「主色是什么」,看它能不能答出文件里的准确色值。
  6. 常见错误: 设计还没定就导出;改了设计却忘了同步更新文件。

我的对照

  • 做到了的: 我的 DESIGN.md 里有颜色、字体、字号层级、间距、组件和响应式规则;颜色还另外写成了 CSS 变量,代码里只引用变量,不写具体色值。比文章多做了一步:每个颜色都算了对比度。
  • 漏掉的: 我没有 CLAUDE.md。现在是靠每次对话提醒 AI「按 DESIGN.md 来」,换个新对话它可能就不知道了。
  • 踩过的坑: 第 6 条说得很对。标志从「印章里写个粽字」改成粽子剪影之后,我专门回去改了 DESIGN.md 里的描述,不然下次 AI 照着旧规范又会改回去。

我的想法

DESIGN.md 的价值不只是给 AI 看,也是逼自己把「感觉」翻译成「规则」。写之前我只知道「喜欢宋体笔记本那种感觉」,写完才知道具体是哪几个颜色、多大的字、多少留白。

我打算试试

  • 给网站项目加一个 CLAUDE.md,写明设计和写作的规矩