Agent 预算在任务中途被吃光
Agent 执行长任务时 token 或费用预算耗尽，任务强制中止且无中间结果可用。本文分析预算失控的根因并给出限额与断点续传方案。
#Agents
带有该标签的文章
Checkpoint 恢复出来的状态是损坏的
Agent 从 checkpoint 恢复时，加载出来的状态字段缺失、类型错误或值异常，导致 workflow 以错误状态继续执行，产生难以追踪的下游错误。本文分析 checkpoint 损坏的根因并给出写入和恢复的防御方案。
成本统计漏算了子 Agent 用量
多 Agent 系统的成本仪表盘只显示主 Agent 的 token 消耗，子 Agent 和工具调用产生的费用没有被归因，导致月度账单远超预算但无法定位超支来源。本文分析成本归因断层的根因并给出全链路追踪方案。
Agent 调用图出现循环但没人发现
多 Agent 系统中，Agent 之间的调用关系形成了有向环，导致任务无限循环、token 持续消耗，直到预算耗尽才暴露问题。本文分析循环产生的原因并给出静态检测和运行时防护方案。
Agent 交接时上下文丢失了
多 Agent 流水线中，子 Agent 接手任务后丢失关键背景，导致重复询问或输出偏离预期。本文逐步拆解丢失原因并给出可落地的修复方案。
Agent 编排器互相等待出现死锁
多 Agent 系统中两个或多个 Agent 互相等待对方的输出，整个流水线挂起不前进。本文分析死锁成因并提供超时、优先级和拓扑检测方案。
Agent 输出里夹带了 secret
Agent 在生成代码、文档或日志时，把 API key、密码、token 或其他敏感凭证输出到了对话记录、trace 日志或下游系统里，造成安全风险。本文分析 secret 泄漏的触发路径并给出检测和阻断方案。
Agent 输出下游解析不了
Agent 生成的输出格式不稳定，下游系统在解析 JSON、代码块或结构化字段时频繁失败。本文分析格式漂移根因并给出强制结构化输出方案。
Pre-flight 检查被 Agent 跳过
Agent 在任务启动前应该执行的环境检查、权限验证或依赖确认被跳过，导致任务在执行中途因为可预见的前提条件未满足而失败，浪费了已经消耗的 token 和时间。本文分析跳过根因并给出强制 pre-flight 方案。
Promotion 判据太宽，劣质输出被放行
Agent 流水线的晋级（Promotion）判断逻辑标准过于宽松，让不完整、格式错误或语义错误的输出通过了质量关卡，流入下游系统或生产环境。本文分析判据失效的根因并给出量化指标和分层校验方案。
不同版本的 Prompt 模板互相打架
多 Agent 系统或多环境部署中，不同版本的 prompt 模板并存，同一个任务在生产环境和暂存环境使用了不同的指令，导致输出格式或行为不一致，难以复现和调试。本文分析模板漂移根因并给出版本化管理方案。
一个 Agent 触发 rate limit 拖垮整链
多 Agent 系统中某一个 Agent 的爆发性请求触发 API rate limit，导致共用同一 API key 的其他 Agent 全部被限速，整条流水线雪崩。本文分析级联失败的传导路径并给出隔离和限速方案。
不稳定 tool 触发 Agent 重试风暴
一个偶发失败的工具调用触发 Agent 框架的自动重试机制，指数退避叠加并行 Agent，导致 API 用量和成本在分钟内暴涨。本文分析重试风暴的放大机制并给出熔断和限速方案。
共享 memory 被多 Agent 写覆盖
多个 Agent 并发读写同一块共享 memory（如 Redis key、共享字典、消息历史），后写入的 Agent 覆盖了之前 Agent 的重要更新，导致状态不一致或数据丢失。本文分析写竞争根因并给出乐观锁和分区隔离方案。
Agent 跳过了必须的验证步骤
Agent 在生成输出后绕过了格式校验、安全检查或业务规则验证，导致错误输出进入下游系统。本文分析跳过验证的触发条件并给出强制验证方案。
重启后 Agent 状态对不上
Agent 重启或恢复后，内存中的状态与持久化存储的状态出现偏差，导致重复执行、跳过步骤或使用过期数据。本文拆解状态漂移根因并给出持久化与校验方案。
Agent 启动的子进程退出后成了孤儿
Agent 在执行工具调用或代码运行时启动了子进程，任务结束或 Agent 崩溃后子进程没有被终止，在系统后台持续消耗资源或持有文件锁。本文分析孤儿进程的产生原因并给出清理和预防方案。
任务被路由到了错误的 Agent
编排器把任务分发给能力不匹配的 Agent，导致输出质量差、工具调用失败或任务被无限转发。本文分析路由失效根因并给出能力声明和路由测试方案。
Trace 里看不到关键 tool call
在 LangSmith、Langfuse 或框架自带的 Trace 视图里，某次关键的工具调用没有出现在记录里，导致无法排查 Agent 行为或审计操作。本文分析 trace 缺失的根因并给出完整追踪方案。
两个并行 Agent 同时改一份文件
多 Agent 并行执行时对同一文件并发写入，导致改动互相覆盖或产生 git 冲突。本文分析冲突根因并给出文件锁、任务分区和冲突恢复方案。
多 Agent 交接 Prompt：Claude Code 子代理模板
在 Claude Code subagent 之间交接工作的 12 个 Prompt 模板——研究 → 计划 → 实现 → 审查 → 发布，不丢上下文。