Oh My OpenAgent 是什麼？
Oh My OpenAgent (OMO) 是一個為 OpenCode 與 Codex CLI 打造的多代理編排系統。它把單一 AI 助手拆成 11 個角色分工的專業代理，並提供 Team Mode、Hash-Anchored Edit、ultrawork 等機制，讓代理能夠在同一個專案裡平行工作而不互相打架。
如果你曾經遇過「單一 AI 助手既要分析架構、又要寫程式、又要補測試，結果每件事都做不好」的狀況，OMO 就是為了解決這個認知負載問題而生的。
功能導覽：能力對應痛點
下表把 OMO 的核心能力對應到實際解決的痛點，以及你會用到的代理或指令。新手看完這張表，就能知道「我這個問題該找誰」。
| OMO 能力 | 對應代理 / 指令 | 解決的痛點 |
|---|---|---|
| 11 個專業代理 | Sisyphus（實作）、Hephaestus（運維）、Prometheus（架構）、Hermes（接口）、Athena（測試）等 | 單一 AI 角色混亂、認知負載過重 |
| Team Mode（最多 8 個平行成員） | 於 explore/apply 階段宣告多代理分工 | 序列式開發太慢，開發與測試無法並行 |
| Hash-Anchored Edit Tool | 自動啟用於共用檔案 | AI 修改程式碼時的行號偏移與多代理寫入衝突 |
| ultrawork 一鍵啟動 | ultrawork |
不想逐一召喚每個代理 |
| Ralph Loop | 自我參考迴圈 | 長任務需要代理自驅直到收斂 |
| 54+ 生命週期鉤子 | 自訂 hook | 想在流程特定節點插入自動化檢查 |
| 5 個內建 MCP | Exa、Context7、Grep.app 等 | 工具整合分散，希望一次到位 |
| LSP 整合 | IDE 級別符號解析 | AI 對 symbol 的理解不夠精確 |
| AST-Grep（25 種語言） | 結構化搜尋 | 文字 grep 抓不到語法結構 |
新手最常用的三個能力：Team Mode、Hash-Anchored Edit、11 個專業代理。其他功能都可以等任務規模變大再學。
安裝：三分鐘搞定
OMO 支援兩個平台，任選一個指令即可：
# OpenCode (Ultimate Edition)
bunx oh-my-openagent install
# Codex CLI (Light Edition)
npx lazycodex-ai install
# 同時安裝到兩個平台
bunx oh-my-openagent install --platform=both安裝完成後，OMO 會自動掛載 11 個代理、5 個內建 MCP，並把命令註冊進你的 CLI shell。
快速上手：第一個 Team Mode 任務
底下是最小可運作的 Team Mode 流程。用一個小工具函式當例子，体驗「實作代理 + 測試代理」並行的感覺。
步驟 1：用 explore 描述需求
/opsx:explore "我需要新增 formatPrice(cents, currency) 工具函式，並配齊單元測試。"OMO 會回報它規劃的代理分工，通常會是 Sisyphus 實作、Athena 寫測試。
步驟 2：啟動 Team Mode
於 /opsx:apply 階段告訴 OMO「以 Sisyphus 實作、Athena 寫測試，兩個 worker 平行」，OMO 就會啟動 Team Mode。
OMO 會在背景配置好 Git Worktree、隔離兩個 worker 的 context，並自動為共用檔案啟用 Hash-Anchored Edit。
步驟 3：邊喝咖啡邊觀察
兩個 worker 會各自推進，遇到共用檔案時 Hash-Anchored Edit 會自動排隊，不會互相覆蓋。
步驟 4：合併與測試
pnpm testTeam Mode 合併會自動收尾，因為全程使用區塊雜湊鎖，合併通常是零衝突。測試通過就收工。
完整的對話紀錄與細節，參見 實戰範例 009：第一次啟動 Team Mode。
五個專業代理的快速記憶
雖然 OMO 內建 11 個代理，但新手把這五個名字記起來就夠用八成場景：
| 代理 | 角色一句話 |
|---|---|
| Sisyphus | 寫程式、編譯、自動除錯的「碼農」。 |
| Athena | 寫測試、把關驗收的「測試官」。 |
| Prometheus | 做架構影響分析、安全審查的「架構師」。 |
| Hermes | 設計 API、資料庫遷移的「接口官」。 |
| Hephaestus | 負責環境配置、Dockerfile、部署的「運維」。 |
完整 11 個代理與 Team Mode 的協同細節，參見 11 個專業代理人與 Team Mode 協同。
接下來去哪裡
- 想理解為什麼多代理不會打架：讀 雜湊錨定編輯協定。
- 團隊裡同時有人用 OpenCode 與 Codex CLI：讀 跨平台多通道代理協調管理。
- 想直接看完整實戰對話：從 實戰範例 009 開始，再依難度往後挑戰。