用途:在变更完成并通过最终验证后,用少量带标注的可视化画面解释结果。它用于呈现证据,不替代证据本身,应复用已验证的最终画面。
主要能力:读取最新请求与验收标准、基线与最终 diff、已捕获的最终截图或渲染证明,以及最终路由、角色、数据夹具、视口、主题或源产物;用 1 到 4 帧讲清用户操作、变化、后果与证明;对 UI 或渲染输出捕获真实最终界面,对非 UI 工作渲染真实源码、diff、报告、文档、CLI 结果或提供方回读。
使用方式:由调用方决定是否需要 walkthrough,并遵循更严格的仓库规则;需要 diff 基线时先读 baseline.md。原图与标注副本默认保存到 tmp/walkthrough/<slug>/,采用 01-<step>-original.png 与 01-<step>-annotated.png 配对命名。需要标注时读 annotation.md,使用允许的确定性标注工具。最终交付时,有 plan 页面则把标注图放上去并只回复页面链接,否则以内联绝对本地路径展示每张图并配一句说明。
适用场景:QA、产品负责人或端到端讲解;UI 与渲染输出变更;明确要求对非 UI 工作做讲解时。
限制:不得把凭据、令牌、私有 URL、客户数据、个人数据、健康数据等发送给图像工具;不得把模型图、重建 HTML 或合成画面当作已完成产品工作;不得声称标注本身证明运行时行为;预览与可下载产物的重要声明必须一致,矛盾应作为失败报告;调用方要求但无法产出时,应以缺失的工具、访问权限或产物阻塞收尾,不得静默豁免。无 UI 或渲染输出变更时记录 Walkthrough: N/A。未提供具体安装命令、收费或平台信息。