Agent Skills › sonofmagic/weapp-tailwindcss › weapp-tailwindcss-custom-build

weapp-tailwindcss-custom-build

GitHub

指导将 weapp-tailwindcss 集成至自定义构建器或高级流水线,通过构建图与内存产物接入核心转换,覆盖多框架生命周期、HMR 及分包样式隔离。

skills/weapp-tailwindcss-custom-build/SKILL.md sonofmagic/weapp-tailwindcss

Trigger Scenarios

需要自研构建工具集成 Tailwind CSS 使用非标准打包器(如 Rspack/Rollup)进行微信小程序开发 需要深度定制 CSS 生成与模块图交互

Install

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

Use without installing

npx skills use sonofmagic/weapp-tailwindcss@weapp-tailwindcss-custom-build

指定 Agent (Claude Code)

npx skills add sonofmagic/weapp-tailwindcss --skill weapp-tailwindcss-custom-build -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-custom-build",
    "description": "将 weapp-tailwindcss 集成到自研构建器或高级流水线,覆盖 `weapp-tailwindcss\/core`、generator、Vite\/Webpack\/Rspack\/Rollup\/Rolldown\/Gulp 生命周期、ModuleGraph、Tailwind Scanner\/source candidates、watch\/HMR、source map、weapp-style-injector 和分包样式隔离。Use for custom bundlers, Node API, build adapters, asset graphs, loaders, plugins, or subpackage style injection;普通框架与 CLI 配置使用 setup skill。"
}

weapp-tailwindcss custom build

围绕构建图和内存产物接入核心转换,避免用输出目录扫描补偿生命周期设计缺失。

工作流

  1. 先判断官方 Vite/Webpack/Rspack/Gulp 入口是否已满足需求;普通项目转到 $weapp-tailwindcss-setup。
  2. 确认调用方拥有的生命周期、模块图、CSS 生成结果、asset API、watch 事件和 source map 能力。
  3. 读取 references/core-api.md 设计 createCompiler() 的 root、snapshot、失效和转换时序;仅在兼容旧自动 runtime 流程时使用 createContext()。
  4. 涉及全局/分包样式注入时再读取 references/style-injection.md。
  5. 在 load、transform、loader result、compilation、bundle asset 或 stream/Vinyl 对象中维护源码和产物关系。
  6. watch 中把精确 dependency/module ID 交给 invalidate(),只重新生成返回的 root,再用新 snapshot 转换实际可达的模板和 JavaScript。
  7. 让初始扫描、transform 与 HMR 共用 Scanner 的文件范围和显式外部 source,不另建宽泛 glob。
  8. 通过 bundler API 写回产物和 source map,不直接修改输出目录。

官方 Vite、Webpack、Rspack 与 Gulp 适配器的 graph 路径已经共享 compiler session:每个插件 owner 只创建一个 compiler,按 scope 投影可达 root 的 snapshot。第三方框架可以复用同样的时序,但必须继续拥有自己的模块图、watch 调度和 asset/Vinyl 写回;不要把 bundler 对象传入 core,也不要把 module ID 当作文件系统路径。

不可破坏的边界

  • createCompiler() 管理 Tailwind root 会话、revision 和不可变 snapshot;它不接管模块图可达性、watch 调度或产物写回。
  • 同一构建周期复用 compiler,并让 CSS、模板和 JS 显式消费同一 snapshot。
  • createContext() 继续兼容自动 runtime 收集模式,不要把两种状态模型混在同一事务中。
  • transformWxss()、transformWxml()、transformJs() 返回类型不同,必须分别处理错误和 map。
  • snapshot classSet 来自 Tailwind 生成/验证结果,不把扫描到的所有字符串直接塞入集合。
  • module ID 是 opaque 值;invalidate() 不会替调用方规范化 POSIX、Windows、virtual ID 或 query。
  • 入口发现若确需文件系统扫描,集中在明确扫描层并测试;不要在 generateBundle 等后置阶段临时读源码。
  • Rspack rule condition 解析必须覆盖函数与组合条件,补丁保持幂等并仅作用于目标 CSS rule。

输出要求

输出生命周期图、数据所有权、API 调用时序、错误/缓存策略、产物写回方式和 watch 回归场景。

Version History

  • 5d9e8da Current 2026-09-23 08:25

    将官方打包工具迁移至 compiler session,增强框架编译器 API,修复 HMR 期间状态保留问题。

  • 79b1a02 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-lynx/SKILL.md
skills/weapp-tailwindcss-migrate/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
a76a24f
Hash
13ad3244
Indexed
2026-08-20 17:09

ホーム - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-09-30 03:11
浙ICP备14020137号-1