Theme / v5.3.0

Oh My ClaudeCode

Claude Code 多代理編排系統

指令詳解

omc team 指令詳解

如何使用 omc team 命令啟動多代理並行協同,在 tmux 隔離工作區中高效重構

指令用途

在大規模重構任務中,如果只有單一的 AI 執行緒,重構週期會非常漫長。例如,你修改了底層的 API 簽章,導致 3 個獨立的子專案同時報錯。如果逐一修改,效率極低。

omc team 是 OMC 中的 多執行緒工作區編排指令。它利用本地的 tmux 或者是 psmux,在背景自動建立多個隔離的 Git Worktree 工作樹,並為每個工作樹指派一個專屬的 Sisyphus 代理,實現在多個工作樹中並行修復編譯錯誤,最後一鍵合併。


運作流程

  1. 工作區劃分:接收 --workers 參數,自動為每個 Worker 建立一個獨立的 git worktree
  2. tmux 會話綁定:在本地啟動 tmux,將各個 Worker 綁定到 tmux 的不同 Pane 或 Window 中。
  3. 並行任務分派:Master 代理將任務拆分,發送指令給各個 Worker 背景執行。
  4. 衝突安全鎖定:透過 git worktree 隔離各 Worker 的工作目錄,並在 omc team merge 時自動偵測與解決衝突。
  5. 合併清理:完成後執行 omc team mergeomc team cleanup

實戰對話範例

範例:啟動兩個並行 Worker 重構核心模組

  • You:
    /opsx:explore "請幫我用 omc team 分配兩個背景 Worker,分別修改 src/Billing 和 src/Admin。"
  • AI:

    好的,我將調用 omc team 初始化命令,在本地 tmux 中啟動兩個背景 Workers,並將它們與獨立的 git worktree 綁定。

    OMC 呼叫: omc team init --workers=2 --names=billing,admin
    OMC 回傳:

    [OMC] Spawning worker: billing -> worktree at temp/wt-billing
    [OMC] Spawning worker: admin -> worktree at temp/wt-admin
    [OMC] Tmux session 'omc-team' created with 2 panes.

    分析
    兩個背景工作樹已成功初始化完畢!

    1. Pane 1:Worker billing 專注於 /src/Billing/ 目錄。
    2. Pane 2:Worker admin 專注於 /src/Admin/ 目錄。

    現在我可以在這兩個 Pane 中並行啟動 Sisyphus 自主修復引擎了。您需要我發送啟動命令嗎?