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、不要用三张等宽功能卡当默认布局。