子智能体

子智能体是给 Agent 准备的专门角色。你可以把 code review、测试排查、发版说明、UI 检查这类固定职责做成子智能体，让当前 Agent 在需要时调用更聚焦的角色处理任务。

ZCode 会按来源读取子智能体配置，当前支持 ZCode Agent、Claude CLI、Codex CLI、Gemini CLI 和 OpenCode CLI。建议优先为 ZCode Agent 配置团队常用角色，再按需要给其他 CLI 框架补充对应角色。

按来源管理

进入 设置 -> 子智能体 后，可以通过来源筛选查看不同框架下的子智能体。每一行会展示名称、作用范围、描述，以及编辑和删除入口。

常用来源说明：

• ZCode Agent：ZCode 自研 Agent 的子智能体，适合沉淀团队默认工作角色。
• Claude CLI：读取 Claude CLI 的 agents 配置。
• Codex CLI：读取 Codex CLI 的 agents 配置。
• Gemini CLI：读取通用 .agents/agents 配置。
• OpenCode CLI：读取 OpenCode 专属配置，也兼容通用 .agents/agents。

新建子智能体

先切到目标来源，再点击右上角 新建。填写名称、描述和系统提示词，保存后返回列表。

字段建议：

• 名称：用英文小写、数字和连字符，例如 zcode-reviewer。
• 描述：写清楚什么时候应该调用它。
• 系统提示词：定义这个子智能体的职责、检查重点和输出方式。

创建后点击 刷新，确认它出现在当前来源下。需要调整时，使用列表右侧的编辑按钮；不再使用时，可以删除。

各框架示例

下面是几个来源的列表效果。你可以按照同样方式，为每个框架准备三到五个常用角色。

在聊天中使用

在聊天输入框中输入 @ 或通过 Agent 的任务编排触发子智能体时，ZCode 会读取当前框架已启用的子智能体。适合拆给子智能体的任务通常有明确职责，例如：

让 zcode-reviewer 检查当前改动有没有回归风险

让 codex-bug-hunter 帮我定位这个测试为什么失败

子智能体适合处理一个明确角色下的工作；如果只是保存一句快捷提示词，用 Command 更轻；如果是可复用的方法论和素材包，用 Skill 更合适。

下一步