033、子代理并行调度：同时启动多个代理、结果收集与异常处理的工程模式一次让我熬夜到凌晨三点的并行调度事故上个月接手一个遗留的Claude Code项目，代码里有一段“并行调度”逻辑，看起来挺美——同时启动5个子代理去爬取不同站点的竞品数据。结果生产环境一跑，三个代理同时超时，两个返回了空结果，主进程直接卡死，日志里连个异常堆栈都没留下。我盯着终端里那个不断闪烁的光标，心里只有一个念头：这代码谁写的，出来挨打。后来发现，问题出在“并行”这两个字上。很多人以为用asyncio.gather或者ThreadPoolExecutor把任务丢进去就完事了，但Claude Code的子代理调度远比你想象的复杂——每个子代理都有自己的上下文窗口、token消耗、状态管理，甚至可能因为API限流而集体罢工。今天这篇笔记，就是我从那次事故里爬出来后，重构出来的工程化并行调度模式。别用裸的asyncio.gather，你会后悔的先看一个典型的错误写法，我猜你项目里大概率有类似的：# 别这样写！这是坑results=awaitasyncio