一个输入文件改动之后,代码交接就可能变得难以复现。补丁也许还在,但样本数据、配置或预期结果描述的已经是项目的另一个状态。把AI辅助的改动交给评审者之前,先确定起始版本,并保留一个可运行的小例子连同说明一起交出去。评审者应当能看到改了什么,也能重复支撑这次改动的检查。

打开网易新闻 查看精彩图片

先把原始故障记下来

设想一个脚本读取工作坊场次列表,并按房间分组。某个输入文件最近多了一个可选的准备时间列。现有解析器仍能运行,但有一个输出字段的值错了。保存一份小体积、获得许可或虚构的输入来复现问题,并写下预期的分组结果。

记录代码版本、输入文件名和你用过的命令。私有配置和凭据要留在示例之外。如果故障依赖某项设置,记录相关的非敏感值,或提供一个安全的样本。评审者应当有足够上下文复现行为,而不用猜你在对话中打开的是哪个文件。

把拟议改动和证据连起来

让助手解释原因并提出一个范围有限的改动。保留它的初始回复,把补丁与项目支持的输入格式做比对。新样本要查,旧文件也要查。一个能正确读取新列的修复,仍可能弄坏该列出现之前生成的数据。

助手可以起草补丁,开发者验证行为,评审者评估调用方是否仍得到预期结果。在交接中写明检查项,并报告哪些检查实际跑过。拟议的命令和已执行的结果属于工作的不同阶段,不能混为一谈。

改一个文件,再跑一遍检查

在样本里改动单独一行,比如把准备时间留空,然后重复相关检查。把结果与运行前写下的预期做对比。如果输出在别处发生变化,检查补丁是否引入了关于列位置或缺失值的新假设。原始样本要保留着,方便直接对照。

如果代码有项目要求的检查,在条件允许时通过正常入口运行它们,记录确切范围和结果。跑不了的检查,就在评审备注里写明限制,并把拟议行为标为未验证。下一个人应当能区分对补丁的推理和在目标环境中产出的证据。

让交接对第二个人有用

把补丁、样本、命令和预期输出交给同事。请他找到被改动的字段,并解释解析器如何处理旧输入。观察他在哪里需要澄清。如果解释依赖很长的聊天记录,就把缺失的上下文补在代码旁边,或写进项目通常记录评审备注的地方。

再试一种情况:交接之后样本文件被替换。给新文件标一个版本,记录差异所在。重复受影响的检查,更新附在补丁上的证据。即使当前工作目录里只剩替换后的文件,基于第一份文件的评审也应当保持可追溯。

最终补丁和验证记录要存在一起,包含起始版本、兼容的输入格式以及任何未解决的案例。提交改动之前,打开备注里点名的实际文件,确认里面就是你检查过的样本。一份小而可复现的交接,能让评审者不必从零散消息里重建调查过程,就能评估行为。

最后一道检查:请评审者改动一个可选值,并在运行前预测输出。如果他的预测和你不一致,回到预期行为,把需求讲清楚。样本的意义,就是在改动还小到可以检查的时候,把这些假设暴露出来。

项目支持的话,再从干净的工作副本测试一次交接。调查过程中留下的本地文件,可能让检查在作者这里通过、在评审者那里失败。把命令实际用到的文件与记录里点名的文件做比对。如果需要额外的测试夹具或生成产物,明确写出它的作用,并按项目惯常流程准备。然后请评审者报告同一个有界检查的确切结果。这有助于在讨论扩大之前,把代码问题和环境或样本问题区分开。