用途
swarm 是一个并行任务编排技能，核心用途是把一项工作拆分为 N 个并行工作单元，全部启动、等待完成，并返回一份整合后的报告。适用于命令行触发 /swarm、“swarm this” 表述，以及并行覆盖、竞争（race）、gauntlet 和探索性任务等场景。
主要能力与流程
技能规定在启动任何工作单元之前，先建立任务列表（使用运行环境自带的任务工具；若没有，则使用 ~/.local/state/pstack/checklists/<repo>-<branch>.md 清单文件），每个阶段一条记录，并分为四个阶段：
- Frame（框定）：说明完成判定条件（done predicate）与必须返回的产物或报告；选择形态（按切片分区、以相同任务说明让 N 个工作单元竞争、或混合），对竞争或混合形态在启动前声明选择规则（first pass、rank all 或 best-of）；从 pstack-models.md 的 swarm workers 行选择工作模型并传给 subagent spawn --entry；为写操作的工作单元分配各自可写的输出，要求验证或测量提交的说明中须写明确切 SHA，测量说明还须写明方法（样本数、单样本含义、顺序）。
- Fan out（分发）：在同一轮内一次性启动全部 N 个工作单元；共享检出目录时，并行写入者负责互不重叠的文件且不执行 git 命令；需要写入或从其他提交/分支起步的工作单元使用独立的 --worktree 与 --base；每条任务说明独立自洽，包含目标、范围、切片或竞争分支、验证方式和报告要求；报告使用 PASS、ISSUES 或 BLOCKED 并附证据；启动后结束当前轮次。
- Aggregate（汇总）：读取终端结果；丢弃未记录所需 SHA 与方法的结果，并对该工作单元重试一次；第二次仍缺失则记录为缺口，缺口不计为通过；覆盖形态要求每个必需切片都有结果，竞争形态按事先声明的规则筛选；不直接粘贴原始输出。
- Report（报告）：返回一份整合的对话内报告，包含结果表、问题一句话摘要、缺口或掉线情况，以及所用竞争规则。
使用方式
通过命名技能（粗体、反引号或 /<name> 形式）引用 ../<name>/SKILL.md 并按其执行；多数 pstack 技能仅限用户加载，技能工具无法直接载入。子代理作为 Rex 工作窗格，按 ../rex-subagents/SKILL.md 生成、等待和关闭，默认值见 ../poteto-mode/SKILL.md 的 Subagents 部分。当模型文件或 swarm workers 行缺失时，使用自身运行环境与默认模型运行工作单元，并提示 /setup-pstack。
适用场景
并行覆盖多切片任务、多臂竞争、gauntlet 式多轮检验，以及开放式探索。
限制
资料未说明该技能的具体实现语言、依赖版本、收费方式或性能指标，暂未提供。部分行为依赖 pstack 相关配置文件与配套技能的存在。