ethanreedlabs/sulde/parallel-dev

并行 Dev 派发(worktree-based)

为多个互不耦合的任务建 worktree,让多个 Dev 子 agent 并行实施,完成后顺序 merge develop。

stack 决定后必先 Read 对应 references:

§1 能力档

每个子 agent 读取 task 的 capability_tier,按目标宿主当前模型渲染(参 /assign skill §2)。 主协调与子任务都不得把某个宿主的型号或 thinking 语法写成共享任务真值。

§2 触发条件 — 紧耦合识别 5 问

派 ≥ 2 个 task 前必跑:

任一命中 → 改串行(用 /assign 顺序派,不用 /parallel-dev)。

§3 公共文件白名单(stack 通用 — 永不并行改)

改这些 = 派 1 人专修,其他 task 等其 merge develop 后再启动。

详 stack 实际文件名 + 备选 list 见 references/{stack}.md §1。

§4 执行流程

Step 1:列任务清单

用户给 N 个并行任务,主协调端先 audit 5 问。

Step 2:为每个任务建 worktree

git worktree add -b dev/{alias}/{module} ../{project}-{worktree-name} develop

worktree 命名建议:{project}-{slug},与项目 root 同父目录。

Step 3:并行 spawn N 个子 agent

用 Agent 工具同 message 内多个 tool_use 块并行启动。每个 agent prompt:

你是 {project} {stack} 项目的 Dev,身份 {git as-X}。
 
任务文件:{task-md path}
worktree:{worktree-path}
分支:dev/{alias}/{module}
 
执行:
1. cd 到 worktree
2. 跑 /assign skill(stack-specific verify 见 ${CLAUDE_PLUGIN_ROOT}/skills/dev/assign/SKILL.md + references/{stack}.md)
3. 修复 / 实施
4. 跑 §5 verify strict(build + install + log + screenshot)
5. 写 handoff(/handoff skill)
6. 通报主协调:任务完成 / 阻塞

Step 4:主协调汇总

收齐 N 个 handoff 后:

1. 看每个 handoff § verify 是否通过
2. 看 § escalation 候选 是否合并冲突 / 跨任务影响
3. 按依赖顺序 merge develop(若无依赖,顺序无关)

Step 5:清理 worktree

git worktree remove ../{project}-{worktree-name}
git branch -D dev/{alias}/{module}  # 已 merge 才 -d / 未 merge 报错

§5 能力档矩阵(主 spawn 时给子 agent)

§6 子 agent verify 要求

每个并行 task 完工标准(与 /assign §5 一致):

1. build(stack-specific 命令见 references/{stack}.md §3)
2. install(install_cmd)
3. launch + 30s log(无 crash)
4. screenshot diff(若 UI 改)

handoff § verify 必含 4 项证据。

§7 失败处理

§8 命名 / 分支约定

• worktree 路径:../{project}-{slug}(与项目同父)
• branch 格式:dev/{alias}/{module}(同 /assign skill)
• handoff 路径:每 worktree 内 .ai-workspace/handoff/{date}-{slug}-result.md

§9 何时不用 /parallel-dev