SuperAPI AI 工具集

visual-verdict

设计与创作

查看项目

更新于 10-15 15:10

技能介绍

用途

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 流程。

限制

资料未提供关于平台、收费、价格、具体安装步骤或效果保证的信息。