Skip to content

日常使用与工作模式

OpenCode 多智能体配置提供了三种主控工作模式,并允许直接调度 17 位领域专家智能体。


Code 模式(默认)

@code 是默认入口 —— 直接开发者,自己动手编写、修改、测试和验证代码,不主动委托:

> @code 修复分页逻辑里的差一错误
> @code 给注册表单加上输入校验

仍可按需手动委托辅助类 subagent(@advisor@explorer@code-review@vision)。如果任务实际上是跨领域的,@code 会建议切换到 @build


Build 模式(编排)

跨领域任务切换到 @build — 它会自动将你的任务路由给专家团里合适的成员:

> 添加一个 Spring Boot 用户注册接口,使用 JPA 和 BCrypt
  → @build 调度到 @java-dev

> 审查我最近的提交,关注安全问题
  → @build 调度到 @code-review(敏感时追加 @security)

> 设计一个新支付服务的架构
  → @build 调度到 @architect(先展示多步计划)

你不需要手动指定智能体 — 只需描述任务。对于跨领域任务,@build 会先展示执行计划再开始。


Plan 模式(只读)

切换到 @plan 进行仅分析任务(不修改代码):

> @plan 审计代码库的技术债务和安全漏洞
  → @plan 并行调度 @architect、@security、@code-review、@qa
  → 汇总报告,按优先级给出建议

通过 Tab@code / @build / @plan 在三种模式之间切换。


直接调用专家

你可以跳过编排器,直接调用专家团的成员:

> @dba 优化 orders 表的索引
> @frontend-dev 用设计令牌创建一个可复用的 Button 组件
> @code-review 审查 PR #42

多步工作流示例

对于复杂功能,@build 会创建并执行计划:

## 执行计划

1. [@architect] — 设计事件溯源架构 → ADR + 设计文档
2. [@dba] — 设计事件存储 schema → DDL + 迁移脚本
3. [@java-dev] — 实现生产者和消费者 → 代码 + 测试
4. [@qa] — 编写集成测试 → 测试套件
5. [@security] — 安全审查 → 报告
6. [@code-review] — 代码审查 → 审查报告
7. [@tech-writer] — 编写文档 → README + API 文档

是否继续?

基于 MIT 协议发布。