用途：当 shadcn ui 项目需要从 Tailwind CSS v3 迁移到 v4，或升级后出现颜色发白、动画失效、暗色模式切换无效等问题时，按本技能提供的确定性流程处理。
主要能力：给出 v3 与 v4 在配置位置、CSS 导入、颜色格式、动画插件、暗色模式触发、ring 默认宽度、PostCSS 与 Vite 插件、@tailwind 指令、forwardRef 等方面的对照表；提供检测规则，先判断项目属于哪一代；给出按序执行的迁移步骤与逐文件修改说明；提供验证清单与决策树排查颜色、动画、暗色模式问题。
必要用法：先运行检测扫描，不要单独修改某一处信号。迁移顺序为：切分支快照 git checkout -b tailwind-v4-migration；确认 node --version 需 >= 20；运行 npx @tailwindcss/upgrade；更新依赖 pnpm up "@radix-ui/*" lucide-react recharts tailwind-merge clsx --latest；替换动画插件为 tw-animate-css；检查 token 是否为 oklch(...) 或 hsl(...)；检查 @theme inline 与 @custom-variant dark；检查 ring-2 在 v4 中视觉等价为 ring-3；用 pnpm dlx shadcn@latest add button input select --overwrite 重新生成旧组件；PostCSS 改用 '@tailwindcss/postcss'；Vite 项目使用 @tailwindcss/vite；运行 pnpm build 并做视觉回归。
适用场景：已用 shadcn ui 且需升级 Tailwind v3 到 v4 的前端项目；出现半迁移症状的项目。
限制：步骤 5 至 13 需手动完成，codemod 不保证处理动画插件替换、ring-2 改写与组件刷新；项目必须混用 v3 与 v4 语法时会产生不可预测构建。其他收费、平台或效果信息暂未提供。