Multica 教學手冊
Multica 教學手冊(企業級實戰版) 版本: v0.3.33(2026-06-30) 適用對象: 資深工程師、架構師、DevOps 工程師、技術主管 技術棧: Go Backend + Next.js 16 Frontend + PostgreSQL 17 + pgvector + Redis(選用)+ Agent Daemon 授權: Multica Source Available License(非 SaaS/轉售可自由使用) 文件等級: 企業標準技術白皮書 目錄 第 1 章:Multica 概述 1.1 什麼是 Multica? 1.2 名稱由來 1.3 核心設計理念 1.4 與傳統工具的差異比較 1.5 適用場景 1.6 專案基本資訊 1.7 授權模式說明 第 2 章:系統架構設計 2.1 整體架構概覽 2.2 技術棧詳解 2.3 元件說明 2.4 企業整合架構 2.5 資料流向與通訊模型 第 3 章:安裝與部署 3.1 部署模式選擇 3.2 Self-Hosted 快速部署(推薦) 3.3 Self-Hosted 手動部署(Step-by-Step) 3.4 Kubernetes 部署(Helm Chart) 3.5 環境變數設定 3.6 Production 部署(反向代理) 3.7 不使用 Docker 的手動部署 3.8 Usage Dashboard Rollup 設定 3.9 停止服務 3.10 切換至 Multica Cloud 第 4 章:核心運作機制 4.1 任務生命週期(Issue Lifecycle) 4.2 Agent 自主執行流程 4.3 任務排程與佇列機制 4.4 WebSocket 通訊流程 4.5 Execution History 查詢 4.6 Issue Metadata(結構化屬性) 4.7 Subscribers(訂閱機制) 4.8 Thread-aware Comments(串接式評論) 第 5 章:AI Agent 整合 5.1 支援的 AI Agent 5.2 Agent CLI 安裝 5.3 CLI 自動偵測機制 5.4 Agent 環境變數(Per-Agent 設定) 5.5 Agent 建立與設定 5.6 Prompt 設計策略(Agent 專用) 5.7 多 Agent 協作模式 第 6 章:開發流程 6.1 完整開發流程 6.2 Issue 管理 6.3 範例:Spring Boot API 開發流程 6.4 範例:Vue 前端功能開發流程 6.5 與 Git Flow 整合 第 7 章:Skill(技能)機制設計 7.1 Skill 概念 7.2 Skill 類型 7.3 Skill 定義與儲存 7.4 範例:自動部署 Skill 7.5 範例:Code Review Skill 7.6 範例:DB Migration Skill 7.7 建立企業級 Skill Library 第 8 章:多工作空間(Workspace)設計 8.1 Workspace 概念 8.2 Workspace CLI 管理 8.3 團隊隔離策略 8.4 權限控管(RBAC) 8.5 多 Daemon Profile 8.6 工作空間垃圾回收(Workspace GC) 第 9 章:Squads(團隊編組) 9.1 Squads 概念 9.2 Squad 的價值 9.3 企業應用場景 第 10 章:Autopilots(自動化排程) 10.1 Autopilots 概念 10.2 Autopilot CLI 管理 10.3 企業應用範例 第 11 章:Projects(專案管理) 11.1 Projects 概念 11.2 Project CLI 管理 11.3 Project 與 Issue 整合 11.4 企業應用場景 第 12 章:MCP 整合(Model Context Protocol) 12.1 MCP 概述 12.2 MCP 整合場景 第 13 章:系統維運(Operations) 13.1 Log 管理 13.2 Agent 狀態監控 13.3 監控架構 13.4 建議監控指標 13.5 錯誤處理與復原 13.6 效能優化 第 14 章:系統升級與擴展(Upgrade & Scaling) 14.1 Multica 升級策略 14.2 版本管理策略 14.3 Agent 水平擴展 14.4 高可用架構(HA) 14.5 切換至 Multica Cloud 第 15 章:安全設計(Security) 15.1 認證與授權 15.2 Agent 權限隔離 15.3 憑證管理 15.4 網路安全 15.5 SSDLC 整合 第 16 章:最佳實務(Best Practices) 16.1 團隊導入策略 16.2 Prompt Engineering 原則 16.3 Agent 使用規範 16.4 常見錯誤與避免方式 16.5 開發環境最佳實務 第 17 章:實戰案例(Case Study) 17.1 案例:建立企業 Web 系統 17.2 案例總結 附錄 A:檢查清單(Checklist) 附錄 B:CLI 快速參考卡 附錄 C:術語表(Glossary) 第 1 章:Multica 概述 1.1 什麼是 Multica? Multica 是一個開源的 Managed AI Agent 平台,致力於將 AI 編碼代理轉化為團隊中真正的「虛擬隊友」。有別於傳統 AI 對話工具的被動互動模式,Multica 提供完整的任務管理與 Agent 自主執行基礎設施,使 AI Agent 成為開發流程中不可或缺的一等公民(First-Class Citizen)。 ...