截至2026年9月14日，Qwen Code官方文档提供子Agent创建和管理说明。开发者可用代理管理命令建立专门处理测试、审查或资料调查的角色，并通过项目配置让团队共享。子Agent适合职责明确的小任务。本文从一个普通网站项目出发，说明如何安排角色、选择权限和接收结果，避免仅增加角色数量却让协作更加混乱。
先创建一个只读审查角色
在Qwen Code中使用官方文档列出的创建入口，例如/agents create，按向导描述角色负责什么、何时使用和允许访问哪些工具。第一个角色可以只检查代码，不执行修改。让它返回问题位置、触发条件和建议验证方式。先用小范围任务确认行为符合预期，再逐步加入测试和实现角色，降低配置学习成本。
角色描述要能帮助正确派工
描述不能只写你是资深工程师，而应写检查接口参数与响应是否一致，重点关注分页、空值和权限错误。主Agent依据描述判断何时委派，越具体越容易把工作交给合适角色。实现角色负责改动，审查角色负责找问题，测试角色负责复现和报告；每个角色都要说明哪些工作需要返回主任务决定。
把团队配置放在项目目录
官方文档介绍了项目级.qwen/agents/与用户级配置位置。需要全组一致的角色放进项目，个人习惯留在用户目录。配置文件加入版本管理，变更时写清原因。不同来源存在同名角色时要检查实际优先级，避免自己认为在使用项目规则，实际却被旧配置影响。团队首次接入时可以打印角色列表逐个确认。
并行任务按文件和输出拆分
可以让一个角色调查接口，另一个角色阅读页面状态，再由主Agent决定修改方案。若两个实现角色同时编辑同一文件，冲突处理会增加成本。给每个任务明确目录范围、所需输入和交付格式，较大修改可以使用独立工作目录。主任务负责整合与最终验收，子Agent完成自己的部分并不表示整个功能完成。
模型和工具按任务实际选择
资料分类与简单检查可使用较快模型，复杂代码推理再选择能力更强的模型。工具权限同样按任务配置，审查角色通常不需要部署权限，测试角色也不应默认访问生产数据库。相关字段应参照当前文档填写，先通过向导生成可用配置，再做小幅调整，减少手写参数与版本不一致导致的启动问题。
要求每个角色交付证据
统一输出为任务范围、发现、执行动作、验证结果和剩余问题。引用代码位置时标明实际文件，测试结果写明是否真正执行。主Agent整合后检查接口、状态和页面是否一致，再输出最终完成情况。使用一段时间后统计哪些角色经常被调用、哪些总在重复主任务，把长期没有价值的角色删除，保持配置简单可维护。
参考资料
资料核对日期：2026年9月14日。本文由599IT结合公开资料整理，应用步骤与分析由本站编写。
