SuperAPI AI 工具集

triaging-visual-review-runs

通用与其它

查看项目

更新于 10-16 03:46

技能介绍

用途:该技能用于处理 PostHog Visual Review(VR)运行。VR 是截图回归产品,CI 抓取 storybook 与 playwright 截图,与已提交的基线哈希比对,并阻塞 PR 直到每个变更快照被解决。PR 会带有 visual-review GitHub 状态检查和必需的“Visual regression tests pass”作业检查,两者在快照被批准并 finalize、容忍或隔离且作业重跑前保持红色。来自 fork 的 PR 例外,完全没有 VR 运行。

主要能力:技能教智能体串联 VR MCP 工具,回答人工审查者会问的问题,而不是用 gh pr view 并跳转 VR 网页界面。读取工具覆盖状态、范围、历史与分诊。智能体可自行解决 flake(隔离,少数情况容忍),但不能自行发布视觉变更:finalize-create 会提交基线,需要每次运行的人工明确确认。

使用方式:先判断 PR 是否来自 fork:gh pr view <n> --json isCrossRepository。若为 true 则停止,fork PR 无 VR 运行,只有仓库级 flakiness 工具仍可用。否则用证据表逐行匹配每个变更快照:来自自身变更且有意则 approve-create 后请求 finalize;无意则改代码推送;隔离故事被有意改变则按 identifier 批准后 finalize,若同时修复 flake 再加 lift-on-merge-create;修复隔离故事 flake 且渲染未变则 lift-on-merge-create;变更外故事不稳定且 hard_count ≥ 5、近 7 天 flaked 则 quarantine-create 后 recompute-create;broken 则不要隔离,报告并建议重新基线;安静历史、同宽高、pixel 且可命名噪声源则 tolerate-create 后 recompute-create;其余停止并报告。

限制:容忍应罕见,接受一个精确哈希且无法通过 API 撤销,不是绕过门禁的方式。隔离会隐藏 diff,绿色检查不代表变更未影响隔离故事。批准隔离快照需按 identifier 并 finalize,approve_all 会跳过隔离快照。finalize 是全有或全无,未完全解决会返回 409 not_fully_resolved。fork PR 的离线回退仅精确像素哈希匹配,不识别容忍或隔离,需维护者更新 frontend/snapshots.yml。不要将 fork 的 head 推送到仓库内分支以获取 VR 运行。