MAGI Code Review

🚀 MAGI系統

MAGI系統是一個智能化的代碼審查平臺，它能高效地對代碼進行多維度審查，為開發者提供全面的代碼質量評估，有效提升代碼的架構合理性、安全性和功能完整性。

🚀 快速開始

調試模式

• 啟用調試日誌：

DEBUG=1 python -m src.server

• 客戶端使用調試選項：

python -m src.client --file my_code.py --debug

✨ 主要特性

MAGI系統主要由客戶端、服務端和審查代理三部分組成，各部分協同工作，實現高效的代碼審查：

1. 客戶端（Client）

• 功能：負責提交需要審查的代碼文件，並接收審查結果。
• 工作流程：
  1. 提交待審代碼到MCP服務器。
  2. 收取並顯示審查結果報告。

2. 服務端（Server）

• 角色：作為客戶端與MAGI網關之間的橋樑。
• 架構：

測試客戶端 <-> MCP服務端 <-> MAGI網關 <-> 審查代理（梅爾基奧、巴爾薩澤、卡斯珀）

3. 審查代理

梅爾基奧（Melchior）

• 職責：負責代碼的架構審查。
• 審查內容：
  • 代碼結構分析
  • 設計模式評估
  • 系統耦合度檢查
  • 可擴展性分析

巴爾薩澤（Balthasar）

• 職責：負責安全性和穩定性審查。
• 審查內容：
  • 輸入驗證檢查
  • 錯誤處理機制
  • 安全漏洞掃描
  • 系統穩定性和容錯能力評估

卡斯珀（Casper）

• 職責：負責功能完整性和用戶體驗審查。
• 審查內容：
  • 功能實現的完整性
  • 用戶交互體驗
  • 文檔說明
  • 錯誤提示和日誌記錄

📚 詳細文檔

審查流程

1. 客戶端提交代碼到MCP服務端。
2. 服務端將代碼轉發至MAGI網關。
3. 網關分發代碼給三個審查代理進行並行評估。
4. 每個代理生成POSITIVE或NEGATIVE的決策結果。
5. 最終決定採用多數投票機制（至少兩個正面評價才能通過）。
6. 審查結果回傳至客戶端。

📄 許可證

本項目遵循MIT許可證協議。