UI 视觉验证专家
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/ui-visual-validator。
技能介绍
问题从哪来
前端改完样式或组件,代码 diff 通过了 CI,界面是否真的对齐设计稿、是否在 Chrome 与 Safari 上一致、对比度是否满足 WCAG,往往仍要靠人眼抽查——而「看起来差不多」和「证据上已达成目标」不是一回事。本技能把角色定位为 UI 视觉验证专家:只依据截图与可观测视觉证据做判断,默认在证明之前目标尚未达成。
技能如何工作
核心能力覆盖四块:视觉分析(像素级截图、跨浏览器/断点/暗色主题、加载与错误态)、工具链(如 Chromatic、Percy、Playwright 视觉对比、BackstopJS 等)、设计系统(令牌、间距、品牌与组件库合规)、无障碍视觉(对比度、焦点指示、文本缩放与键盘导航反馈)。
分析流程强调八步:先客观描述所见 → 对照修改目标 → 对旋转/定位/尺寸做测量 → 反向验证(主动找失败证据)→ 批判评估「不同是否等于正确」→ 无障碍与跨平台一致性 → 临界与边界态。输出需以「从视觉证据来看,我观察到……」开头,并给出达成/部分达成/未达成结论;无证据不宣布成功。
适用边界
不适用与 UI 视觉验证无关的任务,或需要本技能范围外其他领域工具的场景。操作指引要求先厘清目标、约束与输入;详细示例见资料中的 resources/implementation-playbook.md。评估中应忽略代码提示——判断仅基于视觉证据,避免把代码变更自动等同于视觉效果。
使用场景
- Storybook 组件合入前,用截图对比确认按钮、卡片在 Chrome 与 Safari 下像素级一致
- 拉取请求里新增导航栏后,在移动断点验证菜单收起与焦点指示是否符合设计稿
- 上线前检查表单错误提示、加载态与空状态是否遵循设计令牌且对比度满足 WCAG
- 暗色主题切换后,核对模态遮罩层级、表格可读性与动画过渡在各主题下无视觉回退
适合人员
- 维护组件库并在 CI 中接入 Chromatic/Percy 的前端,需要在合并前做视觉回归把关
- 负责多浏览器发布验收的 QA,需按清单系统化审计响应式、错误态与边界界面
- 设计系统负责人,要核对间距、色板与字体令牌在实现里是否与设计规范一致
- 专注 WCAG 的产品或无障碍工程师,需对焦点环、对比度与高对比度模式做可测量的视觉评估