UI 质检官
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_742b34a0/ui-quality-inspector 并确认可正常出质检报告。
技能介绍
它解决什么问题
AI 生成的前端页面在交付时,最常见的失败不是「跑不起来」,而是「看起来还行」——间距不统一、对比度不够、文本溢出容器、该有的聚焦态没有。这类问题在 code review 里很难被抓住,因为审查者关注的是逻辑和结构,不是像素和可访问性。等到设计或产品在验收阶段截图对比,返工成本已经花出去了。
UI 质检官 把这件事从「人眼看一遍」变成一次可重复的质检:它不负责写代码,也不做任何转码,只对 AI 新交付的 HTML 产物做量化验收,并给出「通过/不通过」的明确结论。
核心机制
规则的唯一事实源是 03-标准/redlines.yaml,由人手工编辑。想调整阈值或新增红线,只改这一个文件,不需要动判定逻辑。质检引擎位于 engine/,零依赖的 Node.js 实现,Node 18 及以上可直接运行;测试样本在 04-测试/v32-test/,用于回归验证规则改动是否引入误报。
报告固定包含四部分:带行号的问题清单、总分、通过或不通过的判定,以及每条问题的修复建议。修复建议是给生成侧 AI 的提示词,不是直接改代码。不想跑引擎时,把 HTML、设计稿或截图丢进对话,AI 会按同一套规则走查,输出格式一致。
评分有几条硬约束,写在「诚实评分铁律」里:先列问题再扣分,不允许先打高分再找补;不允许自评高分实际低分;判不了的项标「需人眼确认」,不编造证据;总分低于 60 直接判必须重做,拒绝交付。宁可把合格的产物打回,也不放行一件带隐患的交付物。
适用边界
输入是所有 HTML 化的产品 UI:Web/H5 页面、组件库页面、小程序导出页。非 HTML 输入(UI 源码或业务逻辑代码)不会硬跑,而是引导到正确的用法——逻辑代码交给 linter,本技能不越界。
存量老站和历史代码不是它的目标对象,它面向的是 AI 新交付物的还原质检与接活验收。另外它只做质检不做转码,最终是否放行仍由人决定;主观项会明确标注需要人眼确认,不会替用户做最终决策。
使用场景
- 生成侧 AI 输出页面后,测试工程师跑引擎出报告,决定这一版能不能交付
- 组件库改完样式,开发者想确认间距、对比度、焦点态是否仍符合规范红线
- 小团队没有专职设计验收,接活方需要按红线标准判断甲方 AI 生成的交付页是否合格
- 设计师拿到实现截图和原始设计稿,想标出主观项中哪些必须人眼确认
适合人员
- AI 应用的测试工程师,要决定生成页面是否达到交付标准
- 前端或组件库开发者,想在提交前验证样式是否符合可编辑的红线规则
- 接活交付的小团队负责人,需要按量化标准拒绝不合格页面而非凭感觉
- 验收 AI 生成页面的设计或产品人员,需要一份带行号问题清单来指导返工