AI Algorithm Mentor - GitHub Action que revisa automáticamente soluciones de algoritmos

AI Algorithm Mentor — GitHub Action que revisa automáticamente soluciones de algoritmos

Cuando resuelves un problema de algoritmos y haces commit, esta es una GitHub Action de revisión de código basada en IA que analiza en conjunto el enunciado del problema + tu código y deja comentarios como un coach sobre “por qué esta solución es correcta/lenta/cuáles son los puntos de mejora”.

¿En qué situaciones es útil?

• Cuando estudias por tu cuenta para entrevistas de código/algoritmos y sientes que “te falta retroalimentación”
• Cuando la solución es correcta, pero quieres revisarla desde la perspectiva de complejidad temporal, casos límite y una implementación más limpia
• Cuando quieres subir soluciones al repositorio de forma constante y acumular automáticamente retrospectivas (registro de feedback)

Idea principal (cómo funciona)

1. Escribes la URL del problema en el comentario de la primera línea del archivo de la solución.
2. Al hacer push, la Action detecta esa URL y rastrea la página del juez en línea (título/descripcion/entrada/salida/ejemplos, etc.).
3. Luego el LLM la analiza junto con el código.
4. El resultado se publica automáticamente como comentario del commit.

Funciones principales

• Análisis inteligente de código

  • Comprensión automática de requisitos y restricciones del problema
  • Análisis de complejidad de tiempo/espacio y sugerencias de optimización
  • Sugerencias para mejorar legibilidad y convenciones
  • Estructura de “agente revisor de algoritmos” basada en CrewAI

• Detección automática y rastreo de Online Judge

  • Identifica automáticamente la plataforma a partir de la URL del problema en el comentario de la primera línea del archivo
  • Recolecta automáticamente la información necesaria desde la página del problema

• Procesamiento simultáneo de varios archivos

  • Procesa varios archivos de soluciones en paralelo y de forma asíncrona

• Plataformas compatibles

  • Baekjoon, LeetCode, Programers

• Soporte para varios proveedores/modelos de LLM

  • Configuración multi-provider como OpenAI / Google(Gemini) / Anthropic(Claude), etc. (basado en LiteLLM) ([GitHub][1])

• Reseñas multilingües

  • Permite elegir el idioma de la respuesta de la reseña

Uso (resumen)

• Registra una API key en los Secrets del repositorio (por ejemplo, GEMINI_API_KEY o OPENAI_API_KEY, etc.)
• En el workflow, usa choam2426/AI-Algorithm-Mentor@v5.
• Si mantienes solo el comentario con la URL del problema en la primera línea del archivo de la solución, a partir de ahí se agregará una revisión automática en cada commit.

Licencia / especificaciones

• MIT License
• Python 3.13+

---