关于 swarm
swarm 是用于协调并行工作者的 Agent 技能,涵盖任务规划、分派、汇总和报告。它规定了工作者隔离、验证证据及故障处理方式。
主要功能
- 01四阶段工作流程
- 02并行分派原生及外部工作者
- 03隔离工作者输出路径
- 04基于证据汇总结果
适用场景
- 01将任务拆分为工作者负责的部分
- 02让多个工作者执行相同任务以作比较
- 03汇总经验证的结果并记录故障缺口
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ ericlitman/ open-pstack --skill swarm安装后在 Claude Code 中输入/swarm确认已加载。
详细介绍
Swarm
派发约定。 通过 provider-dispatch.md 解析每个工作者描述符。父级启动原生和外部通道;工作者不得自行路由。在 Codex 上,通过 codex-tools.md 解析剩余的 Claude 工具名称。
开始
启动任何工作之前,先创建一个待办清单,每个阶段列出一项。
- 定义目标
- 扇出
- 汇总
- 报告
阶段 A:定义目标
- 说明完成条件,以及 swarm 必须返回的产物或报告。
- 选择组织方式:拆分为多个切片、让 N 个工作者基于相同简报竞速,或两者结合。对于竞速或混合方式,在启动前声明采用
first pass、rank all还是best-of。 - 如果当前运行环境的 pstack 模型表中有
swarm workers,就从中选择工作者描述符;否则使用其角色默认值。对于模型竞速,预先指定每个参赛方的描述符。根据 poteto-mode 技能的 Subagents 部分,为每个子代理选择适合任务的工作量级别。 - 如果工作者要写入内容,为每个工作者分配独立且可写的输出位置。工作者验证或测量提交时,每份简报都要列出确切的 SHA。测量简报还要说明方法(样本数量、每个样本的定义、顺序)。工作者必须在结果中记录这两项。
阶段 B:扇出
通过提供方派发,在同一个扇出阶段启动全部 N 个工作者。原生通道使用后台子代理;外部通道则以后台任务方式调用启动器,并保留任务/会话句柄。对于长时间运行的工作者,切勿使用 Claude 的前台 Bash 路径。每个写入者都在分配给自己的 worktree 或输出目录中运行。隔离依靠这些路径,而非提供方。
如果工作者必须从非默认分支开始工作,则在其自己的 worktree 中检出该分支,并在简报中注明 worktree 路径。
每份简报都必须独立完整。简报需包含目标、范围、确切的切片或竞速参赛方、验证方法和报告要求。报告使用 PASS、ISSUES 或 BLOCKED,并附上证据。能够证实缺陷的工作者应报告 ISSUES,并列出所有能够证实的问题,而不只是第一个问题。
如果工作者退出,则继续使用 N-1 个工作者,并注明提供方、模型和回执失败情况。绝不静默替换其他提供方。
阶段 C:汇总
读取最终结果。如果结果未记录其简报中指定的 SHA 和方法,则舍弃该结果,并让该工作者重试一次。第二次仍未达标,则记录一个缺口。缺口不算通过。对于覆盖范围,每个必需切片都必须有结果。对于竞速,按预先声明的选择规则处理:使用 first pass、rank all 或 best-of。不要粘贴工作者的原始输出。
阶段 D:报告
在聊天中返回一份汇总报告,包含表格、问题摘要、缺口或退出情况,以及适用时的竞速规则。