用途
parallel-agents 用于把多个相互独立的任务同时分派给多个子智能体执行。判断是否适用的链条是：多个任务？→ 是否独立？→ 是否无共享状态？→ 若满足则并行派发。
主要能力
- 并行调度多个子智能体处理独立任务。
- 通过 sessions_spawn 创建并行子智能体。
- 把任务按领域分组，并编写聚焦、自洽的提示词。
- 在各子智能体返回后整合结果，并按流程核对与验证。
使用方式
1. 识别独立领域
把任务按领域分组，例如：
- 任务 A：UI 缺陷修复
- 任务 B：API 性能优化
- 任务 C：测试编写 并确认每个领域彼此独立。
2. 编写聚焦的提示词
好的提示词应满足：
- 特定范围：只针对一个明确问题。
- 自洽完整：包含所需的全部上下文。
- 输出明确：说明智能体应返回什么。 示例对比：
- ❌“修复所有测试”——范围过宽
- ✅“修复 src/game/physics.test.ts 中 3 个失败测试”——聚焦
- ❌“修复竞态条件”——缺少上下文
- ✅“包含错误信息 + 测试名称 + 堆栈跟踪”——上下文充分
- ❌“修一下”——输出不明
- ✅“返回根因摘要 + 改动内容”——输出明确
3. 在 Clawdbot 中派发
以 sessions_spawn 创建并行子智能体，例如：
- 子智能体 1：“修复 physics.test.ts 的碰撞检测缺陷”
- 子智能体 2：“优化渲染管线性能”
- 子智能体 3：“生成新的游戏关卡资源”（MiniPC）
4. 整合结果
子智能体返回时：
- 审查每份摘要——理解改动内容
- 检查冲突——是否编辑了同一处代码
- 运行整体测试——确认所有修复可协同工作
- 抽查——子智能体也可能出错
适用场景
- 3 个及以上测试文件因不同原因失败。
- 多个子系统各自独立出现故障。
- 每个问题无需其他问题的上下文即可理解。
- 研究 + 实现 + 测试等不同类型的任务。
限制与禁止场景
- 失败彼此相关（修好一个可能连带解决其他）。
- 需要理解整个系统状态。
- 智能体之间需要编辑同一文件。
- 探索式调试（尚不清楚问题是什么）。
常见错误与纠正
- 范围过宽 → 1 个智能体 = 1 个领域
- 缺少上下文 → 包含错误信息、文件路径
- 没有约束 → 明确“禁止修改生产代码”等
- 输出不清晰 → 明确“根因 + 改动摘要”
收益说明
3 个问题串行处理 = 3T 时间；3 个问题并行处理 ≈ 1T 时间。独立领域越多，收益越大。
Guardrails
- 并发智能体上限 5 个——同时运行的子智能体最多 5 个；超出时先清理已完成的智能体，再派发新的智能体。
- 防止共享资源冲突——多个智能体同时写同一文件、数据库表或端口时，需指定 mutex 或文件分离策略；在智能体提示词中包含禁止修改文件列表。
- 失败智能体自动清理——智能体失败（超时、报错）时，立即清理其临时文件、锁文件、部分提交；清理完成后再重试或报告错误。
- 必须设置整体流水线超时——除单个智能体超时外，还需为整个并行流水线设置最大运行时间。默认值 600 秒（单个智能体 300 秒 × 2 个阶段）。超时后强制终止所有运行中的智能体并向 Master 报告。