Agent 预算在任务中途被吃光
Agent 执行长任务时 token 或费用预算耗尽，任务半途中止、半成品代码留在磁盘上。本文教你定位预算去向、抢救中间结果，并从断点续跑。
#Agents
带有该标签的文章
Checkpoint 恢复出来的状态是损坏的
Agent 从 checkpoint 恢复后状态字段缺失、类型错乱或值异常。本文教你定位损坏、回滚到完好的历史版本，并写出真正抗崩溃的 checkpoint。
成本统计漏算了子 Agent 用量
成本仪表盘显示 2 美元，账单却是 18 美元。子 Agent 的 token 消耗没有归因到父级运行。本文给出补齐缺口的方法，2026 年 6 月核实。
Agent 调用图出现循环但没人发现
多 Agent 之间互相交接，形成永不终止的环，因为没有任何东西在检测循环。本文教你抓出这个环、配好框架自带的上限、并把循环彻底限定住。
Agent 交接时上下文丢失了
下游 Agent 重复询问已答过的问题，或输出与前几步的决策相矛盾。本文帮你定位丢失上下文的交接边界，并在一小时内接上结构化、可持久的状态传递。
Agent 编排器互相等待出现死锁
两个 Agent 互相等待对方的输出，整条流水线永远挂起。本文教你找到环、加超时、几分钟内打破死锁，并给出 LangGraph、Temporal、AutoGen 的具体做法。
修复：Agent 把 secret 写进了日志和 git
AI Agent 把真实的 API key、token 或密码写进了日志、trace 或已提交的文件。这里给出最快的止血路径，以及如何脱敏输出、阻止它再次发生。
Agent 输出下游解析不了
Agent 把 JSON 包进 Markdown 代码块、或在前后加了一句废话，下游解析直接崩。用原生结构化输出彻底修好（2026 年 6 月）。
Pre-flight 检查被 Agent 跳过
Agent 跳过了启动前应该执行的检查，结果在几秒就能发现的问题上跑了几小时才失败。本文教你把 pre-flight 做成任何代码路径都绕不过去的强制门禁。
Agent 晋级判据太宽，劣质输出被放行
Agent 流水线的 Promotion（晋级）判据太宽或太容易满足，让劣质输出蒙混过关。用「关键项必须全过 + 装饰项走阈值」、有据可依的检查和对抗测试收紧 gate，同时不误杀好输出。
修复不同版本 Agent 间的 Prompt 模板漂移
不同 Agent 实例运行着略有差异的 system prompt，输出质量取决于哪个实例处理了请求。本文教你如何固定 prompt 版本、按运行记录确切的 prompt，并在上线前发现漂移。
一个 Agent 触发 rate limit 拖垮整条流水线
一个 Agent 被限速，等待它的其他 Agent 接连超时，整条流水线雪崩。教你隔离限速桶、解耦各阶段、彻底终结 429 级联失败。
不稳定 tool 触发 Agent 重试风暴
一个偶发失败的工具调用，让 Agent 重试上百次，烧光预算、撞上 rate limit。给重试加上次数上限、带 jitter 的退避、429 处理和熔断器。
共享 memory 被多 Agent 写覆盖
两个 Agent 读到同一份共享 memory，各自写回，其中一个更新悄悄消失了。本文教你定位这个「丢失更新」竞态，并用原子操作、乐观锁或按 Agent 分区把它彻底修掉。
Agent 跳过了必须的验证步骤
Agent 流水线把未经验证的输出放行了，因为 Lint/测试关卡被跳过。教你在 LangGraph、CrewAI、OpenAI Agents SDK 和 Claude Code 里强制不可跳过的验证。
重启后 Agent 状态对不上：检测漂移并重新同步
崩溃或重启后，Agent 以为世界还停在旧状态，与现实对不上。本文教你在 LangGraph、Temporal 和自研 checkpoint 里检测状态漂移并可靠地重新同步。
Agent 退出后，它启动的子进程成了孤儿
AI Agent 启动了开发服务器或文件监听进程，自己却先退出了，没有把它杀掉。这个进程继续占着端口、烧着 CPU。本文教你追踪每一个子进程，并确保它一定会被终止。
任务被路由到了错误的 Agent：修复路由误判
CrewAI、LangGraph 或 AutoGen 的路由器把任务分给了能力不匹配的 Agent，输出全是废话。本文教你定位路由逻辑、修复分类误判。
Trace 里看不到关键 tool call：定位缺口并修复
LangSmith 或 Langfuse 的 trace 里只有结果、没有 tool call span。本文用一张判断表帮你锁定七种根因中的哪一种，并给出对应修复，让 trace 重新完整。
两个并行 Agent 同时改一份文件（改动丢失修复）
并行 AI Agent 静默覆盖彼此对同一文件的改动，导致改动丢失。2026 年 6 月最快的修复是 worktree 隔离。本文讲清楚如何检测、修复并预防写丢失。
多 Agent 交接 Prompt：Claude Code 子代理模板
在 Claude Code subagent 之间交接工作的 12 个 Prompt 模板——研究、计划、实现、审查、发布，不丢上下文。2026 年 6 月更新。