第 8 章：Oh My OpenAgent

8.1 什麼是 Oh My OpenAgent？

Oh My OpenAgent（簡稱 OmO，套件名稱 oh-my-opencode）是一個強大的 OpenCode 外掛程式，將原本的單一 AI 代理轉變為多模型多代理協同引擎。

可以這樣理解：如果 OpenCode 原本是一個全能工程師，OmO 就是將他升級為一整間公司的開發團隊 — 有專案經理、架構師、研究員、品管工程師⋯⋯各司其職，協同完成任務。

8.2 安裝指南

OmO 提供兩種安裝方式，你可以根據偏好選擇：

方法 A：AI 輔助安裝（推薦）

在 OpenCode 中直接貼上以下指令，讓 AI 代理幫你完成安裝：

方法 B：手動安裝

在終端機中直接執行以下指令：

# 使用 bun（建議）
bunx oh-my-opencode install

# 或使用 npx
npx oh-my-opencode install

進階：自訂訂閱選項

安裝時可以指定要啟用的 AI 服務：

# 啟用 Claude（最多 20 個 API key）
bunx oh-my-opencode install --claude=max20

# 啟用 Claude + OpenAI
bunx oh-my-opencode install --claude=yes --openai=yes

# 啟用所有支援的服務
bunx oh-my-opencode install --claude=yes --openai=yes --gemini=yes --copilot=yes

驗證安裝

安裝完成後，執行診斷指令確認一切正常：

8.3 設定檔結構

OmO 的設定分散在兩個層級的設定檔中：

設定檔使用 JSONC 格式（支援註解的 JSON），讓設定更具可讀性：

// .opencode/oh-my-openagent.jsonc
{
  // 預設模型設定
  "defaultModel": "gpt-4o",

  // 代理團隊設定
  "agents": {
    "sisyphus": {
      "model": "gpt-4o",
      "temperature": 0.3
    },
    "oracle": {
      "model": "claude-opus-4",
      "temperature": 0.2
    }
  },

  // 分類路由
  "routing": {
    "visual-engineering": ["sisyphus", "hephaestus"],
    "ultrabrain": ["oracle", "metis"],
    "quick": ["explore", "librarian"]
  }
}

8.4 代理團隊（The Agent Team）

OmO 最引人注目的特色就是它的代理團隊。每個代理都有明確的角色定位與專長領域，共同構成一個完整的 AI 開發組織：

代理的「唯讀」與「讀寫」模式

代理團隊中，部分代理（如 Oracle）預設為唯讀模式 — 他們可以閱讀程式碼、分析架構、提出建議，但不會直接修改檔案。這確保了顧問型代理不會意外變更程式碼，而執行型代理（如 Hephaestus）則擁有完整的讀寫權限。這種設計讓每個代理的權責範圍清晰明確。

代理團隊的協作模式

這些代理並非各自為政，而是以Sisyphus 為核心的編排體系。Sisyphus 像一個 Tech Lead，負責接收任務、拆解成子任務、指派給最合適的代理、追蹤進度，最後合併結果。這種「中心化編排、去中心化執行」的模式，既保持了協作的靈活性，也確保了輸出一致性。

團隊協作流程

當你提出一個需求時，OmO 的代理團隊會這樣協作：

8.5 分類路由（Category Routing）

OmO 的另一個核心特性是分類路由 — 根據任務性質自動選擇最合適的代理組合。這確保了每個任務都由最適合的團隊成員處理。

路由通常是自動的，但你也可以手動指定：

# 自動路由（OmO 會根據任務內容判斷）
你：為這個 API 加入完整的錯誤處理

# 手動指定路由
你：使用 ultrabrain 模式分析這個架構設計

# 在 task() 中指定
task(category="visual-engineering", ...)

8.6 內建技能系統

OmO 也整合了 OpenCode 的技能系統，提供一系列開箱即用的專業技能：

這些技能安裝後即可使用，會在對話中根據觸發詞自動載入。

8.7 你的第一個 OmO 指令

安裝完成後，你第一個應該嘗試的指令就是 Ultrawork（縮寫 ulw）：