mergeproof

mergeproof 是拉取请求的证据关卡。它使用仓库中的一个 YAML 文件来定义一项更改在合并前必须证明什么，例如被改动模块的测试、绿色的集成作业、来自线上环境的前后对比链接，或是打开过这些链接的人。CI 强制执行该策略并在拉取请求上报告。编码智能体读取的是同一个文件，因此告诉它们的内容就是 CI 检查的内容。

该工具强调声明规则而不是描述规则。例如，规则可以规定：当更改涉及 tools/** 时，如果该工具有集成测试，则必须一并提交改动后的集成测试。证据在其来源处验证：追踪链接会被查证，测试必须在 diff 中，评审者的签核绑定到确切的提交。mergeproof explain 和生成的 AGENTS.md 章节会告诉智能体在打开 PR 之前需要产出什么，但智能体无法批准任何东西。

报告出现在人们会看的地方：评分卡评论、可设为必需的提交状态，以及相关文件上的评审评论。该工具通过 pip 安装，用入门 YAML 文件初始化，并通过要求 mergeproof 状态集成到工作流中。它旨在解决智能体式开发使结果的声明成本低廉而验证成本高昂的问题，方法是要求提供他人可以打开并检查的产物。