AI 编程审查证据收集请求模板
AI 编程审查证据收集请求模板
当对方只有一句痛点、截图或 agent 自评时,不要立刻下结论。先用这份模板把材料收束成 5 项最小证据:命令、状态、失败摘要、agent 结论和改动范围。
使用时机
适合使用:
- 对方说“AI 改坏了”“Agent 跑完但我不放心”,但没有可复核命令;
- 对方愿意提供脱敏材料,却不知道你需要什么;
- 你只想判断是否进入一次 30-60 分钟只读审查,而不是马上接手修复。
不适合使用:
- 对方要求你登录生产环境、接收密钥、导出用户数据或查看完整私有仓库;
- 对方只能提供二手转述,且不愿补任何命令、日志或 diff 摘要;
- 你已经拿到 PR、失败命令和授权边界,此时应进入 。
复制即用版本
可以,我先不直接判断“AI 写得好不好”。为了让这次审查可复核、也避免你暴露敏感信息,请只补下面 5 项最小证据,能脱敏就脱敏:
1. 原始命令和状态:你或 agent 最后运行过什么命令?exit code / pass / fail / not run 分别是什么?
2. 当前仓库状态:是否有未提交改动、生成文件、测试产物或依赖变更?只需要文件类别或相对路径摘要,不要发密钥或完整私有代码。
3. 失败或担心点摘要:最担心的一个问题是什么?例如测试红灯、构建失败、业务逻辑不确定、安全/数据风险、reviewer 不信任。
4. Agent 自己的结论:agent 最后声称完成了什么?它有没有写明未验证项、失败命令或下一步?
5. 改动范围:这次主要改了什么类型的文件?例如前端组件、脚本、后端接口、数据库迁移、配置、文档。
请不要发送密钥、用户数据、生产日志、内部截图或完整私有仓库。如果某一项暂时没有,就写 not available。拿到这 5 项后,我只会先给一个 Continue / Narrow / Stop 判断和下一条最安全验证命令;证据不足的地方会标成 Unverified,不会包装成确定结论。结构化表单版本
| 字段 | 对方要提供什么 | 可接受证据形状 | 不接受 |
|---|---|---|---|
| Command status | 最后运行的命令、exit code、pass/fail/not run | npm test -> fail 1、cargo test -> pass、not run because ... | “应该没问题”、只发截图不写命令 |
| Workspace status | 未提交、生成物、依赖变更的摘要 | 相对路径类别、M src/...、?? reports/... | 密钥、完整私有源码、生产数据 |
| Risk summary | 当前最担心的一点 | 一句话风险、失败类型、reviewer 疑问 | 多个泛泛担忧、没有优先级 |
| Agent claim | agent 最后报告的完成项和未验证项 | final report 摘要、commit hash、验证命令 | 只说“AI 说完成了” |
| Change scope | 改动涉及的文件类型或模块 | PR 摘要、目录类别、相对路径 | 要求你自行探索整个私有仓库 |
收到证据后的分流
| 证据状态 | 判断 | 下一步 |
|---|---|---|
| 5 项齐全,且没有敏感信息 | Continue | 进入只读审查,按 标 P0 / P1 / P2 |
| 有命令和风险,但缺仓库状态或 agent 结论 | Narrow | 只追缺失字段;不要扩大成完整咨询 |
| 只有截图、感受或二手转述 | Narrow | 要求补一条原始命令和 exit code |
| 需要生产权限、密钥或用户数据才能判断 | Stop | 拒绝接收敏感材料,要求重发脱敏摘要 |
| 对方只想聊工具选型 | 转内容沟通 | 不进入 AI 编程审查交付链 |
发送前检查
- 只要最小证据:目标是判断下一步,不是让对方交出全部上下文。
- 先保护边界:明确不要密钥、用户数据、生产日志、内部截图或完整私有仓库。
- 证据不足不升级结论:没有命令或状态时,只能写
Unverified / Next evidence needed。 - 优先拿原始命令:如果只能追一项,先追命令、exit code 和 not-run 原因。
- 保持可公开降级:公开案例只保留证据形状,不保留客户名、业务细节或私有路径。
与后续文档的衔接
- 证据请求前,用 先确认目标、范围和公开边界。
- 收到最小证据后,用 判断当前处于补证据、交付首份报告还是停止。
- 风险已经清楚时,用 压成 P0 / P1 / P2。
- 进入正式交付时,按 做 30-60 分钟只读审查。
- 如果仍缺关键证据,把结果写入 ,并以
Narrow收尾。
Pass means:拿到命令状态、仓库状态、失败摘要、agent 结论和改动范围,且没有接收敏感材料。
Fail means:对方只能提供不可复核描述,或判断必须依赖生产权限、密钥、用户数据或完整私有仓库。
Next evidence needed:优先补一条原始命令、exit code、not-run 原因或脱敏后的 git status --short 摘要。