用途:该技能用于在本地同步的 Tailwind CSS v4 文档快照中检索官方指引,回答开发、配置、迁移、实现、重构与审查类问题。
主要能力:按主题(工具类、变体、配置、迁移、兼容性、实现、重构、审查)在 references/docs-index.tsx 中定位对应文档,只加载 references/docs/ 下相关文件;实现、重构或审查任务还会加载 references/engineering-playbook.md。迁移相关入口包括 upgrade-guide.mdx 与 compatibility.mdx,配置与指令见 functions-and-directives.mdx、adding-custom-styles.mdx、theme.mdx,变体与响应式见 hover-focus-and-other-states.mdx、responsive-design.mdx,核心行为见 preflight.mdx、detecting-classes-in-source-files.mdx。
使用方式:先检查 references/docs/ 与 references/docs-index.tsx 是否存在;若缺失或超过一周,需先初始化。初始化命令为:python skills/tailwind-4-docs/scripts/sync_tailwind_docs.py --accept-docs-license。该命令需要网络、git 与 Python 3,从 tailwindlabs/tailwindcss.com 拉取内容。若无法运行工具或无网络,应请用户在终端执行上述命令,待快照就绪后再继续。刷新快照同样运行该脚本,已有本地克隆时可加 --local-repo,并始终传入 --accept-docs-license。
适用场景:Tailwind v4 的日常问答、v3 到 v4 迁移检查(浏览器支持、@tailwindcss/postcss、@tailwindcss/cli、@tailwindcss/vite 等工具链变化,@import "tailwindcss" 替代 @tailwind 指令,工具类重命名与移除、前缀格式、important 修饰符位置、变体与任意值语法变化)、实现与代码审查。
限制:文档快照不随技能打包,上游仓库为 source-available 而非开源,用户须自行初始化并遵守其许可,快照仅保留在本地。若初始化受阻(无网络或无写权限),只能以 references/gotchas.md 作为有限回退,并建议查阅官方文档;实现、重构、审查任务可用 references/engineering-playbook.md 作为有限回退。MDX 中 export const title/description 视为元数据,JSX 提示块按指引文本处理。