iCode Agent · 指南 · 工作流
重构一个模块。
重构主要是理解:谁调用它、它调用谁,以及在形态变化时必须保持什么不变。iCode Agent 在动手修改之前,会针对真实代码完成这层梳理。
任务
指明模块和想要的改动,然后先让它梳理影响范围:
Refactor src/report/builder.ts. Extract the formatting into a separate module, update all callers, and make sure the tests still pass.
指明文件可以限定工作范围。如果不确定改动该放在哪里,可以描述目标,让智能体自己找到边界——但指定目标能让改动保持聚焦。
会发生什么
- 梳理它。
grep和find定位模块的调用方;read显示带行号的代码,让智能体看到结构,而不是猜测。 - 规划改动。它确定哪些要移动、哪些保留,以及每个必须更新的调用方。
- 小步编辑。
edit每次只替换一个确切的片段并显示 diff,因此审核者看到的是改动,而不是被重写的文件。 - 保持测试通过。它会运行你的测试套件——这张安全网让重构变得安全,而不是冒险。
不会整体重写:edit 只修改目标片段,write 仅用于真正的新文件。接受之前,diff 始终可见。
审核 diff
价值正体现在这里:智能体提议,你来决定。好的重构提示词会要求可核对的推理,而不只是结果:
Refactor the auth module. Show me the callers you found first, then make the smallest change that removes the duplication. Run the tests after each file you touch.
如果改动有误,在任务中途引导它,而不是事后再回退——智能体还没有提交任何内容,所以改变方向成本很低。
适合此工作流的提示词
Find every caller of parseConfig() before changing its signature. Extract the duplicated retry logic into one helper and update both call sites. Explain what this module does, then suggest a refactor — but make no edits yet.
最后一个提示词故意是只读的:先请求分析,读完,再请求修改。对于大型重构,这往往是更好的方式。