用途:仅在用户要求并行工作时使用。任务相互独立是采用并行的前提,并行只是更省时的实现方式。
模式选择:partition 为默认模式,适用于不共享文件或状态的独立任务,每个任务一个 worker 子代理。race 是对同一任务做多次完整尝试。coverage 是用完成检查覆盖一项工作的多个部分。相关失败不属于任何模式,应先一起调查。
成本确认:race 或 coverage 运行前,先说明成本,即多少个子代理、多少次完整尝试,用户同意后再启动。
partition 用法:给每个 worker 一份简报,包含范围、上下文、约束和预期返回。范围应是一个文件、一个子系统或一个问题。把错误信息、测试名称和相关路径粘贴进简报,代理不会从会话中获得任何内容。约束说明不得更改的内容。预期返回是根因与变更摘要,便于审查集成。
启动与集成:在一次 subagent workflow 调用中以 runs.all 批量启动所有子代理。编辑文件的 worker 使用 worktree: true,避免共享检出。pi-subagents 扩展只从干净检出启动。集成时,worktree: true 的 worker 以补丁形式返回变更,运行文件夹中的 handoff.json 的 groups[].children[].patch.path 指向补丁文件,用 git apply --3way 应用,按意图解决冲突,再运行 verify 技能。
限制:partition 不适用于失败相关、原因未知或代理会触碰相同文件的情况。race 不应平均不同设计。coverage 没有完成检查不得启动。批次通过 verify 后,可询问用户是否用 subagent({ action: "worktree.discard", options: { handoffPath } }) 移除 worktree 和分支。