关于 weapp-tailwindcss-runtime
weapp-tailwindcss-runtime 是用于微信小程序 Tailwind CSS 运行时封装的技能，指导如何选择 class 合并、variants 和转义相关 API。它强调运行时与构建期候选保持一致，并提供实现及验证要求。
主要功能
- 01按 class 来源选择处理方式
- 02指导 merge、cva 与 variants 的选择
- 03避免拼接不完整的动态 class
- 04处理小程序 class 转义与透传
- 05要求验证冲突及生产压缩结果
适用场景
- 01为组件实现调用方 class 覆盖
- 02为单槽或多槽组件配置 variants
- 03排查动态 class 未生成对应样式
- 04验证转义、冲突和缓存行为
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/weapp-tailwindcss-runtime确认已加载。
附带文件agents/openai.yamlreferences/runtime-guide.md
详细介绍
来自项目 READMEweapp-tailwindcss runtime
使用项目提供的运行时封装保持 class 合并、转义和构建期精确候选一致。
工作流
- 识别 class 来源：静态模板、完整字面量条件、组件外部覆盖、第三方透传或真正的运行时输入。
- 读取 references/runtime-guide.md，按任务选择最小包和 API。
- 读取各包当前 manifest 与 exports，避免把
merge/slim、merge/lite、UI CSS 或插件入口当成主入口。 - 优先使用完整 class 字面量或枚举；不要拼接
bg-${color}-500这类半截 token。 - 普通组件覆盖使用
@weapp-tailwindcss/merge；单槽 variants 使用@weapp-tailwindcss/cva；多槽 recipes 使用@weapp-tailwindcss/variants。 - 自定义封装名时检查构建期可识别标识符；需要原样透传时使用
weappTwIgnore，不要扩大全局忽略。 - 自定义 runtime factory、escape/unescape 或 rpx transformer 时保持纯函数边界，并验证缓存淘汰前后的等价输出。
关键约束
- 运行时包已经封装小程序 escape/unescape；不要先手动 escape 再交给 merge/cva/variants。
clsx只负责组合，不解决 Tailwind 冲突；需要“调用方最后覆盖”时使用 merge。- 只有会改变冲突分类的自定义 Tailwind token 才同步 merge 配置，并补冲突用例。
weappTwIgnore是精确局部保护，不是让未扫描动态 class 自动生成 CSS 的工具。- 构建期仍遵循
classNameSet精确命中，运行时封装不能补生成缺失的候选。
输出要求
输出包选择理由、可复制实现、构建期配套配置、类型约束，以及冲突、转义和生产压缩验证用例。
评论
支持 Markdown