opencode中@general，@explore，/plan，/build的区别

 

OpenCode 全部角色 + 命令 终极梳理（人话版，无玄学、好记）

先记住一句大前提：

 

这几个没有严格权限锁死，谁都能写代码、谁都能删文件；只是「默认分工不一样」，不是不能跨界干活。

一、两类东西先分开

1. @开头 = 角色（Agent 人格）
    
   换个 AI 身份跟你对话、做事
3. / 开头 = 工作模式
   开启「只规划」或「直接动手干活」的模式

---

二、4 个核心逐个讲透

1. @general（通用助手）

• 定位：万能打杂程序员
• 擅长：写代码片段、解答问题、改小逻辑、聊天问答
• 特点：一问一答，不主动大规模建项目、不主动跑全流程
• 能干啥：你让删文件也能删，只是默认不爱搞大动作

2. @explore（项目探索）

• 定位：项目讲解员、看工地的
• 擅长：梳理项目结构、读已有代码、解释现有逻辑、分析目录
• 特点：主打看懂已经存在的项目
• 误区：不是 /plan，它只复盘现状，不设计新功能步骤

3. /plan（规划模式）

• 定位：只动脑不动手的策划
• 擅长：拆新需求、列开发步骤、做方案、分流程
• 特点：主打设计还没做的事
• 区别：
  • @explore：看旧的、已有的
  • /plan：想新的、要做的

4. /build（构建执行模式）

• 定位：全能施工包工头
• 擅长：自动建文件、写全套代码、改项目、删文件、跑全流程
• 特点：默认就是直接动手改项目、真实操作文件

---

三、Tab 弹出来的又是啥？

Tab 切换列表：

 

build native、plan native、你自己的自定义 Agent（java-test-architect…）

• build native = /plan 背后对应的原生 Agent
• plan native = /build 背后对应的原生 Agent
• 你自己的 Agent：你创建的自定义人格，按你的规则干活

对应关系

• 输 /plan = 快速调用 plan native
• 输 /build = 快速调用 build native

---

四、你最绕的点：Tab 切 build + @自己的 Agent

1. Tab 切到 build

    

   = 开启「允许真实改文件、删文件、新建文件」的干活模式
2. 再发 @java-test-architect 指令

    

   = 不用系统自带的 build native，改用你自己的 Agent 人格来执行

 

合起来意思：

 

用我的自定义 Agent，在 build 可动手的模式下，帮我干活、改文件、删文件

---

五、日常最简单使用规则（直接照抄用）

1. 问问题、写小段代码 → 直接发消息（默认 @general）
2. 看不懂项目、梳理结构 → @explore
3. 只想要方案步骤、不写代码 → /plan
4. 直接全自动做功能、改文件删文件 → /build
5. 按自己的流程 / 规矩全自动干活 → Tab 切 build + @你的自定义 Agent

---

六、一句话极简口诀

• @general：问答写小段代码
• @explore：看已有项目结构
• /plan：规划要做的步骤
• /build：直接动手干活改文件
• Tab 列表：都是真实 Agent，/ 只是快捷调用
• build+@自己 Agent：用我的规矩，真实动手干活

就这么多，不用再抠复杂定义，按这个日常用完全够。