SuperAPI AI 工具集

visual-qa

测试与质量

查看项目

更新于 10-16 00:00

技能介绍

visual-qa 用于对游戏截图做视觉质量检查,目标是主动发现问题,而不是确认画面正常。

用途与模式:根据参数中的文件路径自动判断模式。提到参考图加一张截图时为静态模式;参考图加多张帧时为动态模式,帧间隔 0.5 秒(2 FPS);只有截图和问题时为问答模式。

后端:默认走 Gemini 3 Flash,执行 ${CLAUDE_SKILL_DIR}/scripts/visual_qa.py,并始终传入 --log .vqa.log。加 --native 则改用 Claude 视觉,用 Read 工具逐张读图直接分析,不运行 Gemini 脚本。加 --both 先跑 Gemini 再做原生分析,聚合判定:任一方 fail 即 fail,任一方 warning 且无 fail 则 warning,双方 pass 才 pass,问题列表按位置与描述去重并标注来源。

检查内容:实现质量(摆放、缩放、构图、相机视角是否贴合参考意图)、视觉缺陷(Z-fighting、贴图拉伸或缺失、几何穿插、悬浮物、阴影异常、光照泄漏、剔除错误、UI 重叠)、逻辑不一致(朝向、比例、位置、空间关系错误)、占位残留(未贴图基础体、Godot 默认材质、调试物件),以及动态模式下的运动与动画问题(卡住、抖动、滑行、物理异常、动画不匹配、相机跳变、碰撞失效)。

输出:静态与动态模式给出 Verdict、参考匹配、目标评估、问题列表(含类型、严重度、帧、位置、描述)和总结;问答模式给出答案与视觉证据。严重度 major/minor 需修复,note 为可发布的外观问题。

限制:原生分析只看图像,不看代码;动态模式依赖 0.5 秒帧间隔;具体收费、平台与效果资料暂未提供。