Skip to content
反馈文档问题

定位并修复问题

修复问题的关键不是尽快改文件,而是建立一条从现象、根因到验证的证据链。

描述可观察现象

首次消息尽量包含:

  • 用户做了什么;
  • 预期结果和实际结果;
  • 是否稳定复现;
  • 相关日志、截图或错误;
  • 哪些行为必须保持不变。

示例:

text
History 搜索在输入第二个关键词后偶尔保留上一次结果。
请先复现并定位权威状态来源,再修复。不要通过延长固定等待时间掩盖问题。
补一个能稳定覆盖请求乱序的测试,并运行聚焦验证。

先复现

让 Agent 找到最小复现路径。复现失败时,不应凭猜测直接修改最可疑的文件。

好的复现会明确:

  • 触发条件;
  • 当前状态;
  • 错误输出或错误 UI;
  • 成功与失败之间的差异。

收窄根因

使用 Files 搜索状态所有者、请求入口和已有测试。要求 Agent 区分:

  • 症状出现的位置;
  • 真正写入错误状态的位置;
  • 负责并发、取消或恢复的边界。
在 Files 中检查关系算子 Markdown 文档在 Files 中检查关系算子 Markdown 文档

实施最小修复

修复应直接对应根因,并保持无关行为不变。对并发、超时、重连等问题,同时检查安全性和活性:非法状态要被拒绝,临时状态也要有明确的结束路径。

证明修复

至少运行:

  1. 新增或修改的回归测试;
  2. 受影响模块的聚焦检查;
  3. 风险需要时的生产形状场景。

要求 Agent 报告精确命令、结果和未覆盖内容。最后用 Files 或 Git 状态确认没有无关修改。

Farming 是一个开源、自托管的 AI Coding Agent 工作区。