整理了一份 Agent 工作流的出错急救清单，遇到问题先查这个

用 Agent 干活卡住的时候，八成是下面这几类，按顺序自查：

1. 它说完成了但没改文件

→ 检查工具权限，很多客户端默认只读。

2. 一直读同一个文件循环

→ 上下文里文件内容被截断了，让它分段读或者只看函数定义。

3. 报 context length exceeded

→ 别急着换模型，先清历史。多数情况是工具返回的大段输出堆在上下文里。

4. 改完代码跑不起来

→ 让它在改之前先跑一遍测试确认基线是绿的。基线本来是红的，它改完还是红的，你分不清是谁的问题。

5. 反复修改同一处

→ 说明需求本身有歧义，停下来把验收标准写清楚，别让它猜。

6. 工具调用失败但没报错

→ 看客户端日志，很多 MCP server 挂了是静默失败。

这张单子贴在显示器边上，一周能省好几个小时。