Tailwind CSS
Tailwind CSS 疑难杂症诊断与修复专家
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Tailwind CSS。 它的用途是：Tailwind CSS 疑难杂症诊断与修复专家 完整的 Skill 内容见：https://321skill.com/skills/tailwind-css-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我的Tailwind CSS项目中，`hover:bg-blue-500` 在按钮上不生效，但其他样式正常。我已经在 tailwind.config.js 中启用了 hover 变体，请帮我排查。' 它会先检查类名拼写，然后确认是否有其他CSS覆盖（如 `!important` 或更高特异性选择器），再检查 `content` 路径是否包含了该按钮所在的文件，最后建议使用 `@layer` 或 `@apply` 来确保优先级。如果问题依然存在，它会提示检查构建工具是否缓存了旧的CSS输出。
介绍
Tailwind CSS 开发中经常遇到类名不生效、样式在开发环境正常但部署后消失、动态构建的类名（如 bg-${color}-500）不渲染、hover: / group-hover: / dark: 等变体不触发，或者 @apply 在 Vue / Svelte / CSS Modules 中报错等问题。这些问题的根源往往不是 CSS 机制本身，而是 Tailwind 的构建配置、变体启用、JIT 引擎、Preflight 覆盖或框架集成方式。本 Skill 专注于诊断和修复这类 Tailwind 专属的疑难杂症。
使用时，直接向 AI 描述你遇到的具体现象——例如“我的 hover:bg-red-500 在悬停时不生效”或“打包后样式丢失”，AI 会逐步排查：检查类名拼写、确认变体是否在 tailwind.config.js 中启用、分析 CSS 输出文件、验证构建配置（如 purge / content 路径）、排查 @apply 的 scope 限制，甚至模拟 v3 到 v4 的迁移过程。
适合所有使用 Tailwind CSS 的前端开发者、全栈工程师和 UI 设计师，尤其是那些在项目中深度定制主题（自定义颜色、断点、字体、动画）或需要将 Tailwind 集成到 Vite、Next.js、Astro、SvelteKit、Rails、Laravel 等框架中的开发者。
使用建议：提供尽可能完整的上下文——包括 Tailwind 版本、配置文件片段、出问题的代码块、框架名称和构建工具。如果问题涉及动态类名，请一并展示拼接逻辑；如果是构建后样式丢失，请提供 tailwind.config.js 中的 content 路径。这样能帮助 AI 更快定位问题。
核心特点
区别于通用 CSS 调试技能，本 Skill 内置了 Tailwind 的 JIT 引擎、变体系统、`@apply` 行为、Preflight 覆盖机制以及 v3→v4 迁移细节，能精准诊断动态类名不渲染、`@apply` 在组件作用域失效、`dark:` 不触发等 Tailwind 专属问题，而非笼统的 CSS 排查。
注意事项
不处理 CSS 层叠上下文、Flex 尺寸计算、Grid 定位等纯 CSS 机制问题，也不适用于未使用 Tailwind 的项目。
常见问题
为什么我的 hover 样式不生效？
检查是否在 `tailwind.config.js` 的 `variants` 中启用了 `hover`，或者是否有其他 CSS 通过更高优先级覆盖了它。如果是在 `@apply` 中使用，需要确保 `hover:` 变体在 `@apply` 的上下文中被支持。
如何从 Tailwind v3 升级到 v4？
v4 移除了 `@tailwind` 指令，改为 `@theme` 配置；`tailwind.config.js` 被 `@theme` 块替代；部分工具类名有变更（如 `shadow` 系列）。AI 可以帮你自动转换配置文件，并列出需要调整的类名。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/tailwind-css-x-4/raw/index.md 读取 Tailwind CSS 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/tailwind-css-x-4/raw/index.md（查看排版版本）