Qwen Code的Agent Team是一套实验性的多Agent协作机制。它与简单地同时开几个聊天窗口不同：团队成员共享任务列表，可以互相发送消息，并由领导Agent汇总结果。官方设计还特别限制写入方式，调查成员默认只读，需要实现时只安排一个写入者进入独立Git worktree，从流程上减少多个Agent同时改同一文件造成的冲突。
一、什么任务适合Agent Team
适合并行拆分且结果可以汇总的任务，例如一个成员检查接口，一个成员检查前端状态，一个成员检查测试与日志。它不适合步骤高度依赖的短任务，也不适合让多个Agent同时修改同一模块。使用前先判断子任务是否能够独立完成。如果所有成员都必须等待同一份结论，开启团队只会增加沟通成本。
二、启用实验功能
根据官方文档，可以在Qwen Code设置中把experimental.agentTeam设为true并重启，也可以通过QWEN_CODE_ENABLE_AGENT_TEAM=1环境变量启用。启用后建议先在测试仓库尝试，并确认当前分支没有未保存的重要改动。实验功能的命令和行为可能更新，团队使用时要固定Qwen Code版本并记录配置。
三、用coordinate下达清晰目标
官方提供的入口是coordinate命令。不要只说“检查项目”，而要写出目标、范围、输出和限制，例如：“调查登录回归问题，分别检查前端路由、后端权限和最近日志，只读分析，给出最小修复方案和证据。”领导Agent会根据目标拆分工作。越清晰的验收条件，越容易得到可以合并的结果。
四、调查成员为什么默认只读
并行调查的最大风险不是分析错误，而是多个成员在不了解彼此操作时修改同一状态。只读成员可以搜索代码、阅读配置和比较调用链，但不能执行写文件操作。这样各自提供证据，由领导统一判断。如果确实需要实现，创建一个独立worktree并指定唯一写入者，其他成员继续审查。单写入者是保证变更可控的核心规则。
五、合理拆分任务而不是平均分
按系统边界拆分通常比按文件数量拆分更好。例如“请求入口到鉴权”“鉴权到数据库”“响应到页面渲染”三条链路，每条都能给出完整结论。每个任务写明不能做什么、需要提供哪些文件位置和如何证明。不要让三个成员都做全面检查，否则会产生大量重复信息，也难以判断冲突结论。
六、共享任务列表和消息怎么用
任务状态应反映真实进度：未开始、进行中、等待依赖、完成。成员发现跨边界问题时，用消息告知相关成员，而不是自行越权修改。领导需要关注阻塞项，及时调整任务。成员完成后应报告结论、证据、风险和建议，不要只回复“已检查”。有分歧时，领导应要求双方给出可复现依据。
七、从调查进入实现阶段
先由领导汇总根因和最小改动范围，再把明确任务交给唯一写入者。写入者在独立worktree中修改并运行约定验证，提交差异给团队复核。只读成员可以检查接口兼容、状态变化和测试缺口。最终合并权仍在领导或人工维护者手中，不能因为Agent已经完成就自动进入主分支。
八、一个可落地的开发模板
第一步定义故障与验收标准；第二步启动三个只读成员分别查链路；第三步汇总证据并确认根因；第四步创建单一写入者；第五步运行最小测试；第六步由另一成员做回归审查；第七步人工合并。对于小团队，这套流程可以把Agent从“多个人同时猜”变成“分工调查、单点修改、交叉验证”的工程协作系统。
资料来源：官方资料。本文依据官方信息独立整理与扩展，结合实际使用场景进行说明。
