让AI编程Agent修Bug,按复现、定位、小范围改动、回归四步走:Agent整理线索、起草修改,人确认根因、审核diff并决定是否合入。
要点速览
- 修Bug按复现、定位、小范围改动、回归四步推进
- 没有稳定复现之前,不让Agent动代码
- 定位阶段只读不改,要求列出可疑点与依据
- 先建分支、先看diff再落盘,拒绝顺手重构
- 原有测试失败时改代码不改测试,合入由人审定
让AI编程Agent在终端里修一个Bug,比较稳妥的做法是分四步走:复现、定位、小范围改动、回归。Agent负责整理报错与日志、列出可疑代码位置、起草修改和补测试;开发人员负责确认问题能稳定复现、认定根因、审核diff,并决定是否合入。整个过程放在独立分支上进行,任何一步不对都能退回去。AI在这里做的是整理、给线索和起草,判断与合入始终归人。
为什么不能一句话让它修好
很多人第一次用终端Agent修Bug,会直接贴一段报错,然后说一句帮我修好。Agent往往也会很快给出一个改动,测试甚至能跑通。问题在于,这样得到的修复很难判断是不是对症:它可能只是让报错不再出现,而真正的原因还在;也可能顺手改了几处看起来不顺眼的代码,让本来简单的修复变成一次难以审阅的大改动。
修Bug和写新功能不同。写新功能时,需求本身就是目标;修Bug时,目标是找到并消除一个具体的原因。如果原因没有被确认,改动越快,风险反而越大。所以下面这四步,本质上是把一次修复拆成几个可以单独确认的小结论,每个结论都由人点头之后再往下走。
如果你还没在终端里用过这类工具,可以先看AI编程Agent怎么用?初次在终端改代码先走哪四步,把工作目录、权限和回退方式先理顺,再来处理具体的Bug。
一、复现:先能稳定复现,再谈修复
Agent做什么:把零散的现场信息整理成一份复现说明,包括报错原文、相关日志片段、触发步骤、运行环境和版本信息,并尝试给出一条可以在本地或测试环境执行的复现路径。
人确认什么:按这份说明实际跑一遍,确认问题能稳定出现,并且出现的就是用户或监控里报告的那个问题。
这一步常被跳过,但它决定了后面所有工作的方向。交给Agent的材料越完整,它整理出的复现路径越靠谱。建议至少准备这几样:
- 完整的报错信息和堆栈,而不是截取的一两行;
- 出错前后一段时间的应用日志,注意先去掉密钥、账号、客户信息等敏感内容;
- 触发步骤,哪怕只是用户口述的操作顺序;
- 出问题的环境与版本,例如测试环境还是线上、哪次发布之后开始出现。
常见翻车点:问题只是偶发,还没复现成功就开始改代码。这时候Agent给出的任何修改都只能算猜测。对于偶发问题,更合适的做法是先让Agent帮忙补充日志点或整理出现规律,等能稳定复现后再进入下一步。另一个翻车点是复现出来的其实是另一个相似的错误,人在这一步需要对照原始报错仔细核对。
二、定位:只读不改,先列可疑位置与依据
Agent做什么:在只读的前提下阅读相关代码,沿着调用链追踪,列出几个可疑位置,每个位置写清楚依据,例如哪一行在什么条件下会产生这个错误、与日志中的哪条记录对得上。
人确认什么:从这些候选里认定根因,或者判断线索还不够、需要补充信息。
这一步要明确告诉Agent:只看,不改。原因很简单,定位阶段一旦允许修改,Agent很容易在找到第一个看起来像原因的地方就动手,而那未必是真正的问题。让它把可疑点和推理过程写出来,人看一遍就能判断哪条推理站得住、哪条只是表面相似。
一个实用的要求是让Agent对每个可疑点给出验证方法,比如加一条日志、换一个输入、看某个变量的值。这样人可以用很小的代价确认或排除,而不必全凭阅读判断。对于不熟悉的代码库,定位前可以先让Agent梳理一遍模块结构,做法可参考怎么看懂别人的代码?终端AI编程Agent分四步梳理。
常见翻车点:Agent给出的原因听上去很合理,但和复现时看到的现象对不上。人在这里要坚持一个标准,根因必须能解释观察到的全部现象,解释不了的部分就说明还没找对。
三、小范围改动:先建分支,先看diff再落盘
Agent做什么:在新建的修复分支上,只针对已确认的根因起草修改,先以diff的形式展示,说明每一处改动的目的。
人确认什么:逐行审阅diff,确认改动只覆盖必要的文件和代码行,同意后再写入。
这一步有三条规矩值得写进团队的使用约定里:
- 先建分支。不在主分支上直接改,出问题时切回去就行,不影响其他人。
- 只改必要文件。明确告诉Agent改动范围,比如只允许修改某个模块,不允许动配置、依赖和公共组件。
- 先给diff再落盘。让人看到将要发生的变化,而不是改完才知道改了什么。
常见翻车点有两个。一是改动过大,一个空指针问题,diff里却出现了一大片变化,原因往往是Agent顺手重构了周边代码、统一了命名或调整了格式。这些改动未必有错,但会让审阅变难,也会让回退时牵连无关代码。遇到这种情况,直接要求它撤回无关部分,重构如果真有必要,单独开一次提交。二是改动绕开了根因,比如在外层加一层异常捕获把错误吞掉,报错没了,问题还在。审diff时要问一句:这个改动是消除了原因,还是只是藏住了现象。
关于终端里执行命令和回退的更多注意事项,可以参考AI编程Agent安全吗?代码、命令、回退、模型出口四处自查。
四、回归:补一条复现测试,跑通原有测试,人审后合入
Agent做什么:根据复现步骤写一条测试,这条测试在修复前应当失败、修复后应当通过;然后运行项目原有的测试,整理结果。
人确认什么:确认新测试确实对应这个Bug,原有测试全部通过且没有被改动,再审一遍完整diff,决定是否合入。
补一条能复现该Bug的测试,意义在于把这次修复固定下来,以后有人改到相关代码,问题再出现时能被及时发现。建议让Agent先在未修复的代码上跑这条测试,确认它会失败,否则这条测试可能根本没有覆盖到问题。
这一步要特别留意的翻车点是改了测试而不是改代码。当原有测试失败时,Agent有时会去调整测试的断言或期望值,让测试通过。这种情况必须由人拦下:原有测试失败,说明修改可能影响了其他行为,需要回到第三步重新看,而不是修改测试来迁就代码。除非人明确判断原测试本身写错了,否则测试文件不应出现在这次修复的diff里。
合入前的审阅,建议由熟悉这部分代码的开发人员来做,而不是谁触发了Agent谁就自己合。修复是否正确、是否可以上线,判断在人。
常见翻车点汇总
把四步里提到的问题放在一起,方便团队对照自查:
- 还没稳定复现就开始改,修复变成猜测;
- 复现出的不是原问题,而是相似的另一个错误;
- 定位阶段允许修改,Agent在第一个可疑点就动手;
- 根因解释不了全部现象,却被当作结论;
- 没建分支,直接在主分支上改;
- 一次改动过大,夹带顺手重构、格式调整;
- 用异常捕获或默认值掩盖错误,而不是消除原因;
- 原有测试失败时去改测试,而不是改代码;
- 新补的测试在修复前也能通过,等于没测到问题;
- 谁触发谁合入,缺少第二个人的审阅。
工具在这四步里各管什么
以上流程不绑定某一款工具。润迅的迅码 XunCode是一款终端AI编程Agent,支持macOS、Linux和Windows,个人免费使用,企业可以私有化部署。在修Bug这件事里,它能做的是上面四步里「Agent做什么」那一半:读代码、整理可疑位置、起草修改和补测试。至于先建分支、先看diff、不改原有测试这些规矩,属于团队的流程约定,无论用哪款工具,都应当配合版本管理一起执行,由人在每一步确认。
团队使用时,还会碰到用哪个模型、谁在调用的问题。MaxModel是润迅的模型统一管理平台,用一个Key接入所需的大模型,支持多模型路由和调用审计。对修Bug流程来说,它解决的是两件事:团队不必各自保管不同模型的密钥;模型调用留有记录,事后需要核查某次修复过程时有据可查。
如果Bug和服务器环境有关,比如需要到机器上翻日志、看进程状态,可以用MaxTerm这类终端AI运维工具帮忙整理命令和输出,为复现阶段准备材料。涉及修改系统状态的命令,仍应由人确认后再执行。
从下一个Bug开始试
不必一开始就把整套流程推到全团队。比较实际的做法是:
- 挑一个已经能稳定复现、影响范围不大的测试环境Bug,按四步完整走一遍,记录每一步Agent给了什么、人改了什么;
- 把「定位只读」「先建分支」「先看diff」「不改原有测试」这几条写成团队约定,放进项目说明里;
- 约定合入审阅由第二个人完成,Agent参与过的提交在说明里注明;
- 如果团队要统一接入公司的模型并保留调用记录,先把接入地址、Key、路由和日志配置理清楚,可参考AI编程Agent接入公司大模型怎么配?四项配置逐个讲清。
走过几次之后,团队会对哪类Bug适合交给Agent、哪类更适合人直接处理有自己的判断。需要了解迅码 XunCode或MaxModel的部署方式,也可以拨打润迅业务热线400-854-5566咨询。
常见问题
AI编程Agent修Bug可靠吗?
它适合整理报错与日志、列出可疑代码位置、起草修改和补测试,能节省排查时间。但修复是否对症要由开发人员判断。按复现、定位、改动、回归分步确认,并在独立分支上操作,可以把风险控制在可回退的范围内。
让AI修Bug时为什么要先复现?
不能稳定复现,就无法确认问题是否真被修好,Agent给出的修改只能算猜测。先整理报错、日志和触发步骤,确认问题每次都能出现,后面的定位和回归测试才有可靠的依据。
AI改代码时顺手重构了怎么办?
要求它撤回与本次Bug无关的改动,只保留针对根因的必要修改。确有必要的重构单独开一次提交。这样diff更容易审阅,出问题时回退也不会牵连无关代码。
AI为了让测试通过去改测试用例,怎么防?
在约定里写明修复过程中不得修改原有测试,审diff时检查测试文件是否出现变化。原有测试失败通常说明修改影响了其他行为,应回到改动环节重新看,而不是调整断言迁就代码。
AI修完的Bug谁来决定能不能合入?
由开发人员决定,建议由熟悉相关代码的第二个人审阅diff和测试结果后再合入。AI只负责整理线索、定位可疑点和起草修改,不应自行合入或发布。