MAGI Code Review

🚀 MAGIシステム

MAGIシステムは、智能化されたコードレビュープラットフォームです。このシステムは、コードの品質向上や潜在的な問題の早期発見に役立ちます。

🚀 クイックスタート

MAGIシステムは、以下の主要な部分で構成されています。

✨ 主な機能

1. クライアント（Client）

• 機能：レビュー対象のコードファイルを送信し、レビュー結果を受信します。
• ワークフロー：
  1. レビュー対象のコードをMCPサーバーに送信します。
  2. レビュー結果レポートを受け取り、表示します。

2. サーバー（Server）

• 役割：クライアントとMAGIゲートウェイの間の橋渡しをします。
• アーキテクチャ：

  テストクライアント <-> MCPサーバー <-> MAGIゲートウェイ <-> レビューエージェント（メルキオル、バルタザール、カスパー）
  

3. レビューエージェント

メルキオル（Melchior）

• 職責：コードのアーキテクチャレビューを担当します。
• レビュー内容：
  • コード構造分析
  • 設計パターン評価
  • システム結合度チェック
  • 拡張性分析

バルタザール（Balthasar）

• 職責：安全性と安定性のレビューを担当します。
• レビュー内容：
  • 入力検証チェック
  • エラー処理メカニズム
  • セキュリティホールスキャン
  • システムの安定性と耐障害性評価

カスパー（Casper）

• 職責：機能の完全性とユーザー体験のレビューを担当します。
• レビュー内容：
  • 機能実装の完全性
  • ユーザーインタラクション体験
  • ドキュメント説明
  • エラーメッセージとログ記録

📚 ドキュメント

レビューフロー

1. クライアントがコードをMCPサーバーに送信します。
2. サーバーがコードをMAGIゲートウェイに転送します。
3. ゲートウェイがコードを3つのレビューエージェントに分配し、並列評価を行います。
4. 各エージェントがPOSITIVEまたはNEGATIVEの判定結果を生成します。
5. 最終決定は多数決方式で行われます（少なくとも2つの肯定的な評価が必要）。
6. レビュー結果がクライアントに返されます。

開発情報

デバッグモード

• デバッグログを有効にする：

  DEBUG=1 python -m src.server
  

• クライアントでデバッグオプションを使用する：

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

📄 ライセンス

本プロジェクトは、MITライセンスに従います。