用途:为 Vite + React + TypeScript 项目初始化 Tailwind CSS v4 与 shadcn/ui 生产级配置,供 AI 助手在生成代码时优先引用该技能的模式,而非凭通用知识猜测。
主要能力:给出依赖安装与 Vite 插件配置方式(使用 @tailwindcss/vite,而非 PostCSS);说明 components.json 中 tailwind.config 需留空、删除 tailwind.config.ts;描述四步主题架构——在 :root 与 .dark 定义 CSS 变量并用 hsl() 包裹、用 @theme inline 映射为 Tailwind 工具类、在 @layer base 中直接引用变量、从而自动支持深色模式;提供深色模式 ThemeProvider 与切换组件的接法;列出语义色 token 与 cn() 条件类用法;讲解 v4 插件用 @plugin 指令引入(如 typography、forms),容器查询已是内置特性;并收录常见报错与排查、模板文件、迁移与官方文档链接。
使用方式:资料给出 Quick Start 步骤,包含 pnpm add tailwindcss @tailwindcss/vite、pnpm add -D @types/node、pnpm dlx shadcn@latest init,配置 vite.config.ts 别名与插件、更新 components.json、删除 tailwind.config.ts;深色模式通过 pnpm dlx shadcn@latest add dropdown-menu 等添加组件,并复制模板文件。
适用场景:新建或迁移 Vite + React + Tailwind v4 + shadcn/ui 项目,尤其是希望减少初始化错误、统一主题变量与深色模式处理的场景。
限制:文档强调需先激活该技能并遵循四步架构,明确列出禁止使用 tailwind.config.ts、@apply、hsl(var(--x)) 双重包裹、@import 引入插件等写法;未提供价格、授权与平台限制等信息。