Individual skill

weapp-tailwindcss-migrate

将现有 weapp-tailwindcss 项目迁移到当前 v5/Tailwind CSS 4 生成链路，处理旧 `weapp-tw patch`、旧版 CLI init/Sass/Less/目录扫描、tailwindcss-patch、官方 PostCSS/Vite 插件、相对 cssEntries、H5 disabled、Webpack 4、Node/HBuilderX/ESM 要求。Use for upgrade, migration, legacy CLI cleanup, v4-to-v5, or deprecated setup removal；不用于全新接入或单点故障排查。

skills/weapp-tailwindcss-migrate/SKILL.md

Read pinned source

Source commit 30b9e52332aa7f7da1df460bd9f17255988e2037

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: No
Skill scan complete: Yes
Observed behavior: Instructions only
Last checked: Nov 7, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 1,865
Repository last updated: Nov 7, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

mp Repository topic
weapp Repository topic
tailwindcss Repository topic
webpack Repository topic
postcss Repository topic
mini Repository topic
tailwind Repository topic
vite Repository topic
tarojs Repository topic
uni-app Repository topic
engineering Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

SKILL.mdcore · 2,107 bytes
agents/openai.yamlasset · 284 bytes
references/v5-migration.mddoc · 3,655 bytes

Read excerpt


# weapp-tailwindcss migrate

从职责边界和构建图迁移旧项目，不在旧配置上叠加补丁。

## 工作流

1. 读取 manifest、锁文件、Tailwind 入口、bundler 配置、PostCSS 配置和运行脚本。
2. 识别当前 weapp-tailwindcss/Tailwind/Node/HBuilderX/bundler 版本及所有生成入口。
3. 读取 [references/v5-migration.md](references/v5-migration.md)，按依赖、入口、插件、目标端、验证顺序迁移。
4. 删除旧 patch 和同一次构建中的重复 Tailwind 生成器，再注册当前 `WeappTailwindcss`。
5. 旧 CLI 用户迁移到独立 `@weapp-tailwindcss/cli` 5.x，并将 `init`、预处理器和目录扫描职责移回项目构建链。
6. 将 Tailwind 入口迁移到纯 CSS，保证实际导入，并将全部真实入口写为绝对 `cssEntries`。
7. 移除“一律禁用 H5/Web”的旧逻辑；让 generator 自动识别 Web target。
8. 用一次干净构建、一次新增任意值 class 和一次 HMR 更新验证迁移；App 目标必须检查真实运行时。