mcpField
P
parallel-agents

parallel-agents

github.com/parcadeiAgent 工作流3.9k513 次安装40 周前更新
代码仓库

关于 parallel-agents

parallel-agents 是一项并行协调多个 Agent 的技能，旨在控制上下文增长。它建议使用后台执行、文件记录状态和结果，并将每批 Agent 数量限制为 15 个。

主要功能

  1. 01在后台运行 Agent
  2. 02通过状态文件确认完成
  3. 03追加状态而非覆盖
  4. 04在独立目录保存详细发现
  5. 05每批最多运行 15 个 Agent

适用场景

  1. 01并行协调 Agent，避免加载完整输出
  2. 02通过共享状态文件跟踪批次完成情况
  3. 03保存详细研究结果供后续使用

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill parallel-agents

安装后在 Claude Code 中输入/parallel-agents确认已加载。

详细介绍

并行 Agent 编排

并行启动多个 Agent 时，请遵循以下模式，避免上下文膨胀。

核心原则

  1. 不调用 TaskOutput - TaskOutput 会返回 Agent 的完整输出，导致上下文膨胀
  2. 在后台运行 - 始终使用 run_in_background: true
  3. 通过文件确认 - Agent 将状态写入文件，而不是返回值
  4. 追加，而非覆盖 - 多个 Agent 可以写入同一个状态文件

输出模式

简单确认（并行批处理）

适用于只需 Agent 确认完成的任务：

# Agent writes to shared status file
echo "COMPLETE: <task-name> - $(date)" >> .claude/cache/<batch-name>-status.txt
  • 使用 >> 追加（不要使用会覆盖内容的 >）
  • 添加时间戳以便排序
  • 每个 Agent 完成后写一行
  • 使用以下命令检查：cat .claude/cache/<batch-name>-status.txt
详细输出（研究/探索）

适用于需要详细发现结果的任务：

.claude/cache/agents/<task-type>/<agent-id>/
├── output.md      # Main findings
├── artifacts/     # Any generated files
└── status.txt     # Completion confirmation
  • 为每个 Agent 分配独立目录
  • 保留完整输出，供稍后查阅
  • 仍然使用状态文件快速检查完成情况

任务提示词模板

# Task: <TASK_NAME>

## Your Mission
<clear objective>

## Output
When done, write confirmation:
\`\`\`bash
echo "COMPLETE: <identifier> - $(date)" >> .claude/cache/<batch>-status.txt
\`\`\`

Do NOT return large output. Complete work silently.

启动模式

// Launch all in single message block (parallel)
Task({
  description: "Task 1",
  prompt: "...",
  subagent_type: "general-purpose",
  run_in_background: true
})
Task({
  description: "Task 2",
  prompt: "...",
  subagent_type: "general-purpose",
  run_in_background: true
})
// ... up to 15 parallel agents

监控

# Check completion status
cat .claude/cache/<batch>-status.txt

# Count completions
wc -l .claude/cache/<batch>-status.txt

# Watch for updates
tail -f .claude/cache/<batch>-status.txt

批次大小

  • 每个并行批次最多 15 个 Agent
  • 等待当前批次完成后再启动下一批
  • 使用状态文件跟踪已完成的任务

应做事项

  • 始终使用 run_in_background: true
  • 让 Agent 将状态写入文件
  • 使用追加方式（>>），不要覆盖（>）
  • 为每个 Agent 提供清晰、独立的指令
  • 在提示词中包含所有上下文（Agent 之间不共享记忆）

不应做事项

  • 调用 TaskOutput（会导致上下文膨胀）
  • 让 Agent 返回大量输出
  • 一次启动超过 15 个 Agent
  • 依赖 Agent 的返回值进行编排

示例：提供商数据回填

# Status file
.claude/cache/provider-backfill-status.txt

# Each agent appends on completion
echo "COMPLETE: anthropic - Thu Jan 2 12:34:56 2025" >> .claude/cache/provider-backfill-status.txt
echo "COMPLETE: openai - Thu Jan 2 12:35:12 2025" >> .claude/cache/provider-backfill-status.txt

检查进度：

cat .claude/cache/provider-backfill-status.txt
# COMPLETE: anthropic - Thu Jan 2 12:34:56 2025
# COMPLETE: openai - Thu Jan 2 12:35:12 2025

评论

支持 Markdown