技术英语 / 系统课时
接受修改时简洁确认完成
接受修改时简洁确认完成
采纳评审建议后,回复的任务不是礼貌地说一句“已完成”,而是让评审者立刻知道你改了什么、改在哪里,以及结果是否经过验证。掌握一套简短确认方式,可以明显减少对方重新翻 diff、追问测试情况的成本。
学习目标
- 能用简短英文明确表示已经采纳评审建议
- 能说明修改位置和实际变化,而不是只回复 done
- 能判断什么时候需要补充测试或验证信息
先回答评审者真正关心的问题
评审者提出修改意见后,通常只需要确认三件事:建议是否已经采纳、代码发生了什么变化、变化是否经过验证。因此回复不必重复讨论背景,也不需要写成长篇解释。
最稳妥的结构是:确认采纳 + 指出修改 + 必要时给出验证结果。例如对方要求补充空值处理,你可以直接说明已经在哪个方法中增加处理;如果同时补了测试,再附一句测试结果即可。
把修改位置和结果说具体
不要只写 Done、Fixed 或 Updated。这样的回复虽然表示任务已经处理,却把确认成本重新交给了评审者:对方还要打开新的 diff,自己寻找究竟改了哪里。
下面是一段可直接用于 review thread 的回复示例,它是沟通文本,不是可执行命令:
Thanks for the suggestion. I've updated `UserService#findById` to handle the missing-user case explicitly.
I also added coverage for that branch, and `UserServiceTest` passes locally.第一句确认建议已经被采纳,并指出具体修改位置与行为;第二句只补充与本次修改直接相关的验证信息。评审者即使暂时不打开代码,也能判断这条意见是否已经得到处理。
如果修改非常局部,也可以更短:Updated the condition as suggested. The new branch is covered by the existing tests. 重点不是句子数量,而是让回复中存在可核对的信息。
测试信息只写到足够确认
不是每次回复都需要粘贴完整测试日志。对于小范围重构,如果现有测试已覆盖,可以说明 existing tests pass;如果新增了测试,可以指出测试类或覆盖的场景;如果没有运行完整测试,则应明确验证范围,避免让人误以为整个项目都已通过。
例如,只运行了相关单元测试时,可以写:Verified with the affected unit tests; I haven't run the full integration suite. 这种表达既提供了验证结果,也准确声明了边界。
什么时候一句确认就够了
如果评审意见只是拼写、变量命名或明显的格式调整,而且最新 diff 中的位置非常清楚,一句 Updated as suggested, thanks. 通常已经足够。此时再重复文件名、测试范围和实现细节,反而会增加阅读噪声。
对于行为修改、边界条件、错误处理或测试补充,则应多给一层信息。可以把判断标准记成一句话:评审者如果不重新搜索代码就能确认这条意见已经正确处理,你的回复就足够简洁而完整。