用途
本技能用于在同一个项目中同时使用 Material UI(MUI)与 Tailwind CSS,重点解决两者样式规则冲突的问题。典型触发场景包括:Tailwind 工具类无法覆盖 MUI 组件样式(通常由选择器优先级或级联层顺序导致)、需要在 Next.js 或 Vite 项目中配置 Tailwind v4、需要在 MUI 组件上使用 className 或 slotProps..className、需要把 --mui- 变量映射进 Tailwind 的 @theme,以及处理遗留的 Tailwind v3 配置或迁移。
主要能力
技能文档按主题组织,覆盖以下内容:
- Tailwind v4:@layer 顺序设置,确保 mui 层位于 utilities 之前,使 Tailwind 工具类能够正确覆盖 MUI 样式。
- Next.js:enableCssLayer 的用法;Pages Router 下 GlobalStyles 与共享缓存的配置方式。
- SPA:StyledEngineProvider 配合 enableCssLayer 的配置方式。
- 用法:根元素 className 与 slot className 的区别与选择。
- @theme:将 --mui-* 变量映射到 Tailwind @theme 的完整代码片段(文档站点提供),需要启用 cssVariables。
- IntelliSense:VS Code 的 classRegex 配置,用于在 MUI 组件属性中识别 Tailwind 类名。
- Tailwind v3:preflight、important、injectFirst、portals 等兼容性处理。
使用方式
SKILL.md 是入口文件,AGENTS.md 是完整指南,reference.md 提供可直接复制粘贴的代码片段。使用时应先阅读 AGENTS.md,再按需从 reference.md 取用片段。
适用场景
适用于在已有 MUI 项目中引入 Tailwind CSS,或在 Tailwind 项目中引入 MUI,并希望两者样式协同工作的前端开发场景,尤其是 Next.js、Vite 等常见框架下的配置与迁移工作。
限制
资料未提供该技能的具体安装命令、支持的版本范围、收费方式或效果保证等信息,这些内容暂未提供。