Driftless

全部文档

DESIGN.md 里有哪些字段

Agent 读的是文件,不是你脑子里的品味。下面是这份文件实际要包含的东西。

YAML 在最上面

front matter 的 key 保持英文:colors、typography、rounded、spacing。色值按语义角色写,例如 primary、background、onBackground,不要在组件里再写一套 hex。

八节正文

顺序是 Overview、Colors、Typography、Layout、Elevation & Depth、Shapes、Components、Do's and Don'ts。标题用英文,这样和 Google 的 DESIGN.md 规范对齐,本站导出前也会按这个顺序检查。

中文可以写在句子里

选择中文导出时,概述、组件说明和 Do / Don't 会写成中文。YAML 的 key 和八个章节标题仍然是英文。风格页的预览也按这个规则。

取舍要写具体

Do / Don't 不要写「保持美观」。写可执行的句子,例如只留一个强调色、触控至少 44px、不要用三张等宽功能卡当默认布局。