SuperAPI AI 工具集

swarm

智能体与模型

查看项目

更新于 10-15 22:12

技能介绍

用途:swarm 用于把一项任务扇出给 N 个并行 worker,由父级等待、聚合,最终返回一份统一报告。触发方式包括 /swarm、"swarm this",以及并行覆盖、竞速、gauntlet 和探索场景。

主要能力:支持三种形态——按切片分区、让 N 个 worker 对同一 brief 竞速,或两者混合。竞速或混合形态需在启动前声明选择规则:first pass、rank all 或 best-of。N 为 worker 总数,可由用户指定或按形态推导。

使用方式:启动前先建立 todolist,每个阶段一条。流程分四阶段:Frame(声明完成谓词与需返回的产物或报告,确定形态与 N,选择 worker 模型)、Fan out(用 delegate_task、mode: "async" 在一轮内启动全部 N 个 worker;仅当 worker 需要独立线程、worktree 或分支时使用 t3_thread_launch 与 workspaceStrategy,每个 worktree 只允许一个写入者)、Aggregate(用 task_status 排空至全部 worker 终止)、Report(返回一份合并的聊天内报告)。

每个 brief 必须自包含,子代理只拿到 brief,不继承父级上下文,需写明目标、范围、确切切片或竞速臂、验证方式与报告内容。报告使用 PASS、ISSUES 或 BLOCKED 并附证据。worker 写入时需各自拥有可写输出;验证或测量提交时 brief 要写明确切 SHA,测量 brief 还要写明方法(样本数、单样本定义、顺序),worker 在结果中记录两者。

限制与处理:执行前需阅读 T3 execution,其顶层对话要求适用于每次启动,否则应使用受支持的子隔离或报告运行时限制。若 worker 掉线,按 N-1 继续并注明。结果未记录 brief 指定的 SHA 与方法则丢弃并重派一次,第二次仍缺失记为 gap,gap 不计为通过。覆盖形态下每个必需切片都要有结果;竞速按预先声明的规则选择。不要粘贴原始 worker 输出,只保留紧凑结果表、一行式带证据问题与明确的 gap 或掉线。模型选择依据 pstack-models.md 的 swarm workers 行并通过 orchestrator_capabilities 解析;文件或角色缺失时使用该角色的内置默认;auto 或 inherit 时省略 target 以沿用父模型;容量选定的目标不可用时通过执行参考解析其他合适账号或模型;替换固定或用户选定模型前需先询问;模型竞速需事先命名各臂模型。