mcpField
S
swarm

swarm

github.com/ericlitmanAgent 工作流53846 次安装1 周前更新
代码仓库

关于 swarm

swarm 是用于协调并行工作者的 Agent 技能,涵盖任务规划、分派、汇总和报告。它规定了工作者隔离、验证证据及故障处理方式。

主要功能

  1. 01四阶段工作流程
  2. 02并行分派原生及外部工作者
  3. 03隔离工作者输出路径
  4. 04基于证据汇总结果

适用场景

  1. 01将任务拆分为工作者负责的部分
  2. 02让多个工作者执行相同任务以作比较
  3. 03汇总经验证的结果并记录故障缺口

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ericlitman/open-pstack --skill swarm

安装后在 Claude Code 中输入/swarm确认已加载。

详细介绍

Swarm

派发约定。 通过 provider-dispatch.md 解析每个工作者描述符。父级启动原生和外部通道;工作者不得自行路由。在 Codex 上,通过 codex-tools.md 解析剩余的 Claude 工具名称。

开始

启动任何工作之前,先创建一个待办清单,每个阶段列出一项。

  1. 定义目标
  2. 扇出
  3. 汇总
  4. 报告

阶段 A:定义目标

  1. 说明完成条件,以及 swarm 必须返回的产物或报告。
  2. 选择组织方式:拆分为多个切片、让 N 个工作者基于相同简报竞速,或两者结合。对于竞速或混合方式,在启动前声明采用 first pass、rank all 还是 best-of。
  3. 如果当前运行环境的 pstack 模型表中有 swarm workers,就从中选择工作者描述符;否则使用其角色默认值。对于模型竞速,预先指定每个参赛方的描述符。根据 poteto-mode 技能的 Subagents 部分,为每个子代理选择适合任务的工作量级别。
  4. 如果工作者要写入内容,为每个工作者分配独立且可写的输出位置。工作者验证或测量提交时,每份简报都要列出确切的 SHA。测量简报还要说明方法(样本数量、每个样本的定义、顺序)。工作者必须在结果中记录这两项。

阶段 B:扇出

通过提供方派发,在同一个扇出阶段启动全部 N 个工作者。原生通道使用后台子代理;外部通道则以后台任务方式调用启动器,并保留任务/会话句柄。对于长时间运行的工作者,切勿使用 Claude 的前台 Bash 路径。每个写入者都在分配给自己的 worktree 或输出目录中运行。隔离依靠这些路径,而非提供方。

如果工作者必须从非默认分支开始工作,则在其自己的 worktree 中检出该分支,并在简报中注明 worktree 路径。

每份简报都必须独立完整。简报需包含目标、范围、确切的切片或竞速参赛方、验证方法和报告要求。报告使用 PASS、ISSUES 或 BLOCKED,并附上证据。能够证实缺陷的工作者应报告 ISSUES,并列出所有能够证实的问题,而不只是第一个问题。

如果工作者退出,则继续使用 N-1 个工作者,并注明提供方、模型和回执失败情况。绝不静默替换其他提供方。

阶段 C:汇总

读取最终结果。如果结果未记录其简报中指定的 SHA 和方法,则舍弃该结果,并让该工作者重试一次。第二次仍未达标,则记录一个缺口。缺口不算通过。对于覆盖范围,每个必需切片都必须有结果。对于竞速,按预先声明的选择规则处理:使用 first pass、rank all 或 best-of。不要粘贴工作者的原始输出。

阶段 D:报告

在聊天中返回一份汇总报告,包含表格、问题摘要、缺口或退出情况,以及适用时的竞速规则。

评论

支持 Markdown