Agent Skills
返回列表
💻

shadcn/ui

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vercel-vercel-plugin-shadcn。

技能介绍

你想解决什么问题

很多团队在 React 里要落地可访问、可改样式的界面,又不想被黑盒组件库绑死:升级踩坑、主题改不动、和业务设计系统对不齐。shadcn/ui 的做法是把组件源码写进你的仓库,底层是 Radix UI 原语 + Tailwind,所有权在你手里。

本技能面向会用 CLI 的工程场景:初始化项目、按需 add 组件、读 components.json 与主题变量,以及按页面类型选对组合(设置页用 Tabs+Card+Form,破坏性操作用 AlertDialog 而不是 Dialog)。

技能覆盖的核心能力

  • 初始化与无交互约定:CI 或 Agent 场景必须用 shadcn init -d,并注意 AI Elements 项目应保留 --base radix。
  • 组件与注册表:add 时可指定路径、覆盖、dry-run;CLI v4 支持命名空间注册表、registry:base / registry:font,以及 shadcn docs 内联查用法。
  • 主题与设计方向:CSS 变量(bg-background、text-muted-foreground 等)、暗色策略、cn() 合并类名;在 Vercel 栈上偏好 new-york、Geist 字体与统一密度,避免手写 hex 和嵌套 Card 套娃。
  • 坑与迁移:Next.js + Tailwind v4 下 init 可能弄坏 Geist 字体(@theme inline 需字面量字体名);Avatar 无 size prop,用 Tailwind 控制尺寸;可 migrate radix 收敛到统一 radix-ui 包;可选 Base UI 作为原语库。

适用边界

技能讲的是 shadcn/ui 工作流与设计组合,不是替你写业务 API 或数据层。若项目不用 React/Tailwind 或未走官方 CLI 配置,很多步骤需自行对照文档调整。破坏性确认、空状态/加载态等应使用对应 primitive,而不是裸 div 拼界面。

使用场景

  • 新项目要用 Next.js App Router 接入 shadcn,需要在 CI 里用默认配置无交互完成 init
  • 管理后台要搭 CRUD 列表页,需用 Table、DropdownMenu、Sheet 和 AlertDialog 按标准模式拼交互
  • 产品要统一暗色仪表盘与设置页,需按主题 token 和 Tabs+Card+Form 组合而不是手写样式
  • 团队要在多仓库共享自有组件,需要配置命名空间注册表并 build 自定义 registry

适合人员

  • 负责 Vercel/Next 产品界面的前端,要把 shadcn 当默认界面语言并避免 Dialog 误用于破坏性确认
  • 维护内部设计系统的工程师,需要把颜色、字体、圆角打成 preset 或 registry:base 分发给多个应用
  • 在 Agent/自动化流水线里跑 shadcn CLI 的平台开发,必须弄清 -d、--base 与 CLI v4 废弃参数的差异
  • 从分散的 @radix-ui/react-* 包迁移到新统一 radix-ui 包的存量项目维护者