用途:作为 Tailwind 专用代码审查器,读取代码库并运行同包技能中记录的规则,输出可执行报告,每条发现都标注权威来源。该验证器不修改代码,只报告,由开发者或后续智能体根据引用的技能实施修复。
主要能力:先检测项目为 v3 还是 v4,依据 package.json 中 tailwindcss 依赖的语义化版本、CSS 入口文件中的 @import "tailwindcss" 或三条 @tailwind 指令、PostCSS 与 Vite 配置中的 v4/v3 插件信号判断;若信号冲突会先报告 Severity-Error 不匹配。然后运行规则目录中的检查,包括:R-01 动态模板字面量类名;R-02 v4 下作用域 @apply 缺少 @reference;R-03 v4 项目中出现 v3 禁用配置键(corePlugins、safelist、separator);R-04 未定义的自定义类位于 @layer 之外;R-05 变体堆叠顺序;R-06 v4 下裸 border/ring/placeholder;R-07 面向用户字符串中的 em-dash;R-08 属性到类名的确定性映射;R-09 twMerge 顺序错误;R-10 插件缺少默认主题值。
使用方式:用户提出“validate my Tailwind code”“audit this codebase for Tailwind issues”或“run a pre-PR check on the styling changes”时触发。报告含项目状态、扫描范围、文件数、问题统计,以及每条问题的严重级别、规则代码、文件与行号、问题片段、引用的同包技能名和一行建议修复。默认仅供建议,退出码为 0,除非错误数超过配置阈值;样例 CI 步骤使用 claude --skill tailwind-agents-validator . 生成报告,并可用 grep 判断是否含 [ERROR] 决定是否失败。
适用场景与限制:适合 Tailwind 代码库审查、样式改动 PR 前审计和 v3 到 v4 迁移校验。它不能替代各领域技能,发现只引用对应技能供进一步查看完整修复目录。R-07 依据工作区 CLAUDE.md 项目规则,R-09 需人工判断意图。检测命令、v3/v4 启发式、样例与反模式见 references/methods.md、examples.md、anti-patterns.md。info 与 warning 不建议阻断 PR,错误 R-01、R-02 指示真实生产缺陷,应阻断。