AI Algorithm Mentor - アルゴリズムの解法を自動でレビューしてくれるGitHub Action

AI Algorithm Mentor — アルゴリズムの解法を自動でレビューしてくれる GitHub Action

アルゴリズム問題を解いてコミットすると、問題内容 + 自分のコードをまとめて分析し、「なぜこの解法が正しいのか／なぜ遅いのか／改善点は何か」をコーチのようにコメントとして残してくれる AI ベースのコードレビュー GitHub Action です。

どんな場面で役立つのか？

• コーディングテストやアルゴリズムを一人で勉強していて、「フィードバックが物足りない」状況
• 解法自体は正しいが、時間計算量、エッジケース、よりクリーンな実装 の観点で点検したい状況
• リポジトリに問題の解法を継続的に上げながら、自動で振り返り（フィードバックログ）を蓄積したい状況

コアアイデア（動作方式）

1. 解法ファイルの 1 行目のコメント に問題 URL を記述します。
2. push 時に Action がその URL を検知して オンラインジャッジのページをクロール し（タイトル／説明／入出力／サンプルなど）、
3. コードとあわせて LLM が分析した後、
4. 結果を コミットコメントとして自動投稿 します。

主な機能

• インテリジェントなコード分析

  • 問題の要件・制約を自動で把握
  • 時間・空間計算量の分析と最適化提案
  • 可読性・コーディング規約の改善提案
  • CrewAI ベースの「アルゴリズムレビューエージェント」構造

• Online Judge の自動検知 & クロール

  • ファイル 1 行目のコメント内の問題 URL からプラットフォームを自動判別
  • 問題ページから必要な情報を自動収集

• 複数ファイルの同時処理

  • 複数の解法ファイルを非同期で並列処理

• 対応プラットフォーム

  • Baekjoon、LeetCode、Programmers

• 複数の LLM プロバイダー／モデルに対応

  • OpenAI / Google(Gemini) / Anthropic(Claude) などのマルチプロバイダー構成（LiteLLM ベース） ([GitHub][1])

• 多言語レビュー

  • レビュー応答言語を選択可能

使い方（要約）

• リポジトリの Secrets に API キー（例: GEMINI_API_KEY または OPENAI_API_KEY など）を登録し、
• ワークフローで choam2426/AI-Algorithm-Mentor@v5 を使えば OK です。
• 解法ファイルの 1 行目に問題 URL コメントを書くだけで、その後はコミットごとに自動レビューが付きます。

ライセンス / スペック

• MIT License
• Python 3.13+

---