---
name: ui-validator
description: 任何可见 UI 改动、交互变更、样式修复、响应式适配、暗色模式适配和浏览器侧回归验证都应使用。它负责在真实页面中验证实际渲染效果，而不是只看代码。用户提到 UI validate、screenshot、browser check、responsive、dark mode、视觉回归时都应触发。

metadata:
  internal: true
---

# UI Validator

铁律：没有真实渲染证据，就不能宣布 UI 改动完成。

## 工作流

- [ ] Step 1: 开发环境自检 ⚠️ REQUIRED
    - [ ] 1.1 先确认目标服务是否已启动，避免重复拉起开发服务器。
    - [ ] 1.2 明确要访问的页面、组件演示路径或交互入口。
- [ ] Step 2: 执行浏览器验证 ⚠️ REQUIRED
    - [ ] 2.1 至少检查默认主题和暗色模式。
    - [ ] 2.2 必要时检查移动端与桌面端视口。
    - [ ] 2.3 对关键交互执行点击、悬停、输入或状态切换。
- [ ] Step 3: 留证据
    - [ ] 3.1 优先使用截图、可访问性快照或计算样式值作为证据。
    - [ ] 3.2 记录问题发生条件，而不是只说“样式不对”。
- [ ] Step 4: 回归结论
    - [ ] 4.1 明确哪些场景通过、哪些仍有问题。
    - [ ] 4.2 如果发现回归，反馈到前端实现阶段处理。

## 重点检查

- light / dark 模式。
- desktop / mobile 布局。
- 关键交互状态。
- 对比度、间距、圆角、层级、溢出和禁用态。

## 反模式

- 不开页面，只读代码就宣布 UI 正常。
- 只看一张截图，不验证交互状态。
- 不说明问题发生条件和视口尺寸。

## 交付前检查

- [ ] 已在真实页面验证关键场景。
- [ ] 已留截图、快照或样式值证据。
- [ ] 已覆盖至少两种主题或关键视口。
- [ ] 结论中明确了通过项与残余问题。