Agent Skillssonofmagic/weapp-tailwindcss › weapp-tailwindcss-migrate

weapp-tailwindcss-migrate

GitHub

将 weapp-tailwindcss 项目从旧版迁移至 v5/Tailwind CSS 4,处理 CLI、构建配置及插件升级,确保生成链路正确。

skills/weapp-tailwindcss-migrate/SKILL.md sonofmagic/weapp-tailwindcss

Trigger Scenarios

需要升级 Tailwind CSS 到 v4 或 weapp-tailwindcss 到 v5 清理旧的 CLI patch 和重复的构建入口 修复因版本迭代导致的构建兼容性问题

Install

npx skills add sonofmagic/weapp-tailwindcss --skill weapp-tailwindcss-migrate -g -y
More Options

Use without installing

npx skills use sonofmagic/weapp-tailwindcss@weapp-tailwindcss-migrate

指定 Agent (Claude Code)

npx skills add sonofmagic/weapp-tailwindcss --skill weapp-tailwindcss-migrate -a claude-code -g -y

安装 repo 全部 skill

npx skills add sonofmagic/weapp-tailwindcss --all -g -y

预览 repo 内 skill

npx skills add sonofmagic/weapp-tailwindcss --list

SKILL.md

Frontmatter
{
    "name": "weapp-tailwindcss-migrate",
    "description": "将现有 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;不用于全新接入或单点故障排查。"
}

weapp-tailwindcss migrate

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

工作流

  1. 读取 manifest、锁文件、Tailwind 入口、bundler 配置、PostCSS 配置和运行脚本。
  2. 识别当前 weapp-tailwindcss/Tailwind/Node/HBuilderX/bundler 版本及所有生成入口。
  3. 读取 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 目标必须检查真实运行时。

迁移纪律

  • 先记录旧配置和可回滚提交,不批量删除无法确认归属的 PostCSS 或框架插件。
  • 只删除 Tailwind 生成职责的重复入口;独立 Web 应用的单独构建可继续使用官方 Tailwind 插件。
  • 不用 alwaysEscape 或扩大字符串扫描来掩盖过期 classNameSet
  • 不把构建成功等同于迁移成功;至少检查目标端 CSS、模板/JS safe class 和新增候选。

输出要求

输出迁移前诊断、删除/保留清单、逐文件 diff、验证结果和回滚步骤,并标出仍需人工验证的设备或 IDE 环境。

Version History

  • 79b1a02 Current 2026-08-20 17:09

Same Skill Collection

.agents/skills/playwright-cli/SKILL.md
.claude/skills/playwright-cli/SKILL.md
.codex/skills/content-research-writer/SKILL.md
.codex/skills/playwright-cli/SKILL.md
.codex/skills/scientific-critical-thinking/SKILL.md
skills/weapp-tailwindcss-custom-build/SKILL.md
skills/weapp-tailwindcss-lynx/SKILL.md
skills/weapp-tailwindcss-react-native/SKILL.md
skills/weapp-tailwindcss-runtime/SKILL.md
skills/weapp-tailwindcss-setup/SKILL.md
skills/weapp-tailwindcss-troubleshoot/SKILL.md
skills/weapp-tailwindcss/SKILL.md

Metadata

Files
0
Version
d2c8a45
Hash
e9e9d4d5
Indexed
2026-08-20 17:09

inicio - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-31 10:37
浙ICP备14020137号-1 $mapa de visitantes$