SuperAPI AI 工具集

moai-design-system

设计与创作

查看项目

更新于 10-16 01:17

技能介绍

用途:该技能面向统一的设计系统工作,覆盖两个领域——Intent-First 设计工艺(设计方向与评审)和 UI/UX 基础(无障碍、设计令牌、组件架构)。适用于需要在动手实现前先明确设计意图、并系统化落地设计规范的场景。

主要能力:

  1. 设计方向工作流:领域探索(命名领域、列出关键实体、建立词汇表);加载 .moai/design/system.md 读取既有设计决策;撰写意图声明“This interface should feel [形容词] because [原因]”;从意图中提炼 3-5 条工艺原则;按原则评估实现。
  2. 构建后评审清单:视觉层级是否匹配领域词汇;每个动画是否服务于交互契约;文案是否避免 AI 通用措辞(如 elevate、seamless、leverage);信息密度是否匹配用户认知负荷。
  3. UI 文案反 AI 套话规则:用具体动作替换 Unlock(如 Publish、Deploy、Launch);用真实体验描述替换 Seamless(如 One-step setup);用直接动词替换 Leverage(如 Use、Apply、Run);标题须说明发生什么,而非感觉如何。
  4. 设计令牌架构:遵循 W3C DTCG 2025.10 标准,使用 Style Dictionary 4.0 做多平台输出;层级为 {category}.{concept}.{property}.{variant}.{state},分原始令牌、语义令牌、组件令牌;用 CSS 自定义属性做运行时主题,暗色模式通过 [data-theme="dark"] 选择器。
  5. 组件架构:原子设计层级 Atoms → Molecules → Organisms → Templates → Pages;使用 shadcn/ui 配合 Radix UI 原语,Tailwind CSS 扩展,不覆盖 Radix 无障碍属性。
  6. 无障碍标准:最低 WCAG 2.2 AA,文本密集与面向公众界面用 AAA;交互元素可键盘导航并有可见焦点环;图片提供描述性 alt 或 aria-hidden="true";表单用 htmlFor 或 aria-labelledby 关联标签;对比度普通文本 4.5:1、大文本与 UI 组件 3:1;动画遵循 prefers-reduced-motion。
  7. 图标库选择:Lucide(1500+,默认)、Hugeicons(27K+,丰富产品图标)、Iconify(200K+,多库访问层)、Tabler(5900+,技术/开发者工具)。

验证要点:视觉实现前记录设计意图;令牌遵循 W3C DTCG 层级;交互元素通过 WCAG 2.2 键盘导航测试;验证对比度;文案无 AI 通用填充语。

限制:资料未提供具体安装命令、收费方式、平台支持范围与效果数据,暂未提供。