创建与使用 Subagents

常规 subagent 使用独立对话历史和任务提示处理专门工作。它适合让一个明确角色完成范围有限的任务，再把结果交回主会话。需要继承已有对话时，使用Fork。

创建一个角色

/agents create
/agents manage

前者启动创建向导，后者管理已有定义。文件按以下位置存放，项目优先于个人，个人优先于扩展：

扩展 agent 会出现在管理对话框的 Extension Agents 区域；修改其定义应改扩展来源，不能直接在该管理入口编辑。

最小定义

例如保存 .qwen/agents/test-reviewer.md：

---
name: test-reviewer
description: Review changed tests for missing edge cases and unreliable assertions.
model: inherit
tools:
  - read_file
  - grep_search
  - glob
---

Read the implementation and changed tests.
Report concrete missing cases with file evidence and expected behavior.

YAML 定义身份、模型与工具，正文是角色提示。描述应写清何时调用；正文说明检查顺序和可验证的输出。不要给一个角色同时塞入测试、部署、设计等无关职责。

可以自然语言要求主模型把测试审查交给 test-reviewer，也可以让模型依据描述自行选择。模型选择不是每次必然触发，任务描述应明确所需范围与结果。

等待还是后台运行

顶层常规 subagent 默认后台运行，完成时通知主会话。需要当前轮直接等待并获取结果，可在 Agent 调用使用 run_in_background: false。省略 subagent_type 启动通用 subagent，不是 fork。

嵌套常规 agent 默认前台；显式要求后台会被拒绝，因为它不能接收对应完成通知。外部执行器的默认和限制不同，见Claude Code 与 Codex。

配置拆分阅读

• 模型选择：继承、fast、跨提供商和模型等级。
• 权限与工具：父会话模式、工具白名单与延迟工具。
• 兼容字段：Claude Code frontmatter、回合上限、MCP 与 Hooks。
• 后台续接：任务标识、恢复、通知和工作目录。

描述超过 1,000 字符、系统提示超过 10,000 字符会触发软警告，这两项不是硬性长度上限。保留角色边界与具体输出标准比堆积提示更有用。