Quanta

← 返回 Quanta 简报

每天合并 60 个 Agent 提交:提交信息与 diff 卫生的对照清单

编码 Agent 规模化ZH56 次阅读

01 · 每天合并 60 个 Agent 提交后暴露的三类信息失真

我们把编码代理的产出当同事的代码来审,前提是提交信息必须可信。在持续高负载交付的节奏里,评审卡壳的从来不是语法,而是提交信息与 diff 之间的错位。三类失真反复出现,几乎每天都在消耗合并窗口。

  • › 把实现机制写成结果:标题写的是重构了调用链,读 diff 才发现超时不再参与重试,行为其实变了。结果该进标题,机制留在正文。
  • › 一句话吞掉改动面:修复若干问题背后可能是十七个文件、两套配置开关和一次接口契约调整。代理天然倾向于概括,而评审需要的是可核对的清单。
  • › 正文空转:只有一行标题,没有取舍说明,没有风险提示,也没有为什么不采用另一种做法。三天后连代理自己都读不懂当时的上下文。

对策不是追问模型,而是把提交信息的结构写进每一次任务的约束里:标题一行说清行为变化,正文分三段,分别是改动面、取舍与风险。约束写得越具体,后续评审越接近流水线作业。

02 · 两栏对照:自由生成与模板约束的提交信息

同一批改动,我们让两条流水线各跑一遍,只改提交信息的约束方式,其余提示词保持一致,然后按五个维度对照。

  • › 标题可检索性:自由生成侧倾向使用改进、优化这类空词;模板约束侧强制写动词加对象加行为变化,检索旧改动时命中率明显更高。
  • › 改动面覆盖率:自由生成侧只描述主文件;模板约束侧要求逐项列出新增、修改、删除三类文件的职责,遗漏一眼可见。
  • › 取舍可见度:自由生成侧几乎不写放弃方案;模板约束侧固定一段要求写明本次不做什么,帮助评审判断边界。
  • › 风险标注:自由生成侧把回滚风险藏在正文末尾;模板约束侧把它提到第二段,并要求指明受影响的调用方。
  • › 可回归性:自由生成侧难以对应测试;模板约束侧要求列出验证方式,人工或自动皆可,但必须写出来。

结论很直接:模板不是形式主义,它是把评审注意力从翻译转向判断。约束写在任务开始处,比在合并前返工一遍更省。

03 · 最小 diff:一次任务一个提交,重构单列

代理最容易犯的第二个问题,是把顺手清理和功能改动揉进同一个 diff。我们的规则是三句话:一个任务一个提交,格式化与重命名单独提交,任何与任务无关的清理一律拒绝并要求拆分。

  • › 功能提交只包含实现与必要测试,diff 越小,回滚越精准。
  • › 重构提交不改行为,允许改动面大,但必须在信息里声明无行为变化。
  • › 配置提交与代码分开,避免一次回滚把开关状态一起带走。

拆分之后,评审者可以在两分钟内判断一个提交是否越界。代理侧的收益同样明显:上下文更聚焦,生成的 diff 更短,重试成本也更低。以 Claude Haiku 4.5 这类轻量模型做提交前的 diff 范围检查,把超范围改动在提交之前打回,比事后人工剔除更划算。

04 · 按真实 token 计量下的评审节奏与缓存读写

高负载团队的评审循环本身就是一笔可观的调用量。我们在 Quanta 上统一调度,一个余额覆盖 Claude、GPT、Gemini、DeepSeek、Kimi、GLM、Qwen、Grok 等模型,兼容 Claude Code、Codex、Gemini CLI 与任意 OpenAI SDK。每次调用按真实 token 计量,缓存写入与缓存读取分开计价,这让提交信息模板这类重复上下文的复用变得可核算:模板写进系统约束后,后续调用主要落在缓存读取上。

  • › 提交信息生成与整理交给轻量模型,控制单次输出长度,避免无谓的长篇正文。
  • › diff 风险评审与跨文件一致性判断交给更强的模型,例如 GPT-5.6 Sol,处理需要长上下文推理的部分。

这样的分工让预算落在真正需要判断力的地方。Quanta 对推荐他人充值的用户提供 19% 返佣,团队内部推荐时可以把这笔收益直接抵扣下一轮评审预算。

05 · 把清单固化进 Claude Code、Codex 与 Gemini CLI 的关卡

清单只有进入流水线才算存在。我们在合并前设了三道自动关卡,任何一道不通过就退回给代理重写,而不是留给人来解释。

  • › 提交信息格式关卡:校验标题长度、正文三段结构与风险段存在性,缺项直接拒绝。
  • › diff 范围关卡:比对任务声明的文件清单与实际 diff,发现无关改动要求拆分。
  • › 行为声明关卡:重构提交必须标注无行为变化,功能提交必须指明受影响的调用方与验证方式。

三道关卡跑在 Claude Code 与 Codex 的任务收尾阶段,也兼容 Gemini CLI 的工作流。代理学会的不是更会写代码,而是更会交付可评审的改动。如果你的团队正被高频 Agent 提交的评审成本拖住,现在就是开通 Quanta 账户、把这份清单接进流水线的时机。