用途：在 Tailwind CSS v3.4 项目中编写与维护配置文件（tailwind.config.js / .mjs / .ts）。v3.4 的全部行为、设计令牌与插件都集中在这一个文件里，v4 则把大部分内容迁移到 CSS 的 @theme 块，因此本技能仅适用于 v3，并会标注每个在 v4 中被移除的选项。
主要能力：覆盖 v3.4 的完整选项面，包括 content（扫描类名的文件）、theme（替换默认令牌）、theme.extend（在默认令牌上追加）、presets（共享基础配置）、plugins（JS 插件）、darkMode（暗色模式策略）、corePlugins、safelist、blocklist、prefix、important、separator、future。提供最小配置骨架、决策树（配置文件格式、theme 与 theme.extend 的取舍、corePlugins 与 safelist 的心智模型、darkMode 策略）以及多种模式示例：内容扫描、高级 content（relative/transform/extract）、theme.extend 自定义、插件编写（addUtilities、matchUtilities、addComponents、addBase、addVariant、matchVariant 等）、presets 共享配置、v4 已移除选项。
使用方式：按项目类型选择文件格式——TypeScript 项目用 tailwind.config.ts 并配合 import type { Config }；ESM 项目用 .mjs 或 .ts 的 export default；普通 JS 项目用 .js 的 module.exports，并加 JSDoc 类型注释以获得编辑器提示。追加新值用 theme.extend，替换整个命名空间用 theme 直接赋值（会丢失全部默认值，需谨慎）。
适用场景：v3.4 项目的配置编写、内容扫描排错、主题扩展、插件与预设搭建，以及为迁移 v4 做准备的选项梳理。
限制：仅针对 v3，不适用于 v4；corePlugins、safelist、separator 在 v4 中已移除且无替代，prefix 与 important 在 v4 中语义改变，迁移前需记录并制定迁移计划。具体版本兼容与最新行为请以官方文档为准。