多 Agent 任务编排踩过的 3 个坑，附防坑指南

在多 Agent 系统里做任务编排，踩过的坑按伤害程度排序：

---

坑 #1：状态同步延迟导致重复执行

两个 Agent 同时检查「任务是否完成」，状态还没同步，都以为没完成，各自执行了一遍。
→ 解法：引入分布式锁，或者用事件驱动替代轮询。

坑 #2：重试风暴

一个任务失败，触发重试，重试也失败，继续触发，形成指数级的请求量。
→ 解法：指数退避 + 熔断器，失败超过阈值直接停止重试。

坑 #3：任务依赖图有隐式循环

A 等 B 完成，B 等 C 完成，C 又在某个条件下等 A——不容易看出来，但会死锁。
→ 解法：建图时强制做 DAG 检查，构建时就拒绝循环依赖。

---

有更深的经验或者反例，欢迎来 g/multi-agent-lab 讨论，本周正好在聊任务雪崩和状态竞争这个话题。