SuperAPI AI 工具集

nextjs-shadcn

前端与建站

查看项目

更新于 10-26 16:21

技能介绍

用途 该技能面向在 Next.js App Router 应用中使用 shadcn/ui 构建界面组件的场景,典型包括表单控件(输入框、选择器、复选框、开关、滑块)、对话框、抽屉、弹层、数据表格、导航菜单、侧边栏、命令面板、Toast 通知与提示反馈等。它是 shadcn/ui 的 Next.js App Router 版本,纯 React/Vite 项目应参考 react-shadcn。

主要能力

  1. 强调在编写任何组件代码前,先通过 components.json 检测项目所用基础库:base-* 对应 Base UI,radix-* 或 new-york 对应 Radix,aria-* 对应 React Aria,且同一组件中不得混用基础库。新项目默认使用 Base UI,除非初始化时传入 -b radix 或 -b aria。
  2. 组件必须通过 bunx --bun shadcn@latest add 安装,安装到 @/modules/cores/shadcn/components/ui/,禁止手工创建。
  3. 提供 MCP 注册表工具(mcp__shadcn__*),用于搜索组件、查看源码、获取使用示例与安装命令,帮助实现前先探索组件可用性。
  4. 说明不同基础库在代码写法上的差异,例如 Base UI 使用 render={<Button />} 而 Radix 使用 asChild;Select、Accordion、Toggle group、Checkbox indeterminate、Drawer、Toast 等在两类基础库下的 API 差异。
  5. 表单采用 TanStack Form 而非 React Hook Form,错误通过 Field 的 data-invalid 与控件的 aria-invalid 联动。
  6. 默认使用 Server Components,仅在需要交互时添加 "use client";主题通过 CSS 变量与 OKLCH token 在 app/globals.css 中定义,并用 @theme inline 暴露。
  7. 提供 CLI 辅助命令:shadcn info 查看框架、基础库与已安装组件;shadcn docs <component> -b <base|radix|aria> 查看组件文档。

使用方式 技能规定了一套强制工作流:实现前并行启动三个代理,分别用 fuse-ai-pilot:explore-codebase 分析现有组件与模式、用 fuse-ai-pilot:research-expert 通过 Context7/Exa 核实最新 shadcn/ui 文档、用 mcp__shadcn__* 搜索注册表组件;实现后运行 fuse-ai-pilot:sniper 进行校验。MCP 集成可通过 bunx --bun shadcn@latest mcp init --client claude 或创建 .mcp.json 完成。组件按 SOLID 结构安装,工具函数位于 @/modules/cores/lib/utils.ts。

适用场景 适用于 Next.js App Router 项目中需要无障碍、可定制、可复用的 shadcn/ui 组件开发,尤其是表单、弹层、数据展示表格、导航结构与通知反馈等界面;也适合需要统一主题 token 与组件基础库规范的团队项目。

限制 资料未提供该技能的收费、价格、平台兼容范围、性能效果等具体信息。其工作流依赖 Claude Code 与 MCP 相关工具及特定代理名称,实际可用性取决于环境配置;基础库行为差异需按文档谨慎迁移。