SuperAPI AI 工具集

ui-components

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:为使用 shadcn/ui 与 Radix Primitives 构建无障碍 UI 组件库提供模式与规则,作为官方文档的薄层封装,聚焦快速入门配方、关键决策、反模式与自有约定。

主要能力:规则分为 6 类共 15 条,按需从 rules/ 加载。shadcn/ui(1 条,HIGH):v4 样式、预设码、样式检测;设计系统(4 条):W3C tokens、OKLCH 主题、间距比例、排版、组件状态与动画;设计系统组件(1 条):原子设计、CVA 变体、无障碍、Storybook;表单(2 条):React Hook Form v7、Zod 校验、Server Actions;现代 CSS 与工具(3 条):CSS 级联层、Tailwind v4、Storybook CSF3;UX 基础(4 条):视觉层级、排版阈值、颜色系统、空状态。

使用方式:核心模式为 CVA 变体配合 cn() 工具合并类名,Radix Dialog 使用 asChild 组合。shadcn CLI v4 提供 apply <style>、info、skills、build 等命令,例如 npx shadcn@latest apply <style> 可对现有组件重新换肤。样式检测读取 components.json 的 style 字段。配置可在 ui.shadcn.com/create 可视化选择样式、主题、字体与图标后复制生成命令。

关键决策:颜色使用 OKLCH;类名冲突始终用 cn();扩展组件应包装而非修改源文件;变体用 CVA;样式用数据属性加 Tailwind 任意变体;组合用 asChild 避免多余 DOM;动画用纯 CSS 与 data-state 选择器;表单组件搭配 react-hook-form;破坏性确认使用 AlertDialog 而非普通 Dialog。

限制与反模式:禁止修改 shadcn 源文件、跳过 cn()、用内联样式替代 CVA、额外包装 div、Dialog 缺少 Title、使用正 tabindex、仅靠颜色表示状态、手动管理焦点。Radix 机制与 shadcn 定制教程等由第一方文档负责,本技能不再重述;详细约定见 references/ork-delta.md。预置码会随样式快照漂移,文档中不应硬编码。具体收费、价格与平台支持情况暂未提供。