visual-qa 用于游戏画面的视觉质量保证，目标是主动找出问题而非确认画面正常。它接收自由文本参数与图片路径，按参数自动判断模式：给出参考图加单张截图进入静态模式；参考图加多帧进入动态模式（帧间隔 0.5 秒，约 2 FPS）；只给截图和问题则进入问题模式。
后端默认使用 Gemini，命令为 python3 ${CLAUDE_SKILL_DIR}/scripts/visual_qa.py --log .vqa.log，可加 --context 传入目标、需求与验证点，问题模式用 --question。加 --native 则改用 Claude 视觉，用 Read 工具逐张读图直接分析，不运行 Gemini 脚本；加 --both 先跑 Gemini 再做原生分析，并按“任一 fail 即 fail、任一 warning 且无 fail 为 warning、两者 pass 才 pass”汇总，合并去重问题并标注来源。
检查范围包括实现质量（摆放、缩放、构图、相机视角是否贴合参考）、视觉缺陷（Z-fighting、贴图拉伸或缺失、几何穿插、悬浮物、阴影异常、光照泄漏、剔除错误、UI 重叠）、逻辑矛盾（朝向、比例、位置、空间关系错误）、占位残留（未贴图图元、默认材质、调试物件），以及动态模式下的运动与动画问题（卡住、抖动、滑行、物理异常、动画不匹配、相机跳变、碰撞失效）。输出含结论、参考匹配度、目标评估、问题清单与摘要，严重度分 major、minor、note。限制：仅分析图像，不查看代码；动态模式假定帧间隔 0.5 秒；具体收费、平台与效果资料暂未提供。