1. 專案總覽
Multica 是一個開源、可自架的工作區平台,能將 AI 程式開發代理(Claude Code、Codex、Cursor、GitHub Copilot 等)變成第一級隊友——你可以像把議題指派給同事一樣把它指派給代理,代理就會自行接手工作、撰寫程式碼、回報阻礙並更新狀態。
2. 背景與定位
採用多個 AI 程式開發代理的團隊很快就會遇到協調問題:每個代理各自活在自己的終端機或工具裡,工作階段在每次執行之間遺失脈絡,也沒有共享紀錄說明代理做了什麼、為什麼做、改了什麼。Multica 正是為了解決這個問題而打造,讓代理在團隊看板上擁有真正的席位——它們的意圖、執行紀錄與程式碼變更都附著在人類同樣使用的議題上,而不是散落在彼此不相連的命令列工作階段中。
大多數「AI 程式開發助理」工具聚焦於單一編輯器內的單一代理,Multica 則與代理無關且以團隊為導向:它同時支援 26 種以上的代理命令列工具,讓你能把代理與人類編組成 Squads,並將代理的工作視為可稽核、可審查的專案活動,而非不透明的背景程序。它完全開源,可透過 Docker Compose 或 Helm 端到端自架,避免被任何單一託管代理供應商綁定。
3. 功能分類
🤖 代理管理 — 5 項以上代表性能力
從 26 種支援的命令列工具(Claude Code、Codex、Cursor、GitHub Copilot、Gemini、Kimi、OpenCode、Hermes 等)設定並執行代理,每個代理都能自訂名稱、供應商與執行環境。目的:讓團隊無論偏好哪種底層代理工具,都能以 Multica 作為標準控制平面。
👥 Squads 與委派 — 分組與路由功能
將多個代理(與人類)編組成由路由代理帶領的 Squad,由它把進來的分派到整個群組,而不是讓單一代理超載。目的:規模化代理工作的委派,無需手動指揮流量。
⚙️ 自動化(Autopilots) — 排程/事件驅動的執行
Autopilots 會依 cron 排程或外部 webhook 事件觸發代理執行——例如每日站立會議、週期性稽核或自動化報告——也可選擇手動觸發。目的:讓代理主動進行週期性工作,而不只是被動回應被指派的議題。
🧩 技能系統 — 可重複使用的能力套件
技能是以 markdown 為基礎的能力組合,描述某類工作如何完成;它們可附加到多個代理,並注入每個相關任務。目的:讓已解決的問題與工作流程在整個代理團隊中累積,而不是每次重新解決。
🔍 可視性與控制 — 執行紀錄、權杖追蹤、審查關卡
每次代理執行都會產生附時間戳的執行紀錄,包含工具呼叫與錯誤,並追蹤每個代理與議題的權杖用量,還可要求程式碼合併前必須經過人工審查關卡核准,並具備重試與逾時處理。目的:讓代理活動可稽核,且能安全合併到正式環境的程式碼庫中。
🔗 整合 — Git 主機與聊天平台
原生支援 GitHub、GitLab、Gitea 與 Forgejo 作為 Git 主機,並支援 Slack、Lark、DingTalk、WeCom 與 Telegram 進行聊天式互動。目的:融入團隊已在使用的工具,而不必另建新的工作流程孤島。
4. 主要亮點
- 設計上與代理無關 — 支援 26 種不同的代理命令列工具,團隊不會被單一供應商的程式開發代理綁死。
- 以 Squads 規模化委派 — 路由領導者會把工作分散到一群代理與人類,讓委派在團隊成長時仍保持穩定。
- 議題驅動的自主性 — 只要指派議題,就足以觸發代理開始工作、回報阻礙並更新狀態,無需人工盯場。
- 完整自架 — 可透過 Docker Compose 或 Kubernetes 上的 Helm chart 部署,並以 PostgreSQL 作為後端儲存,讓團隊完全掌控自己的資料與基礎設施。
- 可累積的技能 — 附加到代理、以 markdown 定義的可重複使用技能,意味著已解決的問題不必在每個任務上重新解決。
- 跨平台觸及 — 網頁、桌面應用程式(透過 Electron 支援 macOS/Windows/Linux)與行動裝置(iOS)共用同一套核心 UI 套件,因此無論團隊在哪裡工作,都能看見代理活動。
5. 依角色劃分的使用情境
- 一般開發者 — 將例行或範圍明確的議題(錯誤修正、小型功能、重構)指派給代理,並審查產生的拉取請求,而不必自己切換脈絡去做。
- DevOps/SRE — 透過 Docker Compose 或 Helm chart 自架 Multica,在已安裝代理命令列工具的任何機器上設定執行環境,並使用 Autopilots 處理週期性維護任務,例如排程稽核或報告。
- 專案經理 — 在同一個看板上並列追蹤代理與人類的工作,利用執行紀錄與權杖用量追蹤來了解成本與進度,並以人工審查作為合併前的關卡。
- 安全工程師 — 使用審查關卡要求代理撰寫的程式碼在合併前必須經人工核准,並依賴執行紀錄稽核代理究竟呼叫了哪些工具、改了什麼。
6. 開始使用
找到你需要的內容: 瀏覽 multica.ai/docs 上的文件,從「核心概念」與「完整教學」頁面開始,了解代理、技能、autopilots 與 squads。
安裝/整合:
# Quick self-hosted install (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash -s -- --with-server
multica setup self-host
# Or clone and run via Docker Compose
git clone https://github.com/multica-ai/multica.git
cd multica
make selfhost
貢獻: 分叉儲存庫,閱讀儲存庫中的貢獻指南,並對 github.com/multica-ai/multica 提出拉取請求。
7. 專案結構
multica/
├── apps/ # Next.js web app, Electron desktop wrapper, Expo/React Native iOS app
├── packages/ # Shared UI and logic packages used across web/desktop/mobile
├── server/ # Go backend: Chi router, sqlc, WebSocket support
├── docker/ # Docker Compose files for self-hosting
├── deploy/helm/ # Helm chart for Kubernetes deployment
└── scripts/ # Install scripts (install.sh / install.ps1)
重要目錄:server/ 包含 Go 後端,負責管理代理協調、議題路由,以及串流執行紀錄的 WebSocket 層;apps/ 存放平台的三個用戶端介面(網頁、桌面、行動),共用通用套件,讓代理活動在各處看起來一致;deploy/helm/ 與 docker/ 是正式環境自架支援的兩條路徑。
8. 相關生態系
Multica 是與現有開發者工具整合,而非取代它們:
- 它所協調的代理命令列工具:Claude Code、Codex、Cursor Agent、GitHub Copilot CLI、Gemini CLI、Kimi、OpenCode、Hermes 等。
- Git 代管平台:GitHub、GitLab、Gitea、Forgejo。
- 聊天平台:Slack、Lark、DingTalk、WeCom、Telegram——用於通知與與代理進行對話式互動。
- 基礎設施相依項目:PostgreSQL(含 pgvector)作為資料庫,Docker/Docker Compose 或 Kubernetes+Helm 作為部署方式。
- 搭配工具:
multica-ai/multica-cli,一款讓代理操作 Multica 本身的命令列工具。
9. 授權
Multica 以修改過的 Apache License 2.0 發布(Apache 2.0 基本條款加上專案定義的額外條件)。
- ✅ 可免費自架 Multica 供團隊/組織內部使用。
- ✅ 可公開再散布原始碼,前提是兩部分授權(額外條件與 Apache 2.0 條文)必須一併附上。
- ✅ 可在 Multica 的後端、常駐程式或命令列工具上打造無介面的產品,只要保留署名聲明,並在文件中說明該產品建構於 Multica 之上並附上儲存庫連結。
- ❌ 未取得專案的商業授權,不得使用 Multica 的原始碼向第三方提供託管服務(無論收費或免費)。
- ❌ 未取得書面豁免,不得移除或修改衍生自網頁、桌面、行動或共用 UI 套件的介面中的 Multica 標誌、產品名稱或著作權/署名聲明。
- ℹ️ 僅有 Apache 2.0 條款並不滿足此授權——額外條件與 Apache 2.0 必須一併交付,且若有衝突,以額外條件為準。
- ℹ️ 貢獻程式碼即表示貢獻者同意專案維護者可修改授權條款,並將貢獻用於商業用途。
10. 常見問題
問:我必須使用 Multica Cloud,還是可以全部自架?
答:Multica 可透過 Docker Compose 或 Helm chart 完整自架——請參閱 SELF_HOSTING.md。若你不想自己執行基礎設施,Multica Cloud(multica.ai)可作為受管理的替代方案。
問:Multica 支援哪些 AI 程式開發代理?
答:支援 26 種代理命令列工具,包括 Claude Code、Codex、Cursor Agent、GitHub Copilot CLI、Gemini CLI、Kimi、OpenCode 與 Hermes。任何已安裝支援的命令列工具的機器都可註冊為「執行環境」。
問:我要如何避免代理撰寫的程式碼在無人監督下被合併?
答:在相關議題或 Squad 上設定審查關卡——這會要求代理的變更必須經人工明確核准才能合併,此外還具備執行失敗時標準的重試/逾時處理。
問:技能與 Autopilot 有何不同?
答:技能是附加到代理並注入相關任務、以 markdown 定義的可重複使用能力(「如何做」);Autopilot 則是由 cron 或 webhook 觸發、無需手動指派即可執行代理的自動化機制(「何時做」)。請參閱 multica.ai/docs/concepts。
問:我可以為我的客戶執行以 Multica 為基礎的託管服務嗎?
答:依預設授權不行——將 Multica 作為託管服務提供給第三方,需要向專案取得商業授權。組織內部使用與為自己團隊自架則不受限制。
11. 快速連結
- 儲存庫:github.com/multica-ai/multica
- 文件:multica.ai/docs
- 自架指南:SELF_HOSTING.md
- 版本發布:github.com/multica-ai/multica/releases
- 議題/社群討論:github.com/multica-ai/multica/issues
12. 總結
Multica 為工程團隊提供一個單一、可自架的看板,讓人類與 AI 程式開發代理如同真正的隊友般工作——議題被指派、代理以完全可稽核的方式自主執行,而可重複使用的技能讓已解決的工作隨時間累積。它最適合已在使用一個或多個 AI 程式開發代理、需要共享可視性、審查關卡與規模化委派,而非各自獨立的開發者命令列工作階段的團隊。