用途:当 /spectacular:execute 遇到 plan.md 中标记为 Parallel 的阶段时,用该技能编排并发任务执行。其核心原则是“并行阶段 = worktree + 子代理”,N≥2 与 N=1 都必须使用隔离 worktree,不得退回主 worktree 或串行策略。
主要能力与流程:
- 前置校验:确认编排器位于主仓库根目录、主 worktree 与主分支存在、阶段基于正确基线分支;多仓库模式下校验 workspace root 与各任务仓库的 .git。
- 续跑检查:按分支名模式匹配判断任务是否已完成,仅对未完成任务创建 worktree,全部完成则直接进入 stacking。
- 创建工作树:单仓库用 git worktree add .worktrees/{runid}-task-${TASK_ID} --detach "$BASE_BRANCH";多仓库先 cd ${TASK_REPO} 再创建,并跨仓库验证。使用 detached HEAD 以避免同一分支被多个 worktree 占用。
- 安装依赖:逐 worktree 安装,单仓库读取项目根 CLAUDE.md 的 install/postinstall;多仓库读取各任务仓库 CLAUDE.md,常见命令如 pnpm install、pip install -r requirements.txt,由资料举例如示,不可跨 worktree 共享依赖。
- 提取阶段边界:明确本阶段任务与后续阶段任务,防止子代理实现超出范围的代码。
- 分发子代理:在单条消息中发起多个 Task 调用以实现并行;每个子代理携带 worktree 路径、任务文件、验收标准、阶段边界、constitution 路径等上下文,并在实现前阅读 spec 与 constitution。
适用场景:多任务可独立并行、需隔离工作目录、多仓库前后端同时开发、需从中断处恢复执行等。
限制:并行必须以 worktree 隔离为前提;缺少 spec 时应停止并报告错误;不得跳过前置校验,也不得因文件不重叠、磁盘或时间压力而省略 worktree。原文未提供具体安装命令、版本要求与性能数据,这些需以仓库内 CLAUDE.md 配置为准。