iCode Agent · 指南 · 工作流

追踪一个 bug。

bug 的难点通常不在修复——而在找到原因。iCode Agent 会沿着证据穿过代码,告诉你它发现了什么,而不是猜一个补丁。

任务

描述症状,如果可能,也说明如何复现:

Users report that saving a duplicate name overwrites the original.
Reproduce it, find the cause, then fix it.

复现是你所能提供的最有价值的输入。没有复现时,先让智能体找到或写一个——无法触发的问题,也就无法确认已经修复。

会发生什么

  1. 复现。它运行失败的命令或测试,并读取真实输出——堆栈跟踪、错误或错误的取值。
  2. 跟随证据。它从症状一路追溯到原因:调用代码、数据、状态。失败就是信息,它会继续顺着线索查下去。
  3. 指出原因。它会解释哪里不对、为什么,并给出能说明问题的代码——而不只是告诉你在哪里打补丁。
  4. 修复并验证。它做出针对原因的最小改动,并重新运行之前失败的检查。

接受修复前先提问

让症状消失的补丁,不等于修好了 bug。要询问推理过程,以及原因是否真的被解决:

Reproduce the failure in tests, explain the root cause, then fix it.
Don't change the test to make it pass — the test is correct.
Show me every place this same bug could occur.

最后一行很重要:好的 bug 排查会问,这是某个模式的一个实例,还是一次偶发。

当回答是“我无法复现它”时

那是有用的结果,不是失败。智能体会说明它尝试了什么、观察到了什么。你可以据此缩小环境范围、提供能触发问题的输入,或要求加入插桩,在预期出错的位置记录状态。