让 agent 产出前后截图对比图:比读文字更快审查 UI 改动
EdHinchliffe · x · 2026-11-18
Ed Hinchliffe 分享了一个提升 agent 产出可审查性的做法:对涉及 UI 的改动,让 agent 生成一张带标注的前后截图 contact sheet(同一页面、相同 seed 数据,分别在 main 分支和 feature 分支截图后拼合标注)。
他认为这是信息带宽最高的审查方式,人们更愿意看图而不是读一堵文字墙。配图给出了完整可复现流程:
- Capture:用 git worktree add --detach 建 main 与 feature 两个工作树,各跑 bun install && bun run build;复用 integration test 里的浏览器旅程截屏到 pre-shots/after-shots,1440x1000 视口,滚动到改动处,仅必要时用 fullPage;在两个树里都跑 bun test --timeout 300000(需要 TESTDATABASEURL);最后 git worktree remove --force 清理。
- Annotate:标注用手绘风 rough.js 边注,放在前后两列之间的 gutter,不遮 UI;指代不清时用 bracket / underline 标记,脚本从标注画引线指向对应位置。
核心主张:与其让 LLM 产出更多 mermaid 图和 markdown,不如把产出物变成视觉上易理解的形式,这才能真正加速团队协作和建立信任。