任务工具（task）

本文档介绍 Qwen Code 的 task 工具。

描述

使用 task 启动一个专用子智能体，以自主处理复杂、多步骤的任务。任务工具将工作委派给专用智能体；这些智能体可独立运行，并拥有各自的一组工具访问权限，从而支持并行任务执行和专业化能力。

参数

task 接受以下参数：

• description（字符串，必需）：任务的简短描述（3–5 个词），用于用户可见性和任务追踪。
• prompt（字符串，必需）：提供给子智能体执行的详细任务提示。应包含完整、明确的自主执行指令。
• subagent_type（字符串，必需）：用于此任务的专用智能体类型。其值必须与已配置的可用子智能体类型之一完全匹配。

如何在 Qwen Code 中使用 task

任务（Task）工具会根据你的配置动态加载可用的子智能体（subagent），并将任务委派给它们。每个子智能体独立运行，可使用各自专属的一组工具，从而实现专业化能力与并行执行。

当你使用 Task 工具时，子智能体会：

1. 完全自主地接收任务提示（prompt）
2. 利用其可用的工具执行任务
3. 返回最终结果消息
4. 终止运行（子智能体是无状态、单次使用的）

用法：

task(description="简要的任务描述", prompt="提供给子智能体的详细任务指令", subagent_type="agent_name")

可用的子智能体

可用的子智能体取决于您的配置。常见的子智能体类型可能包括：

• 通用型（general-purpose）：适用于需要调用多种工具的复杂多步骤任务
• 代码审查员（code-reviewer）：用于审查和分析代码质量
• 测试执行器（test-runner）：用于运行测试并分析结果
• 文档撰写员（documentation-writer）：用于创建和更新文档

您可在 Qwen Code 中使用 /agents 命令查看当前可用的子智能体。

任务工具功能

实时进度更新

任务工具提供实时更新，显示以下信息：

• 子智能体的执行状态
• 子智能体正在进行的各个工具调用
• 工具调用的结果及任何错误
• 整体任务进度与完成状态

并行执行

您可在单条消息中多次调用任务工具，从而并发启动多个子智能体，实现任务并行执行，提升效率。

专业领域专长

每个子智能体均可配置以下内容：

• 特定工具的访问权限
• 专用的系统提示词与指令
• 自定义模型配置
• 领域专属的知识与能力

task 示例

委派任务给通用型智能体

task(
  description="代码重构",
  prompt="请将 src/auth/ 目录下的认证模块重构为使用现代 async/await 模式，替代原有的回调方式。确保所有测试仍能通过，并更新相关文档。",
  subagent_type="general-purpose"
)

并行执行多个任务

# 并行启动代码审查与测试执行
task(
  description="代码审查",
  prompt="审查用户管理模块的近期变更，评估代码质量、安全问题及是否符合最佳实践。",
  subagent_type="code-reviewer"
)

task(
  description="运行测试",
  prompt="执行完整的测试套件并分析任何失败项。提供测试覆盖率摘要及改进建议。",
  subagent_type="test-runner"
)

文档生成

task(
  description="更新文档",
  prompt="为订单模块中新实现的 REST 端点生成全面的 API 文档，包括请求/响应示例和错误码。",
  subagent_type="documentation-writer"
)

何时使用任务工具

在以下情况下使用任务工具：

1. 复杂的多步骤任务 —— 需要多个操作、且可自主完成的任务
2. 需要专业专长的任务 —— 可从领域特定知识或工具中获益的任务
3. 并行执行场景 —— 存在多个相互独立、可同时运行的任务
4. 需要委托的场景 —— 希望将完整任务整体交由他人/系统处理，而非逐个步骤微观管理
5. 资源密集型操作 —— 可能耗费大量时间或计算资源的任务

何时不使用任务工具

请勿在以下情况中使用任务工具：

• 简单、单步操作 —— 请直接使用 Read、Edit 等基础工具
• 交互式任务 —— 需要反复来回沟通的任务
• 特定文件读取 —— 为获得更优性能，请直接使用 Read 工具
• 简单搜索 —— 请直接使用 Grep 或 Glob 工具

重要注意事项

• 无状态执行：每次子智能体调用相互独立，不保留此前执行的记忆
• 单次通信：子智能体仅返回一条最终结果消息，不支持持续交互
• 完整提示词：你的提示词应包含所有必要上下文和指令，确保子智能体可自主执行
• 工具访问权限：子智能体仅能使用其专属配置中明确启用的工具
• 并行能力：多个子智能体可同时运行，以提升执行效率
• 依赖配置：可用的子智能体类型取决于你的系统配置

配置

子智能体通过 Qwen Code 的智能体配置系统进行配置。使用 /agents 命令可：

• 查看当前可用的子智能体
• 创建新的子智能体配置
• 修改现有子智能体的设置
• 配置工具权限与能力

有关子智能体配置的更多信息，请参阅子智能体文档。