用途:该技能面向使用 shadcn/ui 构建应用的前端工程师,提供组件发现、集成与定制的最佳实践指导。shadcn/ui 不是传统组件库,而是复制进项目的可复用组件集合,因此组件归项目所有、可自由修改、无版本锁定、无运行时库体积。
主要能力:通过 shadcn MCP 工具浏览组件目录与注册表,包括 list_components、get_component_metadata、get_component_demo、get_component、get_project_registries、list_items_in_registries、view_items_in_registries、search_items_in_registries;支持区块(如登录、仪表盘、侧边栏、日历、商品)的列出与获取。
使用方式:新项目运行 npx shadcn@latest create,已有项目运行 npx shadcn@latest init 生成 components.json;添加组件运行 npx shadcn@latest add [component-name],也可手动获取源码放入 components/ui/。依赖包括 React 18+、Tailwind CSS 3.0+、Radix UI 或 Base UI、class-variance-authority、clsx 与 tailwind-merge。组件通过 cn() 合并类名,主题在 Tailwind 配置与 globals.css 的 CSS 变量中定制,变体用 cva 定义,扩展组件应放在 components/ 而非 components/ui/。
适用场景:需要高度可定制、可访问的 React 界面,如表单、对话框、数据表格、仪表盘与认证流程。
限制:资料未提供具体收费、价格与效果数据;版本兼容性提示 shadcn/ui v4 需 React 18+,使用 Next.js 时需 13+,部分组件依赖特定 Radix UI 版本,升级前需查阅破坏性变更。