evidence pack
可以先理解为:PR或发布前保存验证证据的方法
交作业时不只说完成了,还把做过哪些检查、结果是什么、哪些结论连到哪些证据一起交出来。对 agent 来说,证据包不是附件,而是人类复核和后续 agent 接手的接口。
关键结构图
中心节点写 evidence pack,四条带标签的边分别连向 changed files、test results、decision trail、known risks;边上写 proof、reason、coverage、open risk。
What
交作业时不只说完成了,还把做过哪些检查、结果是什么、哪些结论连到哪些证据一起交出来。
evidence pack 是 agentic coding 和 AI 工作流中的验收方法:把“我做完了”转换成可检查证据。它通常包含变更摘要、测试结果、失败记录、关键决策、链接到 source-of-truth 的引用,以及把结论和证据连起来的 labeled edges。
When
当你要把 Coding Agent 从“看起来完成”推进到“可以复核、可以交接、可以继续迭代”时,可以调用 evidence pack。
How
证据包让人类审查从“相信 agent”变成“检查 agent 留下的证据”。最小证据包应该回答:改了什么、为什么改、怎么验证、哪里失败过、哪些结论依赖哪些证据。
Examples
一个 agent 提交 PR 时,只说“已修复”不够;它还需要给出测试命令、结果、关键 diff、未覆盖风险和失败重试记录。
在知识图谱或任务图里,如果边只写“相关”,复核价值很低;如果边写清“这个测试证明了这个行为”,它就变成 evidence-labeled edge。
来源
类型:工程实践 / 方法整理
事实线:这张卡把「evidence pack」整理为 agentic coding 和 AI 工作流中的验收方法:把“我做完了”转换成可检查证据。
依据:1000 Bricks 既有 coding agent 协作经验,并合并 2026-06-26..2026-07-05 catch-up 中关于 evidence-labeled edges 的公开材料信号。
边界:适用于 Coding Agent 的真实工程任务、上下文、验证和交付;不等于所有证据都要变成复杂审计系统。
常见误读:不要把 evidence pack 当成命令输出堆砌。关键是让结论、变更、测试和风险之间的关系可追踪。