Swarm Coord — 多 Agent 协作

把大任务拆成小任务，分配给多个 Agent 并行执行，自动汇总结果。

什么时候用

• 用户下达复合型任务（涉及多个领域）
• 用户说"分工"、"协作"、"团队干"、"swarm"
• 任务明显可以并行处理（不存在强依赖关系）
• CEO 主动判断当前任务适合拆分

核心理念

一个人干所有事太慢。把任务拆开，多个 Agent 同时干，CEO 统筹汇总。

模式参考：Team Lead + Teammates

• Team Lead（CEO）：拆分任务、分配、监控进度、汇总结果
• Teammates（coding/secretary/HR 等）：各自执行分配到的子任务

执行流程

Phase 1 — 分析与拆分（Decompose）

1. 分析用户的原始请求
2. 识别可并行的子任务
3. 为每个子任务确定：
• 负责 Agent：coding / secretary / HR / 或新建临时 Agent
• 任务描述：清晰的执行指令
• 预期输出：需要返回什么结果
• 依赖关系：是否需要等其他任务完成

输出拆分方案供用户确认（除非用户说"直接干"）。

Phase 2 — 分发与执行（Dispatch）

1. 用 sessions_spawn 为每个子任务创建独立 session
2. 并行启动所有无依赖的子任务
3. 有依赖的任务排队等待前置任务完成
4. 用 sessions_yield 等待子 Agent 返回结果

分发时传递的信息：

• 明确的任务描述
• 需要的上下文（文件路径、配置值等）
• 期望的输出格式
• 超时时间

Phase 3 — 监控与协调（Monitor）

1. 跟踪每个子任务的状态（进行中/完成/失败）
2. 如果某个子任务失败，决定：
• 重试一次
• 跳过并标记
• 终止整个 swarm
3. 如果子任务之间需要传递中间结果，CEO 负责转发
4. 定期向用户汇报进度（长任务时）

Phase 4 — 汇总与报告（Aggregate）

1. 收集所有子任务的结果
2. 整合成统一的报告
3. 标注成功/失败/跳过的任务
4. 向用户呈现最终结果

汇总报告格式：

🐝 Swarm 任务完成
━━━━━━━━━━━━━━━

📋 原始任务：整理本周会议纪要 + 更新文档 + 发周报

👥 执行分工：
├─ 🤖 Secretary：整理会议纪要 ✅（3 份纪要）
├─ 💻 Coding：更新项目文档 ✅（README + CHANGELOG）
└─ 📊 CEO：汇总写周报 ✅

⏱️ 总耗时：2 分 30 秒（并行节省约 60%）

📝 成果：
- 会议纪要已发送到飞书群
- 项目文档已更新并 push
- 周报已发送给董事长

任务拆分原则

适合拆分的任务

• 多领域综合任务（技术 + 文档 + 沟通）
• 批量处理任务（处理 10 个文件）
• 信息收集任务（同时搜索多个来源）

不适合拆分的任务

• 强顺序依赖（第二步必须用第一步的结果）
• 简单单步任务（问个问题就行）
• 需要持续交互的任务（反复确认修改）

Agent 能力匹配

规则

• 先拆后做：除非用户说"直接干"，否则先展示拆分方案
• 并行优先：无依赖的任务同时启动
• 容错设计：单个子任务失败不影响其他任务
• 进度透明：长任务定期汇报进度
• 结果汇总：所有子任务完成后统一呈现结果
• 超时保护：子任务超时自动终止并标记

与其他 Skill 的配合

• Session Resume：Swarm 任务的整体进度可以保存到 .task-state.json
• Smart Compact：子 Agent 的对话独立，不影响 CEO 的上下文
• Memory-Dream：Swarm 的执行结果会被记录到日记，由 Dream 整合