词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元,支持一个 Key 调用近 600+ 海内外模型,限时特价模型低至 1 折,欢迎上岸!
💡 一句话总结:Agent 就像不同工种的专家,用 Tab 切换主 Agent,用 @agent名调用子 Agent。

确保你已经完成以下事项:
.opencode/plans/*.md 保存方案)| 类型 | 说明 | 调用方式 |
|---|---|---|
| Primary Agent(主代理) | 你直接对话的 Agent(Build、Plan) | Tab 切换 |
| Subagent(子代理) | 被主代理自动调用或你手动调用的专家(Explore、General) | @agent名 任务 |
| Agent | 类型 | 擅长 | 默认权限 |
|---|---|---|---|
| Build | Primary | 全能开发(默认主 Agent) | 全能(可读写文件、执行命令) |
| Plan | Primary | 分析代码、规划方案、审查建议 | 受限(默认禁止编辑,仅 .opencode/plans/*.md 允许写入) |
| Explore | Subagent | 快速找到文件、搜索代码、回答代码库问题 | 只读(可搜索、浏览代码) |
| General | Subagent | 复杂研究、多步骤任务、不确定能否快速找到答案时 | 多任务执行(可用 Todo 工具) |
| Agent | 作用 | 触发时机 |
|---|---|---|
| compaction | 上下文压缩 | 当对话接近模型上下文限制时,自动压缩历史消息 |
| title | 会话标题生成 | 创建新会话后,自动生成描述性标题 |
| summary | 会话摘要生成 | 压缩会话时,生成摘要替代历史消息 |
Build 或 Plan)。@explore 帮我梳理这个项目的整体结构| 深度 | 说明 | 适合场景 |
|---|---|---|
| quick | 基本搜索,快速定位 | "找一下 config 文件在哪" |
| medium | 中等探索,平衡速度和覆盖面 | "帮我梳理项目结构" |
| very thorough | 全面分析,跨多个位置和命名约定进行搜索 | "找出所有安全相关的代码" |
@explore 彻底分析这个项目的认证和鉴权实现,要非常全面<leader>→ 进入子会话,用 <leader>← 返回父会话。(默认 leader 是 Ctrl+X)@general 帮我研究 Node.js 和 Python 的性能对比,并输出总结报告帮我分析这个项目的代码结构,然后添加一个 README.mddescription 决定何时调用。例如 Explore 的描述是"快速找到文件、搜索代码",当任务涉及搜索或探索代码库时就会被调用。<leader>a 列出所有 Agent(默认 leader 是 Ctrl+X,即 Ctrl+X+a)<leader>→ 进入下一个会话(父 → 子1 → 子2 → ... → 父)<leader>← 返回上一个会话(父 ← 子1 ← 子2 ← ... ← 父)<leader>↑ 直接跳转到父会话主会话 (Build)
└── 子会话 (Explore)
└── 孙会话 (General)leader 键默认是 Ctrl+X<leader>→ = Ctrl+X+→(右箭头)<leader>← = Ctrl+X+←(左箭头)<leader>↑ = Ctrl+X+↑(上箭头)全部通过才能继续
@explore 和 @general 调用子 Agent| 现象 | 原因 | 解决 |
|---|---|---|
@agent名 没反应 | Agent 名称拼错了或不是子代理 | 检查拼写,内置子代理有 explore、general。主代理(build、plan)只能用 Tab 切换 |
| 子会话看不到 | 没有展开或导航到错误的层级 | 用 <leader>→ / <leader>← 导航,或者按 <leader>↑ 返回父会话 |
| 想切换到 Explore,但 Tab 找不到 | Tab 只能在主代理(Primary Agent)之间切换 | Explore 是子代理(Subagent),只能用 @explore 调用 |
| 子 Agent 被中断后找不到 | 会话可能已关闭或导航到错误层级 | 按 <leader>↑ 返回父会话,然后用 <leader>→ 查找 |
| Plan Agent 提示"是否允许编辑" | Plan Agent 默认对文件修改和命令执行都设置为 ask | 这是正常行为,Plan 是用于分析的,执行操作前会请求批准 |
| General Agent 没有执行多步任务 | 任务描述不够清晰或任务不够复杂 | 在提示中明确说明需要执行哪些步骤,或确保任务确实需要多步执行 |
@agent名 调用下一课我们将学习项目初始化,用 /init让 AI 更懂你的项目。