033、子代理并行调度：同时启动多个代理、结果收集与异常处理的工程模式

033、子代理并行调度：同时启动多个代理、结果收集与异常处理的工程模式

一次让我熬夜到凌晨三点的并行调度事故

上个月接手一个遗留的Claude Code项目，代码里有一段“并行调度”逻辑，看起来挺美——同时启动5个子代理去爬取不同站点的竞品数据。结果生产环境一跑，三个代理同时超时，两个返回了空结果，主进程直接卡死，日志里连个异常堆栈都没留下。我盯着终端里那个不断闪烁的光标，心里只有一个念头：这代码谁写的，出来挨打。

后来发现，问题出在“并行”这两个字上。很多人以为用asyncio.gather或者ThreadPoolExecutor把任务丢进去就完事了，但Claude Code的子代理调度远比你想象的复杂——每个子代理都有自己的上下文窗口、token消耗、状态管理，甚至可能因为API限流而集体罢工。今天这篇笔记，就是我从那次事故里爬出来后，重构出来的工程化并行调度模式。

别用裸的asyncio.gather，你会后悔的

先看一个典型的错误写法，我猜你项目里大概率有类似的：

# 别这样写！这是坑results=awaitasyncio