概述

Subagent是 Comate 主Agent可以将任务委派给的专业化Agent助手。每个Subagent都在自己的上下文窗口中运行，处理特定类型的工作，并将结果返回给主Agent。使用Subagent可以拆解复杂任务、并行开展工作，并在主对话中保留上下文。

特点

• 上下文隔离：每个子代理都有自己的上下文窗口。耗时较长的调研或探索任务不会占用主对话的上下文空间。
• 并行执行：可同时启动多个子代理。可以在代码库的不同部分并行工作，无需等待顺序执行完成。
• 专门领域能力：通过自定义提示词、工具访问权限和模型，为子代理配置特定领域的任务。
• 可复用：定义自定义子代理，并在多个项目之间复用。

自定义Subagent

文件位置

文件格式

每个 subagent 对应一个带有 YAML 头部信息的 Markdown 文件：

1---
2name: security-auditor
3description: 安全专家。用于实现身份验证、支付或处理敏感数据时。
4---
5
6你是一位代码安全审计专家,负责审查代码漏洞。
7
8调用时:
91. 识别安全敏感代码路径
102. 检查常见漏洞(注入、XSS、身份验证绕过)
113. 验证密钥未被硬编码
124. 审查输入验证和清理
13
14按严重程度报告发现:
15- Critical(部署前必须修复)
16- High(尽快修复)
17- Medium(尽可能处理)

配置字段

创建Subagent

Comate提供两种创建Agent的方式：

方式一：基于内置的/create-subagent skill快速创建

点击对话框左下角的加号（+）按钮，展开功能菜单。在弹出的菜单中，找到并点击 Skills。二级列表会展开当前工作区可用的 Skill 清单，点击 create-subagent。

直接在对话框描述subagent，即可完成AI创建。

方式二：基于可视化页面创建

1. 点击 Comate 顶栏右侧的 ··· 菜单，在下拉列表中选择 子智能体，即可进入子智能体管理页面。

2. 点击右上角 + 新建，弹出「创建 Subagent」对话框。可根据使用范围选择对应的类型，个人Subagent仅自己可见和使用，项目Subagent项目内所有成员均可使用。
3. 在输入框中用自然语言描述这个子智能体的角色定位、能力边界和工作方式（上限 999 字）。

4. 点击「AI 创建」，Comate 会自动读取你的描述，自动调用系统/create-subagent skill，生成完整的子智能体配置并完成创建，无需手动配置参数。

推荐使用方式一，更加便捷和高效。

查看Subagent

方式一：直接问Agent让它帮助整理

在输入框输入：当前有哪些生效的Subagents，整理出来

方式二：基于可视化页面查看

点击 Comate 顶栏右侧的 ··· 菜单，在下拉列表中选择 子智能体，即可进入子智能体管理页面，查看已创建的agent。

使用Subagent

自动委派

Agent 会根据以下因素主动委派任务：

• 任务的复杂度和范围
• 项目中自定义的 subagent 描述
• 当前上下文和可用工具

在 description 字段中加入诸如 "use proactively" 或 "always use for" 之类的短语，可以鼓励自动委派。

显式调用

在提示词中使用 /{subagent-name} 语法显式调用指定的子代理：

1> /verifier confirm the auth flow is complete
2> /debugger investigate this error
3> /security-auditor review the payment module

你也可以在对话中自然提及它们来调用子代理：

1> 使用 verifier subagent 来确认身份验证流程已完成
2> Have the debugger subagent investigate this error
3> Run the security-auditor subagent on the payment module

并行执行

Comate也支持同时调用多个Subagent，以获得最大吞吐量，Agent 会在单条消息中发出多个 Subagent工具调用，因此Subagent可以并行运行。

建议使用以下Prompt唤起并行调用，采用此种格式并非Agent能力无法主动识别，而是Agent天然习惯串行执行任务。

1并行分析xxxxx，实现xxxxx