简诗 Material 设计指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/material
技能介绍
它解决什么问题
Material Design 的文档讲理念,落到代码里却只剩一堆色值和间距数字。团队常见的结果是:两个按钮的圆角来自不同的直觉,两处正文颜色分别来自 #111827 和 #333,焦点态在某几个页面上被“忘了”。
这个技能是一套给工程师和设计师直接使用的规范写作框架。它不生成组件库,而是教模型写出一份可执行的设计系统指南:令牌先于组件,规则必须可验证。
技能如何工作
风格基座:令牌已预设好,直接引用即可——字号阶梯 12/14/16/20/24/32,字体 Inter(正文)/ Roboto(展示)/ Fira Code(等宽),字重覆盖 100 到 900,间距阶梯 4/8/12/16/24/32,语义色 primary=#6442D6、success=#16A34A、warning=#D97706、danger=#DC2626、surface=#FFFFFF、text=#111827。
写作流程分六步:
- 先用一句话重述设计意图,再提出规则
- 定义令牌和基础约束,再写组件级指引
- 明确组件结构、变体、状态与交互行为
- 附上无障碍验收标准和文案写作要求
- 针对已有不一致 UI,给出反模式与迁移说明
- 以一份可在 Code Review 中执行的 QA 清单收尾
约束语言:不可协商的规则用 must,建议用 should;每条 do 规则至少配一个具体的 don't 反例。
组件规则要求覆盖 default / hover / focus-visible / active / disabled / loading / error 全部状态,明确键盘、指针、触屏三种输入方式,写死间距、字号和令牌取值,并处理长标签、空状态、溢出等边界情况。
适用边界
- 无障碍是硬约束:WCAG 2.2 AA、键盘优先交互、可见焦点态。审美与可访问性冲突时,后者优先
- 规则不得依赖模糊形容词,每条都要锚定到令牌、阈值或具体示例
- 一致性优先于局部优化;引入新模式时必须附带迁移指引
- 它是一套写作框架,不代替取色、生成代码等工具型任务
使用场景
- 团队要新写一份 Material Design 设计系统指南,需要把令牌和组件规则统一固化下来
- UI 审查时发现按钮间距和文字颜色各写各的,要补一份可执行的规范和迁移说明
- 要给组件补齐 hover、focus-visible、disabled、loading、error 等全部交互状态的定义
- 组件库要满足 WCAG 2.2 AA,需要为每个组件写出键盘可验证的无障碍验收标准
适合人员
- 前端工程师,想在写组件前先拿到统一的间距、字号和颜色令牌取值
- 设计系统负责人,需要把 Material 规范整理成工程师能直接落地的指南
- UI 设计师,要在 Figma 或标注稿中为组件补齐完整状态和响应式行为说明
- 需要给现有不一致界面做规范化改造,并写出可在 Code Review 执行的 QA 清单的团队