Individual skill

weapp-tailwindcss-troubleshoot

诊断 weapp-tailwindcss 与 `weapp-tw` CLI 的样式未生成、JS/模板 class 未转译、classNameSet、@source/cssEntries、source candidates、rpx、伪类/custom variant、组件隔离、Rspack、压缩、watch/HMR、H5/Web/App/uni-app x 多端产物问题。Use for debugging, troubleshooting, CLI output failures, classes not working, broken hot reload, wrong output, or runtime compatibility；不用于新项目配置、自研 API 设计或 Lynx 专属接入。

skills/weapp-tailwindcss-troubleshoot/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: No
Observed behavior: Network or broad shell
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
testing 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,311 bytes
SKILL.mdcore · 2,311 bytes
SKILL.mdcore · 2,311 bytes
agents/openai.yamlasset · 301 bytes
references/symptom-matrix.mddoc · 6,228 bytes

Read excerpt


# weapp-tailwindcss troubleshoot

从生成、转译、产物到运行时逐层定位根因，避免用配置猜测掩盖症状。

## 诊断顺序

1. 收集最小复现：框架、bundler、目标端、版本、命令、原始 class、期望与实际产物。
2. 读取 [references/symptom-matrix.md](references/symptom-matrix.md)，先归类症状，再执行对应最短路径。
3. 检查 Tailwind 入口是否为纯 CSS、是否实际进入构建图、`cssEntries` 是否为绝对路径、`@source` 是否覆盖源码。
4. 检查是否存在第二个 Tailwind 生成器，或 H5/Web 被错误 `disabled`。
5. 分别验证 CSS 候选、模板/JS safe class、最终平台样式文件和真实页面；不要只看固定的 `app.wxss` 文件名。
6. watch/HMR 问题要在同一进程连续新增 class，区分首次构建成功与增量图失效。
7. CLI 问题先确认 `web`/`weapp` target、stdin/stdout、source map 与 watch 模式，不期待它改写模板或脚本。
8. 只有根因确认后才修改配置，并补一条可重复的回归验证。