如果 PR 评论也是个迷你 PR
一个 PR 打开之后,常常是一个人继续写代码,其他人留言。有人找到了问题,有人知道怎么修,还有人想补一个测试。最后,这些改动还是排回 PR 作者一个人手里。
有权限的审查者当然可以直接 push 到原分支。但一旦 push,所有人看到的待审版本就变了。作者可能正在改同一个地方,其他审查者也可能还在看上一版。
如果带代码的审查评论本身就是个迷你 PR 呢?审查者从正在看的版本拉出自己的分支,把一组提交连同修改理由一起发在评论里。这个迷你 PR 可以独立跑 CI,也可以接收新的迷你 PR。
假设我给一个命令行工具加了 --output-dir。Alice 审查时发现,写入失败会留下一份不完整的文件。她在自己的分支修复了这个问题,加了一个回归测试,再把改动作为迷你 PR 发到原 PR 的评论里。
Bob 审查 Alice 的提案时,发现还少了一个场景。如果目标文件已经存在,写入失败后,原来的文件应该完好无损。他在 Alice 的迷你 PR 下再发一个迷你 PR,补上这个测试,CI 可以单独验证这组改动。Alice 采纳后,在更新过的提案上再跑一次 CI。最后,我可以把 Alice 的提案合入原 PR,修复和两个人写的测试一起进入原分支。
如果你已经在用 AI 审查代码,这个流程和你现在的做法很接近。遇到一个值得提的问题,你可以接着让 AI 在你的分支上准备修复和回归测试。多出来的工作主要是检查生成的 diff 和测试。确认改动合适后,把这组提交和本来要写的说明一起发出去。发出评论就会创建一个迷你 PR,并触发它自己的 CI。
如果你是原 PR 的作者,收到反馈时,手上就已经有一份可以试跑的改动。审查者准备各自的提案时,你可以继续推进自己的实现。提案准备好后,你可以把符合这次 PR 目标的改动合进来,再一起验证。
在同一个 PR 里,作者和审查者的分工会变得更灵活,角色甚至可以互换。双方可以直接围绕具体改动和测试结果讨论、调整方案,缩短从提出反馈到验证改动的时间。团队也可以并行推进实现、测试和文档,把开发和审查放在同一个过程中。一个人发起的 PR,可以由团队一起做完。
如果 GitHub 或你在用的代码审查工具支持这种方式,你会考虑在团队里采用吗?