用途:为 React、Next.js、Vite 应用实现、评审与重构可维护的前端样式,帮助在 Tailwind CSS、CSS Modules/SCSS 与全局 CSS 之间做出层级选择。
主要能力:给出样式方案优先级——优先 Tailwind class(布局、间距、排版、颜色、边框、响应式、主题与交互状态),其次 .module.css/.module.scss(复杂选择器、伪元素、关键帧、第三方覆盖等局部规则),再是全局 CSS(reset、@font-face、主题令牌等),最后 inline style(运行期值,优先经 CSS 自定义属性传递)。提供检查仓库、选择样式层级、处理依赖与迁移、实现或评审、验证的完整工作流,并给出完成标准。
使用方式:先读取组件、相邻样式、package.json、框架配置、Tailwind 版本、Sass 依赖、全局入口、设计令牌、class 合并工具及 lint/format 脚本;确认 Tailwind v3 还是 v4,不混用语法;确认是否已有 clsx、cn、CVA、tailwind-variants、tailwind-merge 及 colocate 约定。随后选择最浅的可维护方案:可复用的视觉与结构优先抽 React 组件,而非共享 CSS 大类。缺少 Tailwind 或 Sass 时,先列出拟新增依赖、配置、入口与迁移范围并请求批准,获批前不安装依赖、不改构建配置、不展开全仓迁移。Tailwind 任务须读 references/tailwind-patterns.md,Module 或 Sass 复用任务须读 references/scss-modules-patterns.md,评审与迁移建议须读 references/review-playbook.md。只改任务所需文件。
验证:运行仓库已有的 formatter 或 Tailwind class sorter、Stylelint、ESLint、类型检查、组件或视觉测试、Next.js/Vite 生产构建;并人工确认响应式断点、hover/focus-visible/disabled 状态、暗色主题、减少动态效果偏好与生产 CSS 顺序;无法运行的检查须明确报告。
限制:不得静默改写项目样式架构,发现与仓库规则冲突时说明差异并请求决策;不把「实现一个组件」理解为迁移整个项目;不得把运行期可枚举状态写成动态拼接的 Tailwind class;不新增巨型共享样式文件。具体依赖版本、收费与价格信息暂未提供。