SuperAPI AI 工具集

design-component

设计与创作

查看项目

更新于 10-16 03:43

技能介绍

用途:按项目既定质量规范编写完整的 UI 组件设计规格,适用于需要新建或统一组件设计文档的场景。据资料,该项目以 shadcn-ui-design 为构建与编辑 UI 的权威规范,本技能仅作指导,输出须符合该规范。

主要能力:产出包含结构解剖图、变体表、尺寸表、适用的 8 种状态、令牌映射、无障碍(角色/键盘/屏幕阅读器)说明的完整规格,并附经由 adapter-protocol 渲染的提示。先生成规范后,还需构建状态测试夹具,覆盖各变体与状态的组合。

使用方式:先阅读 CLAUDE.md 中的组件指南与原子设计部分;检查共享目录下现有规格文件并匹配其格式;从无障碍资料中提取 ARIA 模式与对比度、目标尺寸规则;将每个值映射到令牌(尺寸用 sizing.json,状态用 states.json);可选用 scaffold_component.py 生成骨架再填充。之后运行校验脚本:verify_states.mjs 检查默认/悬停/焦点下各元素对比度,axe_audit.mjs 检查 ARIA 与标签正确性,measure_render.mjs 检查文本 AA,弹层类另跑 verify_focustrap.mjs;响应式用 verify_responsive.mjs 在 280/320/414px 下检查横向溢出。

限制与注意事项:必须通过 actual 校验,不能仅凭假设声明状态正确;对比度与无障碍门禁不能证明像素正确,仍需截图查看实际渲染;同一组件在不同文件中须保持完全一致的 CSS 与标记;图标须使用 lucide 原始路径而非手绘;颜色须用语义令牌而非硬编码;动效须用令牌化时长与缓动并尊重减少动效偏好;网格卡片用 auto-fit 而非 auto-fill;移动端导航不得与内容重叠。所有状态须在明暗两种主题下通过校验。具体分类标识、收费与价格信息暂未提供。