用途:在智能体完成一个功能后留下可复核的验收证据,而不是让评审去读 diff 或手动启动应用。证据包归档在受 .gitignore 保护的 .evidence/ 目录,按 git 分支/提交和编码智能体会话编号。
生命周期由三个脚本组成:new-bundle.sh 开启证据包;capture.sh 为每个界面添加一次证据;finalize.sh 写入结论并渲染评审页。它是对全局 run / verify 技能的补充:用 run/verify 驱动应用,用本技能记录它们展示的内容。
适用时机:用户说“录个演示”“留下证据”“截个图/视频”“证明它可用”,或需要异步验收/签核,或功能刚完成希望验收产物留在对应分支/提交旁。不适用:无可运行界面(文档、注释、纯重构);只需自己驱动应用检查(用 run/verify);v1 不支持把媒体发到 PR。
使用方式:先运行 new-bundle.sh --title "login flow" --feature "...",输出 bundle_dir;随后按界面选用 capture.sh web|term|http|screen 追加截图/录像/日志/HTTP 记录;最后 finalize.sh --verdict PASS --step ... 写入结论、复现步骤并生成 MANIFEST.md。
限制:.evidence/ 媒体没有公开 URL,无法嵌入 GitHub PR;截图和日志可能泄露机密,finalize.sh --scrub 仅用 gitleaks 检查文本,图片/视频需人工过目;capture.sh web 需项目内安装 Node + Playwright,否则退出码 4 并给出安装提示;screen 在 macOS 需屏幕录制权限并配置正确的 avfoundation 设备序号。
其余细节(如各脚本完整参数、退出码、Bundled assets 等)资料已列出,此处不逐一展开。