weapp-tailwindcss
将泛化请求路由到专用 skill,并在专用 skill 未安装时提供不会破坏当前 v5 构建边界的最小兜底。
路由任务
- 先识别任务类型、框架、构建器、目标端和当前版本。
- 按下表优先使用专用 skill:
| 任务 | Skill |
|---|---|
| 新接入、框架配置、多端配置 | $weapp-tailwindcss-setup |
weapp-tw CLI、Web CSS、单文件小程序 CSS |
$weapp-tailwindcss-setup;已有故障转排障 skill |
| 旧项目升级、v4 到 v5 | $weapp-tailwindcss-migrate |
| 样式缺失、转译、HMR、运行端异常 | $weapp-tailwindcss-troubleshoot |
| 动态 class、merge、cva、variants | $weapp-tailwindcss-runtime |
| Core API、自研构建器、样式注入 | $weapp-tailwindcss-custom-build |
| Expo、Metro、React Native | $weapp-tailwindcss-react-native |
| ReactLynx、Rspeedy、Lynx 原生 CSS | $weapp-tailwindcss-lynx |
- 专用 skill 不可用时,读取 references/safety-baseline.md,先给出安全基线和需要补充的信息,不猜测框架配置。
- 涉及多个任务时,按“迁移或接入 -> 排障 -> 运行时优化”排序处理。
不可破坏的边界
- 当前文档与主线只维护 Tailwind CSS 4。
- 受
weapp-tailwindcss管理的同一次构建中,Tailwind 生成由WeappTailwindcss接管;不要再叠加 Tailwind 官方生成插件。 - Tailwind CSS 入口使用纯
.css,必须被项目实际引入;cssEntries只提供入口语义,不能替代构建图导入。 cssEntries使用由项目根目录解析出的绝对路径。- H5/Web 通常保留插件并由 generator 自动选择
webtarget,不要默认用disabled跳过。 - JavaScript class 转译依赖 Tailwind 验证过的
classNameSet精确命中,不使用启发式转译兜底。 @weapp-tailwindcss/cli默认输出 Web CSS;--target weapp只转换 CSS,不扫描或改写 WXML、JavaScript 与已有 WXSS。- React Native 与 ReactLynx 是两条独立原生链路:前者生成 style manifest,后者保留
className并输出 Lynx 可消费的 CSS。
输出要求
- 先给结论与适用环境,再列修改文件、配置、命令和验证标准。
- 清楚区分源码、构建产物和真实运行时证据。
- 对不确定的版本或框架行为,先读取项目 manifest、现有配置和官方文档,不输出记忆中的旧示例。