用途
本技能围绕 Tailwind CSS v3 的实用优先(utility-first)样式方式,提供安装配置、响应式设计、暗色模式、事件/状态修饰符、配置文件自定义、指令与布局实践等系统化指导。适合需要可复用判断、领域约束或成熟工作流的任务,而非临时性的零散建议;当任务与 tailwind-css 无关,或存在更专门的其他技能时,不应使用本技能。
主要能力
- 提供 Tailwind CSS v3 的安装与初始化流程(Next.js 集成、独立项目 npm 安装、配置生成、input.css 引入、CDN 原型用法)。
- 讲解实用类相对于传统自定义 CSS 与内联样式的设计系统优势:可复用一致、支持响应式断点与状态变体。
- 覆盖响应式设计:移动优先断点(sm/md/lg/xl/2xl 及对应 min-width),以及仅在某区间生效的写法(如 sm:max-lg:)。
- 覆盖事件与状态修饰符:hover、active、focus、disabled、required、invalid、first、last、odd/even 以及 group 父级悬停联动。
- 覆盖暗色模式:默认跟随系统,以及基于 class 的手动切换配置与 JS 切换方式。
- 覆盖样式复用:@apply 与 @layer 指令,用于组件类与基础样式(标题、链接等)。
- 覆盖 tailwind.config.js 自定义:自定义颜色及色阶、自定义断点、自定义间距、禁用核心插件、类名 safelist、插件(如 @tailwindcss/typography、@tailwindcss/forms)。
- 提供布局、排版、间距、尺寸、边框、阴影、透明度、过渡等快速参考,以及按钮、卡片、徽标、输入框、响应式导航等常见组件模式。
- 给出最佳实践与反模式提示(如不要在 content 中包含 CSS 文件、使用完整类名、慎用 @apply、使用 extend 而非覆盖等)。
使用方式
按工作流执行:先阅读 SKILL.md,再按需加载引用的深入文件;应用技能中有序的指导、检查清单与决策规则,而不是抽取孤立片段;产出交付物时明确假设、风险与后续工作。质量上保持面向执行、简洁、与仓库基线工程标准一致,优先确定性、可审查的步骤,避免把示例当作可直接复制的真理、避免默认加载全部引用文件。
适用场景
需要搭建 Tailwind CSS v3 样式体系、实现响应式与暗色模式、配置主题(颜色、间距、断点、插件)、处理组件样式复用、审查主题与断点覆盖及暗色模式一致性,或进行设计、编码、评审、迁移计划、审计、文档等交付物的任务。证据产出示例为 Markdown 主题与响应式审查文档(如 docs/web/tailwind-theme-audit.md),审查设计令牌、断点覆盖与暗色模式一致性。
限制
不适用于与 tailwind-css 无关的任务,或存在更专门配套技能可更好处理的场景;若请求只需简单答案且本技能的约束与参考无实质帮助,则不应使用。所需输入包括相关项目上下文、约束与具体待解决问题,并确认期望交付物(设计、代码、评审、迁移计划、审计或文档)。当无法依据已有上下文完成任务时,需明确假设、权衡与未解决缺口。文中提及的“使用链接与配套技能”部分未提供具体清单内容,相关内容暂未提供。