SuperAPI AI 工具集

sfnext-create-component

通用与其它

查看项目

更新于 10-16 05:44

技能介绍

用途:为 Storefront Next 店面新增设计系统组件时,提供一套创建纪律,保证层级选择正确、先复用后新建,并满足令牌、可访问性与 Storybook 要求。它与 sfnext-components 互补:后者关注 createPage、Suspense/Await 流式渲染、shadcn/ui 配置与 cn() 工具等工程模式;本技能关注设计系统编写,包括层级模型、先扩展后新建的闸门、绑定语义令牌的 CVA 变体、data-slot、可访问性与故事覆盖。构建 UI 时可两者配合使用。

使用方式:开始前先扫描,不要直接新建文件。在 src/components/ 搜索名称或行为相近的组件;在 src/components/ui/ 搜索 Shadcn 原语,可运行 npx shadcn@latest add <name> 检查是否已存在。随后应用 REUSE / EXTEND / CREATE 决策:已存在且能直接用则复用;接近则新增 CVA 变体进行扩展;都不满足才新建。层级选择上,纯 UI 元素无数据或业务逻辑归为 Primitive,放在 src/components/ui/(先查 shadcn);组装原语或接收数据 props 归为 Composite,放在 src/components/。原语若 shadcn 已提供就直接使用,不要手写替代;相关组件会落到 src/components/ui/ 并已接入令牌系统。

主要能力与要求:文件以 Apache 2.0 版权头开始(ESLint 强制),从 src/components/ui/ 导入原语而非直接 @radix-ui;使用显式类型,禁止 any,用 React.ComponentProps<'element'> 支持原生透传,互斥 props 用可辨识联合。有视觉状态时用 CVA 定义变体,所有影响颜色的类必须使用语义令牌工具类(如 bg-primary、text-foreground、border-border),不得使用原始十六进制、bg-black 或 text-gray-500。组件根节点与每个命名区域需有 data-slot;接受 className 并通过 cn() 最后合并以便调用方覆盖;原生 props 用 {...props} 展开。每个 src/components/ 下的新组件都需要 .stories.tsx,为每个 CVA 变体提供一个 story,并加一个 Snapshot story 用于 CI 差异比对。可访问性方面:交互元素用 button 或 a 而非 div onClick;表单输入配 Label htmlFor;焦点环使用 focus-visible:ring-ring focus-visible:ring-[3px];信息不只用颜色表达;纯图标按钮加 aria-label。

验证与限制:任务完成前在 monorepo 根目录运行 pnpm typecheck、pnpm lint、pnpm test-storybook:snapshot:agent,三者须零错误零警告通过(lint 使用 --max-warnings 0)。资料未提供收费、价格或平台范围等信息。