---
name: visual-verdict
description: 用于截图与参考图对比的结构化视觉 QA 判定
level: 2
---

<Purpose>
使用此技能将生成的 UI 截图与一个或多个参考图像进行比较，并返回严格的 JSON 判定结果，以驱动下一轮编辑迭代。
</Purpose>

<Use_When>
- 任务包含视觉保真度要求（布局、间距、排版、组件样式）
- 你已有一张生成的截图和至少一张参考图像
- 在继续编辑之前，你需要确定性的通过/不通过指引
</Use_When>

<Inputs>
- `reference_images[]`（一个或多个图像路径）
- `generated_screenshot`（当前输出图像）
- 可选：`category_hint`（例如：`hackernews`、`sns-feed`、`dashboard`）
</Inputs>

<Output_Contract>
仅返回 **JSON**，并严格使用以下结构：

```json
{
  "score": 0,
  "verdict": "revise",
  "category_match": false,
  "differences": ["..."],
  "suggestions": ["..."],
  "reasoning": "short explanation"
}
```

规则：
- `score`：0-100 的整数
- `verdict`：简短状态（`pass`、`revise` 或 `fail`）
- `category_match`：当生成的截图符合预期的 UI 类别/风格时为 `true`
- `differences[]`：具体的视觉不匹配项（布局、间距、排版、颜色、层级）
- `suggestions[]`：与差异项对应的可执行后续修改建议
- `reasoning`：1-2 句话的总结

<Threshold_And_Loop>
- 目标通过阈值为 **90+**。
- 如果 `score < 90`，继续编辑，并在进行任何进一步的视觉评审前重新运行 `/oh-my-claudecode:visual-verdict`。
- 在下一张截图达到该阈值之前，**不要**将视觉任务视为已完成。
</Threshold_And_Loop>

<Debug_Visualization>
当难以诊断不匹配原因时：
1. 始终将 `$visual-verdict` 作为权威决策来源。
2. 使用像素级差异工具（pixel diff / pixelmatch overlay）作为**辅助调试手段**来定位热点区域。
3. 将像素差异热点转换为具体的 `differences[]` 和 `suggestions[]` 更新。
</Debug_Visualization>

<Example>
```json
{
  "score": 87,
  "verdict": "revise",
  "category_match": true,
  "differences": [
    "顶部导航的间距比参考图更紧",
    "主按钮使用了更小的字重"
  ],
  "suggestions": [
    "将导航项的水平内边距增加 4px",
    "将主按钮的 font-weight 设置为 600"
  ],
  "reasoning": "核心布局一致，但样式细节仍有偏差。"
}
```
</Example>

Task: {{ARGUMENTS}}
