Agent Skills
返回列表
界面间距与一致性 Lint

界面间距与一致性 Lint

设计多媒体 更新于 2026.08.29

将以下提示词粘贴到你的 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-primary token
  • 缺失 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、需要批量替换违规写法的工程师
  • 为团队制定设计规范、希望自动拦截常见违规的技术负责人