目录
要在不读代码的情况下合并拉取请求,需要可靠的质量检查,以及将通过这些检查视为允许合并的明确共识。如果开发者即使遵循了约定流程,仍因没有读代码而受到责备,那么人工审查依然是隐含要求。
要点#
- 自动检查必须验证需求、确认审查意见已得到解决,并在缺少必要依据时阻止合并。
- 团队需要就哪些变更可以无需人工批准就继续推进,以及发生缺陷时由谁负责达成共识。
- 设计讨论和知识共享需要有强制拉取请求审查之外的渠道。
- 从严格限定的范围开始,制定升级处理规则,并审计结果。
定义合并条件#
“盲合并”是指无需人工阅读代码即可合并变更。即便如此,仍需有依据证明变更符合团队的质量标准。
请将这些标准写成明确的条件。以下四点可作为起点。
1. 通过测试验证要求的行为,包括相关的失败场景。 2. 通过自动审查检查适用的设计和安全规则。 3. 解决审查意见,并重新检查修改后的代码。 4. 所有必需检查均无跳过、无法判定或未解决的情况。
只有当背后的检查覆盖了重要风险时,成功状态才有价值。在取消人工批准之前,请先弄清这些检查实际验证了什么。如果没有将需求转化为有意义的测试,即使测试通过,也不能证明需求已经实现。
将批准机制明确为方针#
引入 AI 审查,并不意味着合并权限也会自动下放。有些团队接受 AI 生成的反馈,但仍要求开发者做出最终判断。
在改变工作流程之前,请先明确这一区别。开发负责人和相关团队成员需要就适用的变更、允许合并的依据,以及需要人工判断的条件达成共识。请将共识记录在开发参与者能找到的地方。
责任的处理也应遵循这一方针。如果开发者遵循了已批准的流程,却仍有缺陷被遗漏,就应调查流程哪里出了问题。请指定故障处理负责人,并改进检查。仅仅因为开发者没有读代码就责备他们,等于在未明说的情况下恢复强制人工审查。
保留审查原本承担的作用#
代码审查往往同时承担多种作用:确认实现质量、解决设计疑问,以及帮助同事理解变更。即使将第一项自动化,其余作用也不会自动得到发挥。
请在工作流程中明确安排这些活动。
- 在实现之前讨论影响重大的设计决策。
- 通过文档或演示分享行为变更。
- 记录自动审查工具应检查的架构约束。
- 明确 AI 智能体可以自行做出的设计决策。
这样可以避免一个实际问题:取消了审查批准,却仍要依赖审查讨论串来理解系统。即使不必通过讨论阻止每次合并,也仍需要质疑决策、交流反馈的渠道。
自动执行约定的工作流程#
编排工具可以强制执行团队批准的流程。例如,TAKT 可以定义执行顺序,以及根据结果选择的分支。流程可以是:实现变更并进行审查,发现问题就返回修改,通过必需检查后再继续。
这里的区别很重要。即使能够确定性地控制工作流程,也不意味着 AI 审查工具的判断一定正确。即使能确保执行审查环节,审查仍可能漏掉缺陷。请同时评估流程的执行情况,以及由此得出的结论质量。
请明确停止条件。如果无法执行必需检查,就必须停止推进。审查结果相互矛盾,或变更超出已批准范围时,也应如此。遇到这些情况,应附上足以支持判断的信息,交由指定的负责人或角色处理。
从小范围开始,检查结果#
不要一次性取消所有拉取请求的人工批准。请选择一种范围有限的变更,例如文档更新或现有组件内的接口变更。确认检查能够区分适用的变更和需要升级处理的变更。
在首次试行中,请抽查 10 个已合并的拉取请求,并检查所有已报告的缺陷。确认测试是否覆盖了要求的行为、审查意见是否已解决,以及升级处理规则是否有效。10 个是实用的起始数量,并不能证明流程安全。
请根据获得的经验修订方针。对于漏掉的缺陷,可能需要改进测试、强化审查指令或缩小适用范围。如果集成时反复失败,也可能需要检查依赖关系或目录结构。只有获得依据后,才扩大适用范围。
下一步#
针对一种变更,编写一页合并方针,明确必需检查、升级处理条件,以及发生缺陷时的负责人,并在启用自动合并之前,取得开发负责人和相关开发参与者的同意。
来源: https://zenn.dev/nrs/articles/c777388530aa84
目录
