用途:该技能用于处理 PostHog Visual Review(VR)——CI 抓取 Storybook 与 Playwright 截图,与已提交基线哈希比对,未解决前阻止 PR 合并。技能教智能体串联 VR MCP 工具,回答评审者关心的问题,而非跳转 VR 网页界面。
主要能力:读取工具覆盖状态、范围、历史与分诊,包括运行列表、单次运行详情、快照列表、仓库 flakiness、快照历史、计数、已容忍哈希、仓库信息、隔离列表、容忍堆积与隔离解除请求。分诊工具可批准、容忍、隔离、解除隔离、重算与最终定稿。
使用方式:先判断 PR 是否来自 fork,用 gh pr view <n> --json isCrossRepository;fork PR 没有 VR 运行,只能报告。再按证据决定动作:真实且有意变更用 approve-create 后请求 finalize;非有意则改代码推送;隔离故事被有意改动需按 identifier 批准;修复 flake 用 lift-on-merge-create;外部故事不稳定且 hard_count ≥ 5、近 7 天 flaked 可 quarantine-create 后 recompute-create;broken 基线应报告并建议重新基线;安静历史、同宽高、pixel 且能命名噪声源才 tolerate-create。
限制:finalize-create 不可逆且需逐次人工确认;容忍无法通过 API 撤销;隔离默认 30 天;批准后仍需 finalize 才提交基线;recompute-create 才会重跑 CI 作业使必需检查变绿;fork PR 无 VR 运行,离线回退仅精确哈希匹配,不支持容忍与隔离。