| name | multi_agent_collaboration |
| description | 当需要其他 agent 的专长、上下文或协作支持，或用户明确要求调用其他 agent 时，使用本 skill。先用 list_agents 查询可用 agents，再用 chat_with_agent 或 submit_to_agent 进行协作。 |
| metadata | {"builtin_skill_version":"1.6","qwenpaw":{"emoji":"🤝"}} |
多智能体协作
什么时候用
当你需要其他 agent 的专业能力、上下文、workspace 内容或协作支持时，使用本 skill。
如果用户明确要求某个 agent 参与/协助/回答，也应使用本 skill。
应该使用
- 当前任务明显更适合某个专用 agent
- 需要另一个 agent 的 workspace / 文件 / 上下文
- 需要第二意见或专业复核
- 用户明确要求某个 agent 参与或调用其他 agent
- 任务可以拆给同项目的临时子 agent 独立处理
不应使用
- 你自己可以直接完成，且用户没有明确要求调用其他 agent
- 只是普通问答，不需要专门 agent
- 信息不足，应先追问用户
- 刚收到 Agent B 的消息，不要再调用 Agent B，避免循环
决策规则
- 如果用户明确要求调用其他 agent，优先按要求执行
- 否则，能自己做，就不要调用
- 调用前先查 agent，不要猜 ID
- 需要上下文续聊时，必须传
session_id
- 不要回调消息来源 agent
- 简单快速咨询用
chat_with_agent；复杂或耗时任务用 submit_to_agent，再用 check_agent_task 查询
可用工具
1) 查询可用 agents
list_agents()
使用返回结果里的 agent id，不要猜测 ID。
2) 发起实时对话
chat_with_agent(
to_agent="<target_agent_id>",
text="[Agent <your_agent_id> requesting] ...",
)
实时模式会等待目标 agent 完成，并返回回复。返回中通常包含：
[SESSION: ...]
后续需要保留上下文时，复制该 session_id 继续传入。
3) 继续已有对话
chat_with_agent(
to_agent="<target_agent_id>",
session_id="<previous_session_id>",
text="[Agent <your_agent_id> requesting] 请基于刚才的结论继续展开。",
)
重点:
- 不传
session_id = 新对话
- 传
session_id = 续聊，保留目标 agent 的上下文
4) 提交后台任务
复杂任务包括：数据分析、报告生成、批量处理、外部 API 调用、长时间代码检查等。
submit_to_agent(
to_agent="<target_agent_id>",
text="[Agent <your_agent_id> requesting] ...",
)
返回中通常包含：
[TASK_ID: ...]
[SESSION: ...]
提交后不要硬等。根据任务复杂度，等待合理时间后再查：
- 简单分析：10-20 秒
- 复杂分析：30-60 秒
- 批量处理：1-3 分钟
5) 查询后台任务
check_agent_task(
task_id="<task_id>",
)
任务完成时会返回目标 agent 的最终结果；未完成时会返回当前状态。
6) 当前项目内派发临时子任务
如果任务适合在当前 agent / 当前 workspace 下开一个干净的临时子任务，而不是调用另一个长期配置的 agent，可使用：
spawn_subagent(
task="请独立检查当前项目中的测试风险并给出结论。",
)
如需后台执行：
spawn_subagent(
task="请独立完成较长的代码审查并输出报告。",
background=true,
)
返回 task_id 后同样用 check_agent_task(task_id=...) 查询。
当前 Java 运行时尚未实现 spawn_subagent(fork=true) 的 worktree 隔离；不要使用 fork=true，除非工具明确返回已支持。
任务模式选择
| 任务类型 | 使用方式 |
|---|
| 简单快速查询 | chat_with_agent |
| 需要多轮咨询 | chat_with_agent + session_id |
| 复杂或耗时任务 | submit_to_agent + check_agent_task |
| 当前项目内独立子任务 | spawn_subagent |
最小工作流
实时模式
1. 判断是否需要其他 agent，或用户是否明确要求调用
2. list_agents()
3. chat_with_agent(...) 发起对话
4. 从输出中记录 [SESSION: ...]
5. 后续需要上下文时传 session_id
后台模式
1. 判断任务是否复杂或耗时
2. list_agents()
3. submit_to_agent(...) 提交任务
4. 从输出中记录 [TASK_ID: ...] 和 [SESSION: ...]
5. 继续处理其他工作
6. 等待合理时间后 check_agent_task(...)
身份前缀
消息建议以以下内容开头：
[Agent <your_agent_id> requesting] ...
这样目标 agent 能明确消息来源。若系统已自动添加，不要重复添加。
简短示例
用户明确要求调用其他 agent
list_agents()
chat_with_agent(
to_agent="finance_bot",
text="[Agent scheduler_bot requesting] User explicitly asked to consult finance_bot. 请回答当前待处理的财务任务。",
)
新对话
chat_with_agent(
to_agent="finance_bot",
text="[Agent scheduler_bot requesting] 今天有哪些待处理的财务任务？",
)
续聊
chat_with_agent(
to_agent="finance_bot",
session_id="scheduler_bot:to:finance_bot:1710912345:a1b2c3d4",
text="[Agent scheduler_bot requesting] 展开第 2 项。",
)
后台任务
submit_to_agent(
to_agent="qa_bot",
text="[Agent default requesting] 请检查这次改动的回归风险并给出报告。",
)
check_agent_task(
task_id="task-abc123",
)
常见错误
错误 1：没先查 agent
不要猜 agent ID，先调用：
list_agents()
错误 2：想续聊但没传 session_id
这会创建新对话，目标 agent 可能丢失上下文。
错误 3：回调来源 agent
如果你刚收到 Agent B 的消息，不要再调用 Agent B。
错误 4：耗时任务用实时模式
长任务应使用 submit_to_agent 或 spawn_subagent(background=true)，不要长时间阻塞当前对话。
