Show GN: AI Algorithm Mentor - 알고리즘 풀이를 자동으로 리뷰해주는 GitHub Action

AI Algorithm Mentor — 알고리즘 풀이를 자동으로 리뷰해주는 GitHub Action

알고리즘 문제를 풀고 커밋하면, 문제 내용 + 내 코드를 함께 분석해서 “왜 이 풀이가 맞는지/느린지/개선점이 뭔지”를 코치처럼 코멘트로 남겨주는 AI 기반 코드 리뷰 GitHub Action입니다.

어떤 상황에 유용한가요?

• 코딩테스트/알고리즘을 혼자 공부하면서 “피드백이 아쉬운” 상황
• 풀이가 맞긴 한데 시간 복잡도, 엣지케이스, 더 깔끔한 구현 관점에서 점검하고 싶은 상황
• 레포에 문제풀이를 꾸준히 올리면서, 자동으로 회고(피드백 로그)를 쌓고 싶은 상황

핵심 아이디어 (동작 방식)

1. 풀이 파일 첫 줄 주석에 문제 URL을 적습니다.
2. push 시 Action이 해당 URL을 감지해 온라인 저지 페이지를 크롤링하고(제목/설명/입출력/예제 등),
3. 코드와 함께 LLM이 분석한 뒤
4. 결과를 커밋 코멘트로 자동 게시합니다.

주요 기능

• 지능형 코드 분석

  • 문제 요구사항/제약 자동 파악
  • 시간/공간 복잡도 분석 및 최적화 제안
  • 가독성/컨벤션 개선 제안
  • CrewAI 기반 “알고리즘 리뷰 에이전트” 구조

• Online Judge 자동 감지 & 크롤링

  • 파일 첫 줄 주석의 문제 URL로 플랫폼 자동 판별
  • 문제 페이지에서 필요한 정보 자동 수집

• 여러 파일 동시 처리

  • 여러 풀이 파일을 비동기로 병렬 처리

• 지원 플랫폼

  • 백준, LeetCode, 프로그래머스

• 여러 LLM 제공자/모델 지원

  • OpenAI / Google(Gemini) / Anthropic(Claude) 등 멀티 프로바이더 구성 (LiteLLM 기반) ([GitHub][1])

• 다국어 리뷰

  • 리뷰 응답 언어 선택 가능

사용법 (요약)

• 레포 Secrets에 API 키(예: GEMINI_API_KEY 또는 OPENAI_API_KEY 등)를 등록하고
• 워크플로우에서 choam2426/AI-Algorithm-Mentor@v5를 사용하면 됩니다.
• 풀이 파일 첫 줄에 문제 URL 주석만 지켜주면, 이후부터는 커밋마다 자동 리뷰가 달립니다.

라이선스 / 스펙

• MIT License
• Python 3.13+

---