ONEDEV

ai-codereviewer

AI Coding ToolsDevOpsTypeScript

★ 1,036주당 +3조회 4

무엇인가

ai-codereviewer는 GitHub Actions 워크플로에 단계로 삽입되어 풀 리퀘스트 검토를 자동화하는 TypeScript 액션이다. 코드를 직접 편집하는 도구가 아니라, PR 파이프라인의 리뷰 단계에 들어가 코멘트를 남기는 위치에 속한다.

어떻게 동작하나

동작은 워크플로 실행 시점에 시작된다. 액션이 풀 리퀘스트의 diff를 가져오고, exclude 입력에 지정된 패턴과 일치하는 파일을 걸러낸 뒤, 남은 코드를 청크로 나눠 OpenAI API로 전송한다. 응답으로 받은 텍스트를 리뷰 코멘트로 변환해 해당 풀 리퀘스트에 게시한다. API 키는 저장소 시크릿 OPENAI_API_KEY에서 읽는다.

무엇과 다른가

규칙 기반 정적 분석 도구와는 검사 방식이 다르다. 린터는 미리 정의된 규칙 위반을 보고하지만, 이 액션은 규칙 집합 없이 diff를 LLM에 넘겨 자연어 제안을 받는다. 사람 리뷰어의 코멘트를 대체하는 것이 아니라 첫 번째 검토 통과를 자동화하는 자리에 놓인다.

어떻게 쓰나

도입은 저장소 시크릿 등록과 워크플로 파일 추가 두 단계다. OPENAI_API_KEY를 GitHub Secret으로 넣고, .github/workflows/main.yml에 액션을 uses로 참조하는 잡을 작성한다. 참조 경로의 your-username을 액션이 위치한 사용자 또는 조직 이름으로 바꾸고, exclude 입력으로 검토에서 뺄 파일 패턴을 지정한다. 커밋 이후 생성되는 풀 리퀘스트부터 동작한다.

전제와 한계

전제 조건은 OpenAI API 키와 GitHub Actions 실행 환경이다. 코드 diff가 외부 OpenAI API로 전송되므로 저장소 밖으로 나가면 안 되는 코드는 exclude로 제외해야 한다. 검토 대상은 풀 리퀘스트 이벤트에 한정되며, 배포용 패키지는 관리자가 yarn build와 yarn package로 생성한다. 라이선스는 MIT다.

유사 도구