parallel-execution

name	parallel-execution
description	并行执行框架：基于 Git worktree 的多实例并行、任务分发与动态扩展。 当任务可拆分、需要加速执行、或需要多分支并行开发时使用。

Parallel Execution Framework

用途

• 任务并行：拆分可独立执行的任务并并行处理
• 分支隔离：使用 Git worktree 实现多分支并行开发
• 资源扩展：根据任务复杂度动态扩展执行实例
• 级联执行：串联依赖任务，并行独立任务

核心概念

1. 任务类型

类型	说明	并行策略
independent	无依赖，可立即执行	并行
sequential	依赖前一任务输出	串行
parallel	多个独立任务	并行
cascade	主任务触发子任务	级联

2. Git Worktree 并行

worktree add <path> <branch>  # 创建新 worktree
worktree list                  # 列出所有 worktree
worktree prune                 # 清理无效 worktree

3. 扩展策略

• Scale Out：增加并行实例数（横向扩展）
• Scale Up：提升实例规格（纵向扩展）
• Cascade：主任务完成后触发子任务

触发信号

• 任务可明确拆分为多个独立子任务
• 需要在多个分支上并行开发
• 任务耗时超过 10 分钟且可拆分
• 需要同时验证多个方案

使用约束

1. 任务拆分后，每个子任务必须有明确的输入输出
2. 并行任务之间不能有写冲突
3. 需要共享的状态通过文件或消息传递
4. 主任务负责汇总子任务结果
5. 失败处理：部分失败时，主任务决定是重试、跳过还是中止

配套工具

• scripts/lib/parallel_execution.py - 底层并行执行接口
• GitWorktreeManager - worktree 管理
• TaskDistributor - 任务分发
• ResultAggregator - 结果汇总

命令接入

• /parallel <task描述> - 分解并并行执行任务
• /worktree-create <branch> - 创建 worktree 分支
• /worktree-list - 列出所有 worktree
• /scale-out <num> - 扩展到 N 个并行实例