oh-my-openagent 怎麼用？51k Star AI 多代理框架完整教學，ultrawork 一鍵啟動（2026最新）

你是否曾經想過，如果 AI 能像一支真正的開發團隊分工合作，效率會提升多少？oh-my-openagent（簡稱 omo）就是專為解決這個問題而生的工具——它讓多個 AI 代理同步協作，自動完成複雜的程式開發任務，目前在 GitHub 上已累積超過 51,000 顆星。

什麼是 oh-my-openagent（omo）？

oh-my-openagent 是一套「AI 代理指揮框架（agent harness）」，原名 oh-my-opencode，是目前最熱門的開源 AI 多代理系統之一。它的核心概念是：把不同 AI 模型指派給不同角色，像真實開發團隊一樣平行工作，而不是讓一個 AI 獨自完成所有事。

omo 的設計解決了「The Harness Problem」——傳統 AI 代理在處理多步驟任務時，因為行號偏移或上下文丟失導致錯誤率極高（約 93.3%）。omo 引入了「哈希錨定編輯（Hash-Anchored Edits）」技術，讓每一行程式碼都帶有內容哈希值，成功率從 6.7% 提升到 68.3%。

oh-my-openagent 架構示意圖
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  使用者輸入 ultrawork
        ↓
  Sisyphus（主指揮官）
  ┌─────┼─────────┐
  ↓     ↓         ↓
Prometheus  Hephaestus  其他代理
（策略規劃）  （深度執行）  （品質控管）
  ↓     ↓         ↓
  └─────┴─────────┘
        ↓
   任務完成 ✅
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

oh-my-openagent 有哪些功能？

omo 的功能遠超一般 AI 助手，以下是它的五大核心能力：

• 多代理平行執行：Sisyphus（主指揮）、Hephaestus（深度工作者）、Prometheus（策略規劃師）等角色同步進行，不需要等待一個代理完成才進行下一步。
• 智慧模型路由：根據任務類型自動選擇最適合的 AI 模型。規劃任務用 Claude Opus、快速任務用輕量模型、創意任務用 Gemini，不浪費昂貴的 API 額度。
• 哈希錨定編輯（Hash-Anchored Edits）：每行程式碼都帶有唯一 ID，避免 AI 編輯時找錯行，大幅降低錯誤率。
• 技能嵌入 MCP（Skill-Embedded MCPs）：Model Context Protocol 伺服器按需啟動，避免上下文視窗過載，讓代理能隨時取用工具而不浪費 token。
• 完全相容 Claude Code：你現有的 hooks、指令、MCP 設定全部保留，不需要重新設定。

oh-my-openagent 怎麼用？步驟教學

omo 的安裝與使用方式設計得非常直覺——你只需要告訴你的 AI 代理去安裝它，它就會自己完成。以下是完整步驟：

Step 1：準備環境

確認你已經安裝 Node.js 18+ 和 Claude Code CLI。用滑鼠開啟終端機（Terminal），輸入以下指令確認版本：

node --version   # 應顯示 v18.0.0 以上
claude --version  # 應顯示 Claude Code 已安裝

→ 預期畫面：終端機顯示版本號碼，無錯誤訊息。

⚠️ 錯誤：command not found: claude → 請先到 Claude Code 官網安裝 CLI，再繼續。

Step 2：讓 AI 代理自動安裝 omo

這是 omo 的獨特安裝方式——你不用自己跑指令，只要把以下提示詞複製貼給你的 AI 代理（Claude Code 或任何支援的代理系統）：

Install and configure oh-my-opencode by following instructions at:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

→ 預期畫面：AI 代理開始讀取安裝文件，自動執行 npm install 和設定步驟，最後回覆「Installation complete」或類似成功訊息。

⚠️ 錯誤：npm ERR! 404 → 確認網路正常，或手動執行：npm install -g oh-my-opencode

Step 3：啟動 ultrawork 模式

安裝完成後，在你的專案資料夾內，對 Claude Code 或 omo 指定的代理輸入：

ultrawork

或使用縮寫：

ulw

→ 預期畫面：系統自動啟動 Sisyphus 主指揮官，開始分配任務給各個代理，你會看到多個代理同時運作的日誌輸出。

Step 4：進階指令（可選）

omo 還提供幾個進階指令，依照你的需求選用：

• /start-work：啟動 Prometheus 進行策略性訪談規劃，適合複雜的新專案
• /init-deep：自動生成階層式 AGENTS.md 上下文檔案，讓代理更了解你的專案結構
• /ulw-loop：啟動持續精煉迴圈（Ralph Loop），讓代理反覆優化直到滿意

指令速查表
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
指令            說明
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ultrawork/ulw   啟動全代理模式
/start-work     策略規劃訪談
/init-deep      生成 AGENTS.md
/ulw-loop       持續精煉迴圈
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

使用注意事項

• API 費用：omo 會同時呼叫多個 AI 模型，若使用付費 API（Claude、GPT 等），請先確認自己的 API 額度與預算。建議先在小型專案測試。
• 網路需求：多代理平行執行需要穩定的網路連線，頻繁斷線可能導致任務中斷。
• 目前狀態：截至 2026 年 4 月，oh-my-openagent 仍在積極開發中（dev 分支），功能更新頻繁，建議定期更新套件版本。
• 相容性：主要支援 Claude Code 環境，其他 AI 代理系統的相容程度依版本而異，建議查閱官方 GitHub 最新文件。

結論

oh-my-openagent（omo）代表了 AI 代理開發的一個重要方向：從「一個 AI 做所有事」進化到「多個 AI 分工協作」。51k 顆星的成績說明了開發者社群對這套框架的高度認可。如果你是 Claude Code 用戶，omo 幾乎是零成本升級——現有設定完全保留，只需多輸入一個 ultrawork 指令，就能讓 AI 開發效率大幅躍升。

想深入了解更多 AI 代理工具的實際應用，歡迎繼續瀏覽以下延伸閱讀。