English | 繁體中文

MAGI System

參考新世紀福音戰士的 MAGI 超級電腦 - 三機平行共識決策系統

概述

MAGI 是一個 AI 多模型協作系統，讓三個不同的 AI 模型同時平行分析同一任務，各自從不同視角提出觀點，最終透過投票機制達成共識。

三大母體

代號	名稱	引擎	人格面向	分析角度
1號機	MELCHIOR-1	Claude (opus/sonnet)	科學家 (創新者)	架構、可行性、技術深度
2號機	BALTHASAR-2	Gemini 3 (MCP)	母親 (守護者)	品質、可維護性、最佳實踐
3號機	CASPER-3	Codex-CLI (MCP)	直覺 (防護者)	安全、風險、邊界條件

指令格式

主要指令

/magi [子命令] [參數]

快捷指令

/magi-brainstorm [idea]     # 創意發想
/magi-arch [design]         # 架構審查
/magi-plan [task]           # 計畫制定
/magi-review [code/PR]      # 代碼審查
/magi-security [scope]      # 安全審查
/magi-test [feature]        # 測試審查

輔助指令

/magi help                  # 顯示使用說明
/magi cancel                # 取消執行中的分析

支援任務類型

任務	主要指令	快捷指令	三機分析重點
Brainstorming	/magi brainstorm [idea]	/magi-brainstorm	創意發想、可行性、風險
架構審查	/magi arch [design]	/magi-arch	架構合理性、擴展性、安全性
計畫制定	/magi plan [task]	/magi-plan	計畫完整性、實施順序、風險緩解
代碼審查	/magi review [code/PR]	/magi-review	邏輯正確、品質標準、安全漏洞
安全審查	/magi security [scope]	/magi-security	威脅模型、漏洞檢測、合規性
測試審查	/magi test [feature]	/magi-test	測試覆蓋、邊界條件、異常處理

模型設定

三機模型依任務類型自動選擇：深度任務（architecture / security / plan / brainstorm）使用強推理模型，快速任務（review / test）使用輕量模型。

完整的「任務 × 模型」對照表、可用模型清單與 reasoningEffort 參數，以 skills/SKILL.md 的「模型設定」章節為唯一準則。

資料治理

⚠️ 重要：MAGI 會將任務內容同時送往三家 AI 供應商 (Claude/Gemini/Codex)

資料分級

等級	定義	MAGI 可用性
PUBLIC	公開資訊、開源代碼	✅ 可直接使用
INTERNAL	內部文件、非機密代碼	⚠️ 需移除識別資訊
CONFIDENTIAL	機密資料、客戶資訊	❌ 禁止使用
RESTRICTED	個資、金融、醫療資料	❌ 禁止使用

使用前確認

• 任務內容不包含機密/個資
• API Keys 與 Secrets 已移除
• 符合組織的資料外傳政策

共識機制

風險分級門檻

等級	定義	通過門檻
LOW	低風險	2:1 通過
MEDIUM	中風險	2:1 通過，記錄異議
HIGH	高風險	3:0 全票通過
CRITICAL	關鍵	3:0 + CASPER-3 必須同意

安全一票否決權

當 CASPER-3 標記 SEVERITY: CRITICAL 並投下 VETO: YES 時，即使其他兩機同意，系統仍判定為 REJECTED。

ABSTAIN 計票規則

情況	計票	結果
2A + 0R + 1AB	2:0	APPROVE ✅
1A + 1R + 1AB	1:1	REJECT ❌
1A + 0R + 2AB	有效票不足	INCONCLUSIVE ⚠️

Quorum：至少需要 2 票有效票才能做出決策。

降級機制

情況	處理方式
1 機失效	以 2 機投票
2 機失效	中止分析
MCP 連線失敗	重試 1 次後降級

執行流程

┌─────────────────────────────────────────────────────────────┐
│  Phase 1: MAGI 決策（三機平行）                              │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐               │
│  │ MELCHIOR  │  │ BALTHASAR │  │  CASPER   │               │
│  │  (Claude) │  │  (Gemini) │  │  (Codex)  │               │
│  └─────┬─────┘  └─────┬─────┘  └─────┬─────┘               │
│        └──────────────┼──────────────┘                      │
│                       ▼                                     │
│               共識報告 + 行動項目                            │
├─────────────────────────────────────────────────────────────┤
│  Phase 2: 用戶確認                                          │
│        「執行全部」或「執行 1, 3」                           │
├─────────────────────────────────────────────────────────────┤
│  Phase 3: 單機執行                                          │
│        Claude 本機根據行動項目逐一實作                       │
├─────────────────────────────────────────────────────────────┤
│  （可選）再次 MAGI 審查實作結果                              │
└─────────────────────────────────────────────────────────────┘

💡 設計原則：MAGI 負責「決策」（多元觀點降低風險），單機負責「執行」（避免衝突）

安裝

方式一：透過 Claude Code Plugin 安裝（推薦）

1. 在 Claude Code 中執行 /plugin
2. 選擇 Marketplaces 分頁
3. 選擇 Add Marketplace
4. 輸入：weiting-tw/MAGI-System（或本 repo 的 GitHub 路徑）
5. 返回 Discover 分頁，安裝 magi-system
6. 重啟 Claude Code 即可使用

方式二：手動安裝

將各 skill 複製到 ~/.claude/skills/（每個 skill 一個目錄，符合 ~/.claude/skills/<skill-name>/SKILL.md 結構）：

git clone https://github.com/weiting-tw/MAGI-System.git
mkdir -p ~/.claude/skills/magi
cp MAGI-System/skills/SKILL.md ~/.claude/skills/magi/
cp -r MAGI-System/skills/references ~/.claude/skills/magi/
cp -r MAGI-System/skills/magi-* ~/.claude/skills/

前置需求

• Claude Code CLI
• MCP 設定（用於 BALTHASAR-2 和 CASPER-3）：
  • gemini MCP server - Gemini CLI
  • codex-cli MCP server - Codex CLI

授權

MIT License

致謝

靈感來自《新世紀福音戰士》中的 MAGI 超級電腦系統。