Team 多 Agent 协作

Team Lead (主 Agent)
  ├── Agent A (researcher)   ← 独立进程
  │   ├── 独立对话上下文
  │   ├── 独立工具集
  │   └── 独立工作目录
  ├── Agent B (coder)        ← 独立进程
  │   ├── 独立对话上下文
  │   ├── 独立工具集
  │   └── 独立工作目录
  └── Agent C (tester)       ← 独立进程
      ├── 独立对话上下文
      ├── 独立工具集
      └── 独立工作目录

共享资源:
  ├── 任务列表 (~/.claude/tasks/{team-name}/)
  ├── Team 配置 (~/.claude/teams/{team-name}/)
  └── 文件系统 (同一工作目录)

await TeamCreate({
  team_name: "feature-team",
  description: "Building feature X"
})

~/.claude/teams/feature-team/
└── config.json              # Team 配置

~/.claude/tasks/feature-team/
└── (任务文件)

{
  "team_name": "feature-team",
  "description": "Building feature X",
  "created_at": "2024-01-01T00:00:00Z",
  "members": [
    {
      "name": "team-lead",
      "agentId": "agent-001",
      "agentType": "lead"
    },
    {
      "name": "researcher",
      "agentId": "agent-002",
      "agentType": "general"
    }
  ]
}

// 启动一个 Agent 作为队友
spawnAgent({
  name: "researcher",         // 队友名称
  team_name: "feature-team",  // 所属 Team
  subagent_type: "general",   // Agent 类型
})

1. 启动 → 空闲状态
2. 接收消息 → 唤醒执行
3. 完成任务 → 标记完成
4. 空闲 → 等待下一条消息
5. 收到 shutdown → 终止

TaskCreate({ subject: "Research API design", description: "..." })
TaskCreate({ subject: "Implement frontend", description: "..." })
TaskCreate({ subject: "Write tests", description: "..." })

// 测试任务依赖实现任务
TaskUpdate({ taskId: "3", addBlockedBy: ["2"] })

TaskUpdate({ taskId: "1", owner: "researcher" })
TaskUpdate({ taskId: "2", owner: "coder" })

1. Team Lead 创建所有任务
2. 设置任务依赖关系
3. 分配或让 Agent 自行认领
4. Agent 完成任务后标记 completed
5. 自动解除下游任务的阻塞
6. 重复直到所有任务完成

// 点对点
SendMessage({ 
  to: "researcher", 
  message: "请开始 API 设计研究" 
})
 
// 广播
SendMessage({ 
  to: "*", 
  message: "代码风格指南已更新" 
})

发送方 → 消息队列 → 接收方

- 消息自动投递，无需轮询
- Agent 空闲时立即处理
- Agent 忙碌时消息排队
- 每次只处理一条消息

// 普通消息
SendMessage({ to: "researcher", message: "Start on task #1" })
 
// 结构化消息（关闭请求）
SendMessage({ 
  to: "team-lead", 
  message: { 
    type: "shutdown_response", 
    request_id: "req-1", 
    approve: true 
  }
})

~/.claude/teams/{team-name}/config.json

~/.claude/tasks/{team-name}/

// 1. 通知所有队友关闭
SendMessage({ to: "*", message: { type: "shutdown_request" } })
 
// 2. 等待队友确认
// 3. 清理 Team 资源
TeamDelete()

// TeamDelete 会检查是否还有活跃成员
// 如果所有成员已关闭，允许删除
TeamDelete()

1. Team Lead 创建 Team
   TeamCreate({ team_name: "auth-feature" })

2. 创建任务
   TaskCreate({ subject: "Research auth patterns" })
   TaskCreate({ subject: "Implement JWT auth" })
   TaskCreate({ subject: "Write auth tests" })
   TaskUpdate({ taskId: "3", addBlockedBy: ["2"] })

3. 启动队友
   spawnAgent({ name: "researcher", team_name: "auth-feature" })
   spawnAgent({ name: "coder", team_name: "auth-feature" })
   spawnAgent({ name: "tester", team_name: "auth-feature" })

4. 分配初始任务
   SendMessage({ to: "researcher", message: "开始任务 #1" })

5. 队友自行协调
   - researcher 完成后标记任务
   - coder 认领下一个可用任务
   - tester 等待阻塞解除

6. 完成后关闭
   SendMessage({ to: "*", message: { type: "shutdown_request" } })
   TeamDelete()