⚡

并行执行 parallel

并行执行多个独立任务，适用于需要同时处理多个独立修复、并行审查或批量处理的场景。关键词：并行、独立任务、修复、审查、批量处理。

DevOps 0 次安装 0 次浏览 更新于 3/4/2026

版本：2.88.0

name: parallel description: “并行运行多个Ralph循环以处理独立任务。管理并行代理执行，确保适当的隔离和结果聚合。使用场景：(1)需要多个独立修复，(2)需要并行审查，(3)批量处理任务。触发器：/parallel, ‘parallel loops’, ‘concurrent execution’, ‘run in parallel’, ‘batch’.” context: fork user-invocable: true allowed-tools:

  • LSP
  • Task
  • TaskOutput
  • Read
  • Edit
  • Write
  • Bash hooks: PreToolUse:
    • path: .claude/hooks/validate-lsp-servers.sh match_tool: LSP

并行 - 并发执行 (v2.88)

并行运行多个Ralph循环以处理独立任务。

v2.88关键变更 (模型无关)

  • 模型无关：使用~/.claude/settings.json或CLI/env vars配置的模型
  • 无需标志：所有并行任务使用配置的默认模型
  • 灵活：适用于GLM-5, Claude, Minimax或任何配置的模型
  • 设置驱动：通过ANTHROPIC_DEFAULT_*_MODEL环境变量选择模型

代理团队集成 (v2.88)

最佳场景：集成（代理团队+自定义子代理）

并行执行结合代理团队协调与ralph-coder专业化以优化并行文件处理。

为什么并行执行选择场景C

  • 多个文件需要协调分发
  • 结果验证的质量门控至关重要
  • 专门的ralph-coder代理用于实现
  • 共享任务列表跟踪所有并行工作

自动团队创建

当并行技能被调用时，自动创建一个团队：

# 在技能调用时自动创建团队
TeamCreate:
  team_name: "parallel-execution-{timestamp}"
  description: "并行执行独立任务"

并行代理生成

为并行任务创建多个ralph-coder实例：

# 并行生成3个ralph-coder代理
Task:
  subagent_type: "ralph-coder"
  team_name: "parallel-execution-{timestamp}"
  prompt: "修复src/auth/中的认证错误"

Task:
  subagent_type: "ralph-coder"
  team_name: "parallel-execution-{timestamp}"
  prompt: "修复src/api/中的API错误"

Task:
  subagent_type: "ralph-coder"
  team_name: "parallel-execution-{timestamp}"
  prompt: "修复src/ui/中的UI错误"

任务协调模式

使用共享任务列表进行协调：

# 创建主任务列表
TaskCreate:
  subject: "并行修复批次"
  description: "并行执行认证、API和UI修复"

# 创建具有依赖关系的子任务
TaskCreate:
  subject: "修复认证错误"
  activeForm: "正在修复认证错误"

TaskCreate:
  subject: "修复API错误"
  activeForm: "正在修复API错误"

TaskCreate:
  subject: "修复UI错误"
  activeForm: "正在修复UI错误"

质量门控

通过代理团队钩子进行质量验证：

钩子 目的 行为
TeammateIdle 预空闲验证 如果发现问题，继续工作+反馈
TaskCompleted 预完成验证 如果发现问题，阻止完成+反馈

执行的质量标准：

  1. 正确性：有效的语法，合理的逻辑
  2. 质量：无console.log，适当的类型，无TODOs
  3. 安全性：无硬编码的秘密，适当的验证
  4. 一致性：遵循项目风格指南

结果聚合

所有并行代理完成后：

# 聚合结果
TaskUpdate:
  taskId: "<master-task>"
  status: "completed"

# 报告摘要
- 所有子任务已完成
- 质量门控通过
- 更改准备提交

快速开始

/parallel "修复认证错误" "修复API错误" "修复UI错误"
ralph parallel task1 task2 task3

使用场景

适合并行

  • 独立的文件更改
  • 多个模块修复
  • 批量审查
  • 不同的分析类型

必须顺序执行

  • 依赖更改
  • 同一文件修改
  • 顺序依赖操作
  • 共享状态更改

工作流程

1. 创建团队和生成代理

# 自动为协调创建团队
TeamCreate:
  team_name: "parallel-{task-name}"
  description: "并行执行{task-name}"

# 启动多个ralph-coder后台代理
Task:
  subagent_type: "ralph-coder"
  team_name: "parallel-{task-name}"
  prompt: "执行任务1"

Task:
  subagent_type: "ralph-coder"
  team_name: "parallel-{task-name}"
  prompt: "执行任务2"

Task:
  subagent_type: "ralph-coder"
  team_name: "parallel-{task-name}"
  prompt: "执行任务3"

2. 监控进度

# 检查所有子任务状态的任务列表
TaskList:
  # 返回所有任务的状态、所有者、blockedBy

# 监控特定子任务
TaskGet:
  taskId: "<subtask-id>"

3. 聚合结果

# 标记主任务为完成
TaskUpdate:
  taskId: "<master-task>"
  status: "completed"

# 报告摘要
- 所有子任务已完成
- 质量门控通过
- 更改准备提交

并行模式

审查模式

# 并行审查，不同焦点
/parallel "安全审查src/" "性能审查src/" "质量审查src/"

修复模式

# 并行修复不同模块
/parallel "修复认证错误" "修复API错误" "修复数据库错误"

分析模式

# 并行分析任务
/parallel "分析复杂性" "分析覆盖率" "分析依赖关系"

隔离

每个并行任务运行时：

  • 单独的上下文（context: fork）
  • 独立的迭代计数器
  • 自己的质量门控
  • 隔离的文件访问

结果聚合

全部成功

  • 聚合更改
  • 运行全局门控
  • VERIFIED_DONE

部分成功

  • 报告失败
  • 保留成功的更改
  • 重试失败的任务

全部失败

  • 报告所有错误
  • 分析模式
  • 顺序重试

集成

  • 用于独立子任务
  • 每个并行任务遵循Ralph Loop
  • 结果反馈给协调器

反模式

  • 从不在相同文件上并行运行
  • 并发代理不超过5个
  • 从不忽略部分失败
  • 从不跳过聚合步骤

行动报告 (v2.93.0)

此技能生成完整的自动报告以跟踪：

自动报告

当此技能完成后，会自动生成：

  1. 在Claude的对话中：可见结果
  2. 在仓库中：docs/actions/parallel/{timestamp}.md
  3. JSON元数据：.claude/metadata/actions/parallel/{timestamp}.json

报告内容

每个报告包括：

  • ✅ 摘要：执行的任务描述
  • ✅ 执行细节：持续时间、迭代次数、修改的文件
  • ✅ 结果：发现的错误、建议
  • ✅ 下一步：建议的后续行动

查看先前报告

# 列出此技能的所有报告
ls -lt docs/actions/parallel/

# 查看最新的报告
cat $(ls -t docs/actions/parallel/*.md | head -1)

# 搜索失败的报告
grep -l "Status: FAILED" docs/actions/parallel/*.md

手动生成（可选）

source .claude/lib/action-report-lib.sh
start_action_report "parallel" "任务描述"
# ... 执行 ...
complete_action_report "success" "摘要" "建议"

系统参考