多 AI 会话并行开发不失控:一套从实战长出来的工作流,以及它的开源实现

多 AI 会话并行开发不失控:一套从实战长出来的工作流,以及它的开源实现

ParallelAgent:让"仲裁者 + 多轨会话"的并行开发自动跑起来 开源地址:https://github.com/YorickFin/ParallelAgent (Apache 2.0)

起因

前几天收到 AI IDE 产品 Trae 发来的产品调查问卷短信。填完问卷后,我顺手打开了它的 Work 模式想看看具体形态——结果这一看,把一个搁置已久的想法重新点着了。要说清这个想法,得先从我一直在用的一套工作流讲起。

一个从实战里长出来的工作流

在过去的项目实践中,我经常需要多个 AI 会话并行干活:改前端的同时补测试、写文档的同时修 bug。单会话串行干,效率上不去;开一堆会话乱干,又很快就失控。

踩过一阵坑之后,我慢慢沉淀出一套"仲裁者 + 多轨 + 文件信箱"的工作流:

  • 一个仲裁者会话负责决策:任务怎么拆、拆几轨、谁先谁后,并且持笔写所有协调文档;
  • 多条轨道会话(T-A/B/C/D)各自独立上下文,只管自己那一摊活;
  • 全程文件留痕:契约块嵌在代码注释里,转达单按轨分节,各轨收工写回执,仲裁者独立实检后进入下一轮;
  • 每批结束后回写快照,配合交接手册,任何会话挂掉都能冷启动接力。

这套模式跑起来非常抗造:全程可溯源、不怕会话死亡、不怕上下文压缩——所有关键状态都在磁盘上,会话只是"工人",文件才是"账本"。

"这不是 subAgent 就能干的事吗?"

写到这里,你可能会问:现在的 agent 产品不都有 subAgent 机制吗,为什么还要自己折腾一套?

我认真对比过这两条路线。subAgent 是"宿主内置的临时工",我这套是"文件账本 + 常驻工人",各有各的好:

维度subAgent 路线仲裁者 + 多轨路线
接入成本宿主原生支持,零 hack需要自己维护一套协议与文档纪律
派活体验一句话派出,结果自动回传仲裁者写转达单,靠人转发到各轨
过程留痕只回传最终摘要,中间过程即弃转达、回执、证据全部落盘,可溯源可审计
验收方式信任摘要,难以独立实检仲裁者拿证据独立实检,不合格打回
会话记忆一次性,跑完即销毁轨道常驻,上下文跨批次延续
主会话负担所有子任务结果灌回主上下文,易膨胀主会话只读回执与证据,负担可控
抗压缩/抗崩溃上下文一压缩就丢细节状态在文件里,冷启动即可接力

一句话总结:subAgent 胜在"自动化",短板在"黑盒与健忘";这套工作流胜在"可审计与抗造",短板在"全靠人肉驱动"。

两条路线的天花板,能不能一次解决?

把各自的短板摆出来,答案就浮出来了:

  • subAgent 的短板是结构性的:摘要回传导致过程不可审计,一次性会话导致长任务健忘——这些是它的运行模型决定的,使用方很难改;
  • 这套工作流的短板是工程性的:会话间没有消息通道,转达单写好了还得人工复制粘贴逐轨转发,收工与否也得自己盯——说白了,人只是个"人肉邮差"兼任"人肉调度器"。轨道越多,人在消息总线上损耗越大,还经常出现快照漂移(写单和发单之间代码又动了)、发错轨这类"运维税"。

结构性短板改不了,工程性短板却是可以消灭的。理想形态很清晰:把"文件账本 + 常驻轨道"保留下来,再把 subAgent 那种"派活即走、结果自回"的自动化体验嫁接过来——也就是需要一个编排层,把"建会话、派活、收工判定"这些脏活全部自动化,人只在产品决策和异常升级时出场。

这就是 ParallelAgent 的由来。

可行性验证与方案冻结

需要一个具体宿主来验证这个想法。我当时选择以 Trae Work 作为验证对象——它的形态恰好适合承载:同一项目下可以创建多个独立任务会话,各自独立上下文、共享同一文件系统。于是直接在 Trae Work 里开了一个任务,先验证前提、再冻结方案。

第一步:环境实测。 用探针脚本把关键事实摸清楚,而不是靠猜:

  • Work 与 IDE 是同一二进制的两个"场景",Electron 内核(Chromium 142);
  • 加 --remote-debugging-port 启动后,CDP 调试端口可用,能枚举目标、跑 WebSocket 指令;
  • 同一项目可以创建多个独立任务会话,各自独立上下文、共享同一文件系统;
  • 关键事实:任务之间没有官方的会话间消息通道。

第二步:架构结论。 会话间既然没有官方通道,自动化就必须从应用外层(CDP)或扩展宿主层(插件)接入——好消息是两条路都走得通,可行性成立。这个结论不依赖具体产品:凡是基于 Electron、能开调试端口、支持多会话的 AI IDE,都满足同样的前提。

第三步:方案设计。 核心是"三件套",正好对应前文的两条短板:

部件职责铁律
仲裁者 Skill判拆分、写契约/转达/快照、发控制信号、读回执独立实检只决策持笔,不碰重活
轨道 Skill读转达节、执行任务、写回执自扫门前雪,不做决策
编排器插件CDP 建会话/切轨/派发 + 文件信箱 watch无脑执行,不解析任务内容

编排器插件负责消灭"人肉邮差":自动建会话、切轨、把固定话术发进各轨,再靠文件 watch 监视回执——回执文件一出现,本轮收工自动判定。文件信箱则原样保留:可审计、可交接、抗压缩的优点一个不丢。

再配两条贯穿全局的安全设计:

  • 数据面 100% 文件:裁决、代码、证据、回执全走文件信箱;
  • 控制面只传信号:HTTP / 信号文件只含"轨号 + 轮次 + 文件指针 + 固定话术",绝不含任务内容。这样即使控制层出错,最坏也只是"铃没摇成",不会把错误内容送进错误的轨。

任务生命周期分为三阶段:奠基串行 → 并行多轨 → 收尾串行,配套拆分判据、收回判据和交接手册。

整个过程里,这些设计文档、探针脚本都是在目标宿主内部完成的——相当于用它设计了它自己的并行编排层,有点自举的味道。

已开源

方案冻结后,我把整个项目以 Apache 2.0 协议开源了:

https://github.com/YorickFin/ParallelAgent

仓库里目前有:

  • docs/ — 方案文档:定稿(架构 + 判据 + 接口设计)、探针前的候选设计、生命周期治理、实现路径
  • scripts/ — CDP 探针与运维脚本(连通性验证、WebSocket 指令、状态检查)

写在最后

回过头看,这条链路是:日常使用中的一套并行工作流 → 和 subAgent 路线认真对比 → 在具体宿主上完成可行性验证和方案冻结 → 开源。

这套思路本身不绑定任何特定产品:核心协议(仲裁者、轨道、文件信箱、控制面信号)是宿主无关的,仓库里的实现以 Trae 为第一个适配宿主,后续可以平级扩展到其他满足前提条件的 AI IDE。

如果你也在做多 agent 并行方向的尝试,或者对"可审计的多会话协作"有自己的想法,欢迎到仓库交流,Issue 和 PR 都可以。

0个评论
点击登录,快来和大家讨论吧~
表情
图片
暂无评论
下载 APP