Agent Teams 并行任务框架

概述

使用 Claude Code 的 Agent Teams 功能创建多 agent 团队，支持并行任务执行和异步 Discord 通知。

核心流程

TeamCreate → 并行 Task(background, bypassPermissions) → agent 完成后通知 lead → lead 汇总/决策 → lead 通知用户 → shutdown → TeamDelete

创建团队

TeamCreate → team_name, description

启动 Teammate

每个 teammate 用 Task tool 启动，必须带以下参数：

• team_name: 团队名
• name: 成员名
• subagent_type: "general-purpose"
• mode: "bypassPermissions"（必须，否则权限弹窗卡住）
• run_in_background: true

Teammate Prompt 模板

你是「{名字}」，{team_name} 团队成员，通用型人才。

**日志规则**（必须遵守）：
- 日志文件：~/.claude/teams/{team_name}/logs/{名字}.log
- 启动时创建目录：mkdir -p ~/.claude/teams/{team_name}/logs
- 每次执行操作前后都用 Bash 追加日志：
  echo "[$(date '+%H:%M:%S')] {动作描述}" >> ~/.claude/teams/{team_name}/logs/{名字}.log
- 日志内容包括：收到任务、开始执行、执行进度、完成结果、遇到错误

启动后立刻做两件事：
1. mkdir -p ~/.claude/teams/{team_name}/logs
2. echo "[$(date '+%H:%M:%S')] 【{名字}】已上线，待命中" >> ~/.claude/teams/{team_name}/logs/{名字}.log
3. 用 SendMessage 告诉 team-lead 你已就位

然后等待 team-lead 分配任务。

**禁止直接联系用户**：不要使用 send-to-discord.sh，不要直接给用户发消息。所有沟通必须经过 team-lead。

**任务完成后必须执行两步通知**（缺一不可）：
1. 写日志：echo "[$(date '+%H:%M:%S')] 任务完成：{结果摘要}" >> 日志文件
2. 通知 lead：SendMessage 给 team-lead，包含结果摘要和产出物路径

lead 会决定是否需要通知用户。你只对 lead 汇报。

Teammate 日志

每个 teammate 有独立日志文件，方便实时追踪和 debug：

~/.claude/teams/{team_name}/logs/
├── shunshen.log
├── felix.log
└── chris.log

实时查看：tail -f ~/.claude/teams/{team_name}/logs/*.log 单人查看：tail -f ~/.claude/teams/{team_name}/logs/shunshen.log

通知机制

核心原则：组员 → Lead → 用户。组员禁止直接联系用户。

通知链：

• agent → lead（SendMessage，唯一合法路径）
• lead → 用户（lead 汇总/过滤后决定是否通知用户）

Lead 的职责：

• 收集组员汇报，掌握全局进度
• 过滤噪音，只在需要用户决策或通知最终结果时才打扰用户
• 使用 send-to-discord.sh 通知用户（只有 lead 有权使用）

派活方式

SendMessage → type: "message", recipient: "{name}", content: "任务描述"

关闭团队

SendMessage → type: "shutdown_request" → 每个成员
等 shutdown_approved
TeamDelete

注意事项

1. 幽灵队员: restart 后 config 残留但进程已死，必须 rm -rf ~/.claude/teams/{name} 清理
2. Team vs Sub Agent: 独立并行任务用 sub agent；需要成员间通信协作才用 team
3. 消息错位: 框架限制，teammate 状态消息和用户消息同队列无优先级，通过直达 Discord 缓解
4. 并行启动: 多个 Task 调用放在同一个 message 中并行发出