用途:在 Linear 待办清单上并行运行多个编码智能体,通过指挥者(conductor)统一调度、工作器(worker)并发执行,解决批量任务并行化时的安全与成本控制问题。参考实现位于该插件的 lib/swarm/,模式源自 OpenAI Symphony。
四个组成部分:源(Source)决定哪些议题可执行,缺失会让代理处理未经梳理的任务;账本(Ledger)记录谁独占持有哪个议题,缺失会导致两个工作器做同一议题、产生两个 PR;工作区(Workspace)为每个议题隔离文件系统,缺失会导致并发工作器互相污染检出;指挥者(Conductor)串行派发、限制并发,缺失会引发无界扇出、成本与速率超限。
核心规则:只有指挥者认领,工作器不自行认领,认领在单一地点按序发生,独占性成为本地属性而非分布式属性;工作器随后在并发上限内并行运行。采用租约而非锁:持有者工作期间发送心跳,扫描将失效认领退回池中,该扫描是唯一重试机制。租约应设为远高于 p99 运行时长。仓库隔离优先用 git worktree 而非克隆,创建时用 -B 使失败重试幂等;议题键在进入路径前须校验,拒绝不合规标识符而非尝试清洗。
每次运行必须终止:工作器崩溃若未关闭代理会话,议题会一直显示活动状态;须在成功与失败两条路径都发出终止活动。先记录结果,再尽力上报,避免上报失败掩盖原始错误。退避为 min(10s * 2^(attempt-1), cap),设最大尝试次数,超出后交人工处理;同一议题三次相同失败说明议题本身欠明确,应升级而非继续重试。需检测挂起:以超时与工作竞速,静默工作器视为失败,且不要 unref() 该定时器,否则静默进程中超时可能被跳过。
源须严格限定:按标签、周期或明确的“可供代理”状态过滤,新过滤先试运行。为所有状态转移发出结构化事件(run.state、run.complete、run.failed、run.crashed、claim.reclaimed)。若追踪器有原生代理界面,也应在那里报告。本页未提供具体安装命令、定价与支持平台信息。