用途
visual-verdict 是一个结构化视觉 QA 判定技能,用于将生成的截图与参考图进行对比,输出确定性的通过/不通过指导。它适用于以下情况:
- 任务包含视觉保真度要求(布局、间距、字体排版、组件样式)
- 用户拥有一张生成的截图和至少一张参考图
- 需要在继续修改前获得确定性的通过/不通过指导
主要能力
该技能只返回 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 句总结
使用方式
调用时传入任务参数({{ARGUMENTS}})。技能会依据上述输出契约返回 JSON 结果。
阈值与循环
目标通过阈值为 90 分以上。如果分数低于 90,应继续编辑,并在任何进一步的视觉审查之前重新运行 /oh-my-claudecode:visual-verdict。在下一张截图达到阈值之前,不应将视觉任务视为完成。
调试可视化
当不匹配诊断困难时:
- 保持 $visual-verdict 作为权威判定
- 使用像素级差异工具(pixel diff / pixelmatch overlay)作为辅助调试手段定位热点
- 将像素差异热点转化为具体的 differences[] 和 suggestions[] 更新
适用场景
适用于需要将生成截图与参考图进行视觉对比、并希望获得结构化评分与修改建议的视觉 QA 流程。
限制
资料未提供关于平台、收费、价格、具体安装步骤或效果保证的信息。