About weapp-tailwindcss
weapp-tailwindcss routes development requests to specialized skills for mini-program and multi-platform projects. When a specialist skill is unavailable, it provides a safe baseline that avoids guessed configuration and protects v5 build boundaries.
Key features
- 01Routes tasks to specialized skills
- 02Covers setup, migration, and troubleshooting
- 03Guidance for runtime and custom builds
- 04Safe fallback when a specialist is unavailable
Use cases
- 01Choose a setup path for a new project
- 02Handle an upgrade from v4 to v5
- 03Investigate missing styles or runtime issues
- 04Plan dynamic classes or native-platform builds
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ sonofmagic/ skills --skill weapp-tailwindcssAfter installing, type/weapp-tailwindcssin Claude Code to confirm it loaded.
Bundled filesagents/openai.yamlreferences/safety-baseline.md
Details
From the project READMEweapp-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、现有配置和官方文档,不输出记忆中的旧示例。
Comments
Markdown supported