用途:读取 ShipGuard 评审看板导出的修复清单(visual-tests/_results/fix-manifest.json),按人工在截图上标注的区域、说明与严重级别,定位源码中的视觉问题并实施修复,随后重新构建并重新截图,形成修改前后证据。
主要能力:按清单逐条测试处理,支持四种模式——validate-and-fix(默认,读标注截图、追踪源码、修复、重建、重截)、redo(redo_entirely 为真,按说明整体重做界面区域)、revert(revert_to_before 为真,按测试 id 找到修复提交并 git revert)、improve(improve_ui 为真且无标注,对整页做间距、对齐、层级等通用打磨)。每个测试的修复单独提交,便于后续按提交回滚。
使用方式:常用调用为 /sg-visual-fix(读取固定清单)、/sg-visual-fix latest、/sg-visual-fix <path>,以及 /sg-visual-fix --dry-run [latest|<path>] 仅生成修复计划 visual-tests/_results/visual-fix-plan.md,不改源码、不进 Git、不重建、不截图。执行前需保证 git status --porcelain 为空;随后重新构建(依据 _config.yaml 的 build_command,或自动探测)并用 agent-browser 重放测试步骤覆盖原截图。可用 node visual-tests/build-review.mjs 刷新看板,最后用 node visual-tests/build-review.mjs --stop 停止评审服务。
限制:该技能为 LLM 驱动、非确定性,同一标注可能产生不同修复;编辑文件须能追溯到被标注的路由或组件,涉及受保护文件只报告不修改,疑似需改动超过约 5 个文件时先询问。无法从截图判断问题时应如实说明,不得猜测。若修复无效,可重跑或提供更具体的标注说明。模型推荐(如 Sonnet 4.6、Opus 4.7)及收费、价格、平台等信息以官方为准,资料未提供的不作推断。