界面间距与一致性 Lint
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/ui-lint。
技能介绍
问题:设计系统总被小违规拖垮
组件库里最让人头疼的不是缺少规范,而是没人注意的一次性写法悄悄蔓延:text-[#3C3C3C] 这样的硬编码色值、p-[24px] 这种原始像素、w-4 h-4 旧版宽高语法,还有 ml-2 mr-4 这类只适配 LTR 的物理属性。它们在原型阶段无伤大雅,但长期下来间距、颜色、层级全都失控,换主题或做暗色模式时才逐个排查,代价很高。
技能如何工作
这个技能用基于 grep 的方式在数秒内完成一轮快速扫描,不像深度审计那样耗时。核心检查项包括:
- 硬编码颜色:
className中的 hex 色值应替换为语义 token,如text-text-primary、bg-brand - 原始像素值:
p-[24px]、gap-[12px]应改为 Tailwind 标尺值p-6、gap-3 - 旧版宽高语法:
w-4 h-4建议合并为size-4 - LTR 物理属性:
ml-2、mr-4应改为逻辑属性ms-2、me-4 - 禁用纯黑:任何纯黑色写法都应改用 skin 的
text-primarytoken - 缺失
data-slot:组件没有该属性时需要补上 - 字体大小 CSS 变量:
text-[var(--text-sm)]或--text-sm: 13px会与 Tailwind v4 的--text-*命名空间冲突(Tailwind 会把它当成颜色而非字号解析),应改为显式text-[13px] - 未使用
cn():模板字符串拼接className应统一用cn()组合
扫描完成后,如果发现违规,会针对每条违规列出具体的修复方式。
适用边界与注意点
它适合在每次文件改动后快速跑一轮,属于先拦一道的检查,不是最终质量把关。以下场景应换用其他工具:
- 需要深入的设计判断(构图、层级、节奏)时使用
/ss-review - 专注无障碍检查时使用
/ss-a11y - 需要 Nielsen 可用性启发式评估时使用
/ss-audit - 需要自动应用重构修复时,此技能只标记违规,修复仍依赖
/ss-review
使用前请确认任务与上游来源和本地项目上下文匹配,生成的代码和命令也需要在实际环境中验证,不要把它当作环境测试、安全审查或破坏性操作审批的替代品。
使用场景
- 改完组件代码后做快速检查,定位硬编码颜色和原始像素
- 把旧项目迁移到设计系统时,批量扫描残留的一次性写法
- 主题切换或暗色模式失效时,排查禁用纯黑和CSS变量冲突
- 升级Tailwind v4前,检查字体大小变量是否冲突
适合人员
- 维护公司组件库、需要统一设计系统的前端工程师
- 负责主题切换和暗色模式适配、遇到token失效的开发者
- 把旧项目迁移到Tailwind v4、需要批量替换违规写法的工程师
- 为团队制定设计规范、希望自动拦截常见违规的技术负责人