登录·注册
BestRelay

返回刊物

四份提交说明的盲审,把准确放在文采前面

一段代码改完之后,还需要留下一条提交说明。它不是给工作量盖章,也不是替代码做宣传,而是告诉后来的人:这次改了什么,出于什么原因。模型能很快写出流畅的文字,但流畅不等于可信。把四份说明交给同一位审阅者,最值得比较的不是文采,而是每个判断有没有依据。

下面是一场用于入门讲解的假设盲审,并非真实跑分。四个模型分别记为甲、乙、丙、丁,不对应具体产品。它们收到相同材料,审阅者先看结果,再看来源,尽量避免被品牌印象带偏。

四个模型拿到相同材料才能公平比较提交说明

假设一次修改处理了重复提交问题:用户点击保存后,按钮会暂时禁用;请求结束后,按钮恢复可用;同时补充了相关测试。材料没有证明服务端能够拦截所有重复请求,也没有说明其他入口得到修复。

给四个模型的任务应保持一致:写一条简短标题,再用少量正文说明修改动机和关键行为。输入除了代码差异,还应包含必要的需求背景和已有的验证结果。缺少这些材料,模型容易把合理猜测写成事实。

这里还要区分“增加了测试”和“测试已经通过”。前者可以从修改内容判断,后者需要实际运行结果支持。审阅者若不先划清证据边界,就可能奖励一份听起来完整、实际上过度承诺的说明。

审阅者先检查事实边界再评价文字是否顺畅

在这个假设中,模型甲写道:“优化保存体验,全面消除重复提交。”句子简洁,却把按钮层面的限制扩大成了全面保证。只要仍有其他请求入口,这个结论就可能误导后续排查。

模型乙写道:“保存期间禁用按钮,请求结束后恢复操作。”它忠实描述了行为,但没有交代动机。正文若补上一句“减少用户连续点击造成的重复请求”,读者便更容易理解修改目的,而且没有扩大修复范围。

模型丙逐项复述了按钮状态和测试断言,信息基本准确,却没有组织重点。提交说明不是代码差异的逐句翻译;已经能直接看到的细节,不必全部搬进正文。

模型丁写道:“限制保存操作的重复触发”,正文再说明按钮禁用与恢复的时机,并注明新增了相关测试。它没有声称测试已经通过,也没有许诺服务端去重。在这个设定中,审阅者会优先选择丁,因为它的信息密度和承诺范围更合适。

一次示例里的胜出结果不能代表模型长期能力

这次选择只说明某份输出更符合当前要求,不能据此宣布某个模型始终更强。真实评估需要覆盖缺陷修复、功能增加、重构和文档调整等不同任务,并记录遗漏、夸大和无依据推断出现的频率。

新手可以先用三个问题自查:标题有没有说清核心变化,正文有没有解释必要动机,所有保证有没有证据。若说明写出了性能提升、安全增强或兼容性改善,就应回到材料中寻找支持,而不是因为这些词听起来专业就保留它们。

统一接入可以减少比较四份输出时的额外变量

本文由重视质量的接口中转服务 BestRelay 发布。它按请求中指定的模型转发至相应官方服务,不以其他模型替代,并覆盖多家模型提供商。它可配合 Claude Code、Codex、Gemini CLI 及任何 OpenAI SDK 使用;不过,接入方式一致并不意味着模型输出自然具有可比性,输入材料和评审标准仍需统一。

比较成本时也应保留同样的边界意识。BestRelay 按提供商报告的词元数量按量计费,缓存读取与写入分别计价,因此不能只凭说明长短推算费用。会员邀请他人充值可获得推荐佣金,但这项机制不应影响对输出质量的判断。

想亲自试一轮,可以创建一个 BestRelay 账户。

最终值得保存的,不是最像资深工程师口吻的那条说明,而是后来者读完之后,能够准确理解修改目的、行为范围和验证边界的那条记录。

想亲自试试文中提到的模型? 注册