用途:本 Skill 用于指导用户使用 taro-shadcn CLI,把 UI 组件快速集成到 Taro 项目中,适合在用户询问 CLI 用法或如何创建组件时调用。
主要能力:提供初始化项目与添加组件两类操作说明。初始化会创建 components.json 配置文件并安装基础依赖;添加组件支持单个或一次多个。
使用方式:先初始化,运行 npx taro-shadcn init。初始化时可选择组件目录(默认 src/components)、Utils 目录(默认 src/lib/utils),并安装基础依赖,包括 clsx、tailwind-merge、class-variance-authority、lucide-react-taro。随后添加组件,例如 npx taro-shadcn add button,或一次添加多个:npx taro-shadcn add button accordion badge。常用选项有 -y, --yes 跳过所有确认提示,-o, --overwrite 在组件已存在时直接覆盖。
目录结构:初始化后通常为 src/lib/utils/index.ts(导出 cn 辅助函数)、src/components/ui/button.tsx(自动生成的组件)以及根目录的 components.json 配置文件。
限制与注意:需在有效的 Taro 项目根目录下运行命令;taro-shadcn 依赖 Tailwind CSS,项目需已配置好 Tailwind;部分组件有额外依赖(如 calendar 依赖 date-fns),CLI 会提示安装。其他细节暂未提供。