用途:为智能体团队建立统一的通信规范。适用于为新团队确立沟通规则、在 message、broadcast、shutdown_request 之间选择消息类型、处理计划审批流程、管理团队优雅关闭,以及发现队友身份与能力。
主要能力与消息类型:message 为默认的点对点直接消息,字段含 type、recipient、content、summary,用于任务更新、协调、提问和集成通知;broadcast 会同时发给所有队友,每发一次会产生与团队规模相当的多条消息,因此仅在影响所有人的关键阻塞或共享资源重大变更时使用;shutdown_request 用于请求队友优雅退出,队友以 shutdown_response 回应批准或给出理由拒绝。
计划审批:当队友以 plan_mode_required 启动时,先用只读探索工具制定计划,调用 ExitPlanMode 向负责人发送 plan_approval_request;负责人通过 plan_approval_response 返回 approve true 或 false,拒绝时可在 content 中给出反馈。
关闭协议:负责人逐一发送 shutdown_request,队友回应 shutdown_response,approve 为 true 则保存状态退出,为 false 则附理由继续;负责人需等待其任务完成后再重试,全部关闭后调用 TeamDelete 释放团队资源,急迫时可由用户强制关闭。
成员发现:读取 ~/.claude/teams/{team-name}/config.json 中 members 的 name、agentId、agentType。发消息和分配任务始终使用 name,不要使用 agentId、角色名或未加后缀的别名;若队友以 team-lead-2 启动,就发给 team-lead-2。
反模式:不要广播例行更新,改用直接消息;不要用 JSON 状态消息,应用 TaskUpdate 更新任务状态;在集成点必须通知接口就绪;不要逐步微观管理;不要用 UUID 代替名字;不要忽视空闲队友,应分配新工作或关闭。
常见问题:队友不响应可能是空闲或仍在执行;若受限工具白名单中缺少 SendMessage、TaskList、TaskGet、TaskUpdate 需显式列出;shutdown 被拒绝通常仍在工作,应查看理由等待后重试,不应强制终止有未保存工作的队友;plan_approval_request 缺少 request_id 需重新进入计划模式再调用 ExitPlanMode;两名队友互相等待属死锁,负责人应向其中一方发送桩结果或部分结果以解除阻塞。
限制:本资料未提供收费、价格、平台支持范围及具体运行环境的进一步说明。