SuperAPI AI 工具集

swarm

智能体与模型

查看项目

更新于 10-16 16:28

技能介绍

Swarm 是一个并行分派与聚合技能,核心用途是把一项任务扇出(fan out)给 N 个并行 worker,等待它们全部结束,然后由父级聚合并返回一份统一报告。

主要能力

  • 支持三种形态:把任务切分成多个独立切片(partition into slices)、让 N 个 worker 对同一份简报竞速(race),或两者混合。
  • 对竞速或混合形态,需要在生成 worker 之前先声明选择规则:first pass、rank all 或 best-of。
  • N 表示 worker 总数,而不是并发上限。
  • 每个 worker 的简报独立完整,包含目标、范围、确切的切片或竞速分支、验证方式以及需要报告的内容。
  • 报告使用 PASS、ISSUES 或 BLOCKED 状态并附证据;能证明缺陷的 worker 报告 ISSUES,并列出所有可证明的问题,而不只是第一个。

使用方式

  • 流程分为四个阶段:Frame(框定)、Fan out(扇出)、Aggregate(聚合)、Report(报告)。
  • 启动前先建立任务列表,每个阶段一个条目。
  • Frame 阶段:说明完成判定条件(done predicate)以及 swarm 必须返回的产物或报告;选择形态;确定 N;从 ~/.config/pstack/pstack-models.md 的 swarm workers 行选择 worker 模型;为每个子代理选择推理级别和速度。
  • Fan out 阶段:在同一轮内以 delegate_task 子任务形式生成全部 N 个 worker,mode 为 "async",标题标明切片或竞速分支。子任务共享当前检出目录,因此并行写入者需各自拥有互不重叠的文件,且不运行 git 命令。需要独立工作树或分支的 worker 使用 t3_thread_launch 线程,并配置 workspaceStrategy(worktree、baseRef、branch、startFromOrigin)和 modelSelection。每个工作树或分支只允许一个写入者。生成后结束本轮,子任务完成通知会唤醒父级。
  • Aggregate 阶段:读取最终结果;丢弃未记录简报中指定 SHA 和方法的结果,并重新生成该 worker 一次;第二次仍缺失则记为 gap,gap 不计为通过。覆盖形态要求每个必需切片都有结果;竞速形态按事先声明的规则选择。保留紧凑结果表、一行式带证据的问题列表,以及明确的 gap 或掉队项。
  • Report 阶段:返回一份合并的聊天内报告,包含结果表、问题一行式、gap 或掉队项,以及使用时的竞速规则。

适用场景

  • /swarm 命令或 "swarm this" 请求。
  • 并行覆盖(parallel coverage)、竞速(races)、gauntlet 和探索(exploration)类任务。

限制与注意事项

  • 大多数 pstack 技能仅限用户使用,技能工具无法加载它们。
  • 每次 delegate_task 调用都遵循 ../poteto-mode/SKILL.md 中 Subagents 部分的默认值。
  • 若模型配置文件或对应行缺失,则省略 target,让 worker 使用父模型;无文件时应说明并建议 /setup-pstack。
  • 若 delegate_task 拒绝某个条目,改用同一提供方中 orchestrator_capabilities 列出的最接近模型并说明。
  • 竞速形态需在开始时为每个分支命名其模型。
  • 未提交的编辑不会进入新工作树,因此需先提交。
  • 若某个 worker 掉队,则以 N-1 继续并记录。
  • 不要粘贴原始 worker 输出。

关于收费、价格、平台支持等具体信息,资料中暂未提供。