AI Algorithm Mentor - GitHub Action que revisa automaticamente soluções de algoritmos

AI Algorithm Mentor — GitHub Action que revisa automaticamente soluções de algoritmos

Quando você resolve um problema de algoritmo e faz um commit, ele analisa em conjunto o enunciado do problema + o seu código e deixa um comentário no estilo de um coach explicando “por que essa solução está correta/lenta/quais são os pontos de melhoria”. É uma GitHub Action de revisão de código baseada em IA.

Em que situações isso é útil?

• Quando você estuda coding tests/algoritmos sozinho e sente falta de feedback
• Quando a solução está correta, mas você quer revisar sob a perspectiva de complexidade de tempo, casos de borda e uma implementação mais limpa
• Quando você quer publicar soluções continuamente no repositório e acumular automaticamente retrospectivas (logs de feedback)

Ideia principal (como funciona)

1. Escreva a URL do problema no comentário da primeira linha do arquivo da solução.
2. No push, a Action detecta essa URL e faz crawling da página do online judge (título/descrição/entrada e saída/exemplos etc.).
3. Depois, a LLM faz a análise junto com o código.
4. O resultado é publicado automaticamente como comentário no commit.

Principais recursos

• Análise inteligente de código

  • Identificação automática de requisitos/restrições do problema
  • Análise de complexidade de tempo/espaço e sugestões de otimização
  • Sugestões para melhorar legibilidade/convenções
  • Estrutura de “agente de revisão de algoritmos” baseada em CrewAI

• Detecção automática de Online Judge e crawling

  • Identificação automática da plataforma pela URL do problema no comentário da primeira linha do arquivo
  • Coleta automática das informações necessárias na página do problema

• Processamento simultâneo de vários arquivos

  • Processamento paralelo assíncrono de vários arquivos de solução

• Plataformas compatíveis

  • Baekjoon, LeetCode, Programmers

• Suporte a vários provedores/modelos de LLM

  • Configuração multi-provider com OpenAI / Google(Gemini) / Anthropic(Claude) etc. (baseado em LiteLLM) ([GitHub][1])

• Revisão multilíngue

  • Possibilidade de escolher o idioma da resposta da revisão

Como usar (resumo)

• Cadastre a chave de API nos Secrets do repositório (por exemplo, GEMINI_API_KEY ou OPENAI_API_KEY etc.)
• No workflow, use choam2426/AI-Algorithm-Mentor@v5.
• Basta manter o comentário com a URL do problema na primeira linha do arquivo da solução, e a partir daí uma revisão automática será adicionada a cada commit.

Licença / Especificações

• MIT License
• Python 3.13+

---