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许可证协议。