Theme / v5.3.0

Oh My ClaudeCode

Claude Code 多代理編排系統

基礎觀念

OMC 外掛系統與擴充機制

介紹 Oh My Claude Code (OMC) 的插件化(Plugin)架構,探討如何利用 NPM 或 Git 動態擴充 AI 代理的技能

為什麼需要插件化架構?

隨著專案技術棧的多樣化,AI 助手需要應對的場景也越來越多。例如,在工業自動化專案中,AI 需要懂得如何控制 PLC 或進行影像處理;而在雲端原生專案中,它需要懂得 Kubernetes 編排與 AWS 配置。

如果將所有這些特定領域的知識與工具(MCP 伺服器、提示詞模板、自適應修正規則)都強行塞入 OMC 核心包中,會導致核心包極度臃腫,且難以維護。

Oh My Claude Code (OMC) 實作了靈活的 外掛系統 (Plugin Architecture),允許開發者與社群動態下載、安裝與載入第三方「技能外掛」,實現按需擴充。


插件載入與註冊機制

OMC 外掛本質上是一個符合標準 CommonJS/ESM 規範的 NPM 套件,其內部包含了特定的 mcpServers 配置、ADR 模板以及專屬的 Sisyphus 修復規則。

 ┌──────────────────────┐   /plugin install   ┌──────────────────────┐
 │    NPM / Git Repo    ├────────────────────▶│  OMC Local Sandbox   │
 │   (OMC-Plugin-PLC)   │                     │  (.omc/plugins/)     │
 └──────────────────────┘                     └──────────┬───────────┘
                                                         │ 動態掛載與解析

 ┌──────────────────────┐   API 呼叫擴充      ┌──────────────────────┐
 │   Claude Code MCP    │◀────────────────────┤    OMC Runtime       │
 │   New Tools Available│                     │    Orchestrator      │
 └──────────────────────┘                     └──────────────────────┘

外掛安裝生命週期:

  1. 安全沙箱下載 (Sandbox Downloader)
    使用 /plugin install <git-url> 或 NPM 安裝外掛。OMC 會將其下載至隱藏的 .omc/plugins/ 目錄中,並進行程式碼安全審查,防止惡意指令注入。
  2. MCP 工具動態掛載
    OMC 執行期會自動掃描外掛目錄下的 plugin.json,將外掛宣告的外部 MCP 伺服器動態註冊到 Claude Code 的全域設定中。
  3. 注入 Sisyphus 自修復規則
    外掛可以自訂編譯錯誤碼的 regex 與修復策略(例如:針對 C# 的 CS0246 錯誤提供特定的修復提示),使 Sisyphus 引擎具備更強大的特定語言除錯能力。

插件管理實戰指令

在 OMC 終端機中,您可以使用以下指令管理外掛:

  • 列出已安裝外掛
    /plugin list
  • 從 GitHub 安裝特定外掛(如 PLC 控制外掛):
    /plugin install https://github.com/DeusData/omc-plugin-plc
  • 解除安裝外掛
    /plugin remove omc-plugin-plc

外掛化架構使 OMC 能夠保持核心的極度輕量,同時又具備無限的擴展可能,讓 AI 助手能隨時變身為特定領域的專家。