配置
子智能体
主智能体可按需调用的专业专家智能体
子智能体是一种专业的"专家"，主智能体（Worker）可以在任务执行过程中随时调用它。每个子智能体都有自己的专长、专属提示词，甚至可以运行在不同的模型上。在聊天中，只需输入 @SubagentName，它就会加入进来提供帮助——就像在群聊中@一位同事一样。
内置子智能体
Verdent 开箱即带 6 个子智能体，覆盖软件开发中最常见的需求：
| 名称 | 默认模型 | 擅长 |
|---|---|---|
| General | 跟随主智能体 | 通用研究智能体，处理复杂问题、代码搜索和多步骤任务——几乎什么都能帮上忙 |
| Fast Context | Gemini 3 Flash | 快速定位代码、收集上下文证据；专长于代码库索引，速度极快 |
| Verifier | Sonnet 4.6 | 快速代码审查——在你做出修改后，标记它来捕捉明显的问题 |
| Verdent Helper | Haiku 4.5 | Verdent 使用助手；关于 Verdent 如何工作的任何问题都可以问它 |
| Multi-Model Planner | Gemini 3.1 Pro；Opus 4.6；GPT-5.4 | 使用多个模型（Claude、GPT、Gemini）生成计划并合并它们的输出 |
| Reviewer | Gemini 3.1 Pro；Opus 4.6；GPT-5.4 | 完整代码审查：逻辑错误、边界情况、隐藏风险 |
有两个子智能体比较特殊：Multi-Model Planner 和 Reviewer 会并行运行 2–3 个模型。每个模型独立思考，产出各自的输出，然后将结果合并。其他所有子智能体都是单模型。
如何使用子智能体
在任意对话中，输入 @ 即可打开子智能体选择菜单（支持模糊搜索）。选择你想要的子智能体，它就会接管当前上下文。
示例：
- 在编写复杂的认证逻辑后：
@Reviewer please review this→ Reviewer 从安全、逻辑和边界情况等角度进行检查。 - 面对棘手的架构决策：
@Multi-Model Planner→ 多个模型提出方案，你从中选出最佳的。 - 编码完成后，快速运行
@Verifier→ 比运行完整测试套件做基础验证更快。
自定义子智能体
内置子智能体覆盖了大多数需求，但有时你需要一个为你的项目量身定制的专家。你可以创建自己的子智能体。
存储位置
自定义子智能体以 Markdown 文件的形式存储在：
~/.verdent/subagents/支持最多 5 层子目录用于组织管理。
文件格式
每个子智能体都是一个带 YAML frontmatter 的 Markdown 文件：
---
name: SQL-Expert
description: Specializes in SQL optimization and database design, good at analyzing slow queries and indexing strategies
color: blue
model: claude-sonnet-4-6
---
You are a senior database expert focused on PostgreSQL performance optimization.
When users provide SQL queries, you should:
1. Analyze the query execution plan
2. Identify performance bottlenecks (full table scans, missing indexes, etc.)
3. Provide concrete optimization suggestions and rewritten SQL
...关键细节
- 名称： 只能包含字母、数字和连字符（例如
SQL-Expert、MyAgent123）。不能有空格或非 ASCII 字符。 - 颜色： 取以下之一
dark-green、light-green、red-orange、amber、cyan、blue、pink、purple、verdent——便于视觉识别。 - 热重载： 保存
.md文件立即生效——无需重启 Verdent。
在设置中管理子智能体
所有子智能体管理都在 设置 → Subagents 中进行。
| 操作 | 说明 |
|---|---|
| 查看列表 | 所有子智能体以卡片形式展示。内置的标记为"Built-in"；基于插件的会显示插件名称。 |
| 启用 / 禁用 | 单独开启或关闭每个子智能体，互不影响。 |
| 新建 | 点击 Add Subagent，填写 Identifier（唯一名称）、Model、Description 和 Prompt。 |
| 编辑 | 悬停在卡片上即可编辑。内置子智能体只允许修改 Model 和 Description。 |
| 复制 | 复制任意自定义子智能体（副本默认禁用，直到你启用它）。 |
| 删除 | 自定义子智能体可被删除（需确认）。内置的无法删除。 |
模型选择的区别
- Multi-Model Planner 和 Reviewer 支持多模型选择（一次 2–3 个模型）。
- 其他子智能体使用单模型选择。
- General 有一个特殊选项：它可以自动跟随主智能体的模型，免去单独维护配置。
使用场景
代码审查
在实现复杂逻辑后，标记 @Reviewer。它会检查正确性、边界情况和潜在的 bug——省去你手动逐行检查的麻烦。
多视角架构设计
对于重大决策（如是否采用微服务、数据库选型），使用 @Multi-Model Planner 从多个顶级模型获取独立方案，降低决策风险。
快速验证
代码修改后，@Verifier 快速检查语法、类型和基础问题——比完整测试套件更快，比不做检查更可靠。
自定义领域专家
创建为你的项目量身定制的子智能体：
- 熟悉你的 schema 和查询模式的 SQL 优化专家
- 强制执行你的 ESLint 和设计系统规则的前端代码规范守护者
- 将技术内容改写为清晰、易读文字的文档助手
注意事项
- 自定义子智能体必须配置有效的模型才能启用。如果你使用 BYOK，而密钥过期或模型被下线，该子智能体会被自动禁用。
- 内置子智能体的模型可以更改，但默认值都是经过调优的——修改它们可能降低性能。
- Description 很重要： 它会被注入到主智能体的上下文中，影响子智能体何时被调用。更好的描述能带来更智能的路由。
- 子智能体之间不能互相调用。它们只能由主智能体（Worker）调用——不允许更深层的嵌套。