MiniMax Agent Coding Plan 跑完后，先不要急着结束流程，而是要优先排查那些关键却最容易被忽略的功能点，例如日志记录、异常捕获、API 鉴权请求头，以及资源释放等收尾逻辑。更稳妥的做法是把 plan.md 和执行日志放在一起对照检查，进行双向校验，重点关注超时、导入缺失、响应异常这几类高频问题。补漏时不要凭经验随意修改，最好结合文件名、行号和上下文锚点进行结构化定位。开启 Spec Mode 后，应优先按照 plan.md 的既定步骤推进；最后再通过最小闭环测试快速确认补丁是否真正生效，例如直接在 REPL 中验证 timeout，这样既节省时间，也更容易准确判断结果。

使用 MiniMax Agent Coding Plan 执行任务后，如果发现关键功能缺失，比如生成的脚本没有添加日志、没有做异常捕获、遗漏了 API 鉴权头，或者缺少资源释放逻辑，就不能只笼统地说“补上错误处理”。必须让 Agent 清楚知道缺了什么、应该在哪个位置补、以及为什么这里必须补，才能提高修复效率并避免二次遗漏。

定位遗漏点：从Plan文档和执行日志双向交叉验证

打开任务输出目录下的plan.md，逐行核对“预期步骤”与“实际输出代码”；同时打开右侧“执行日志”面板，滚动到底部查看最后 10 行，重点查找包含unhandled exception、missing import、no response timeout的内容。如果日志里出现requests.get() without timeout，就说明 Agent 根本没有补充超时参数。这不是代码风格差异，而是会直接影响线上稳定性的生产级问题。

这一步不能省略。很多人误以为“没有报错就代表功能完整”，但实际部署后，往往因为网络抖动或接口阻塞，程序卡死数小时才暴露出问题。

结构化补要求：带文件名、行号、上下文锚点的最小修改指令

方法一：在聊天框中直接补充（仅限未启用 Spec Mode 时）
建议写成：“在fetch_price.py第 47 行response = requests.get(url)后补充timeout=(3, 10)，修改为response = requests.get(url, timeout=(3, 10))。”

方法二：启用 Spec Mode 后强制按 plan.md 流程执行（推荐）
第一步：确认 JetBrains 插件已开启 Spec Mode；
第二步：在plan.md对应步骤下方新增一行，格式为：步骤5: 调用价格API → ⚠️补: fetch_price.py第47行必须加timeout=(3, 10)，否则线上请求会无限挂起；
【补完后必须保存文件，而且不能只修改文字却不点击「按方案执行」】

方法三：遇到资源类遗漏，例如 UI 控件没有绑定事件，最稳妥的方式就是通过 ID 直接锚定
“先在main.ui中定位到QPushButton#btnSubmit，然后在它的on_click信号连接位置补上：self.btnSubmit.clicked.connect(self.on_submit)。对应的处理函数其实已经写好，定义在main.py第 89 行。”

验证补丁是否生效：用最小闭环测试代替全量重跑

不要直接点击“重新执行全部步骤”。可以把补完后的那段代码单独复制出来，例如刚刚加入的 timeout 代码，粘贴到 Python REPL 中手动执行一次requests.get("https://httpbin.org/delay/5", timeout=(3, 10))——如果 3 秒内抛出TimeoutError，说明补丁已经生效；如果依然卡满 5 秒才返回，就说明 timeout 没有真正生效，需要回头检查括号、逗号，或者是否误用了单值元组。

这一步可以立即暴露语法错误和参数使用错误，比起等 Agent 完整跑完 7 个步骤后再看日志，排查效率至少高很多。