用途:调研项目已确立的稳定视觉规则,记录到单个 meta/DESIGN.md 中,说明 UI 应如何呈现与交互;精确样式值仍由运行时来源(如 CSS、设计令牌、Tailwind 或框架主题配置)拥有。
主要能力与流程:
- 检测模式:检查 meta/DESIGN.md 是否存在,缺失则引导创建,存在则读取全文并扫描来源判断是否需刷新;若项目没有既有 UI,则停止并建议调用 frontend-design。
- 梳理界面与权威来源:判断仓库是单一设计语言还是多个不同界面(工具包、令牌词汇、受众或渲染目标不同)。单一设计语言用扁平文档;多界面保留一个 meta/DESIGN.md,增加界面表格与分界面区块,禁止跨界面混用令牌或工具包规则。记录令牌名称、角色与来源路径,不复制完整色板或尺度。
- 调研既有语言:按界面数量派发只读子代理,返回受众、视觉特征、密度、层级、交互方式、框架与组件库、语义颜色、排版、布局、形状与深度、动效、图标与图像、组件组合与跨组件模式、界面文案规则、项目级注意事项,以及权威来源与刷新触发条件。所有事实须来自当前 UI、代码或既有产品文档;证据不足则记为缺失。
- 组装与确认:按模板组装,只保留项目实际使用子集,排除功能行为、页面级布局与通用设计建议;写 Overview 须基于可观察证据,不用“现代”“简洁”等模糊词;先向用户展示摘要并确认(写入/调整)。
- 写入或刷新:创建或仅编辑受影响章节,保留其他人工修改,冷读检查冲突与缺失来源,并报告路径与变更章节。
模板包含 Overview、Toolkit、Colors、Typography、Layout、Shape and depth、Motion、Iconography and imagery、Components、Patterns、Content、Do's and Don'ts、Maintenance 等章节;无明确动效或图标体系时可省略相应章节。多界面时保留全局 Overview,增加 ## Surfaces at a glance 表格与每个界面的独立区块,末尾为全局 Maintenance。
限制:该技能只记录设计语言,不发明设计语言;不复制运行时完整取值或库目录;通用质量规则(对比度、键盘访问、焦点可见性、触控目标尺寸)保留在消费方技能中;界面边界确实模糊时需与用户确认。