Skip to content

建立 2026-09-15 更新 2026-09-15

Agents

Agent 是配了提示詞、模型與權限的專責助手。Primary agent 是你用 Tab 切換的主對話角色；subagent 由主 agent 呼叫，或你用 @名稱 手動叫來。

內建角色

名稱 類型 做什麼
Build primary 預設開發角色，工具較完整
Plan primary 規劃與分析；改檔、bash 預設需詢問
General subagent 複雜研究或多步驟，可改檔
Explore subagent 唯讀、快速搜 repo
Scout subagent 唯讀，查外部文件或依賴原始碼

另外還有 compaction、title、summary 等系統用 agent，UI 裡選不到。

Subagent 會開 child session。預設 Down 進入第一個子 session，Left／Right 循環，Up 回到父層。

怎麼自訂

互動式建立：

opencode agent create

會問存放位置（全域或專案）、職責、權限，並寫出 markdown。專案 agent 放 .opencode/agents/，全域放 ~/.config/opencode/agents/。檔名就是名稱，例如 review.md → @review。

---
description: 檢查安全性與可維護性，不直接改檔
mode: subagent
permission:
  edit: deny
  bash: deny
---

你是 code reviewer。只指出問題與建議，不要送 patch。

也可以在 opencode.json 的 agent 覆寫 built-in，例如讓 Plan 用較快的模型、Build 用較強的模型。mode 可為 primary、subagent 或 all。

權限鍵包含 edit、bash、skill、task（能叫哪些 subagent）等，值為 allow／ask／deny，也可用 glob。完整表見 官方 Agents。

使用建議

  • 大功能：Plan 出計畫 → Build 實作 → @review 或自訂 reviewer 看 diff
  • 陌生代碼：先 @explore 或自己 @ 檔案，不要一開始就 Build
  • 控制成本：agent 可設 steps，限制工具迴圈次數

相關資料