GitHub PR 리뷰 봇 | Easy Understand Hermes Agent

GitHub PR 리뷰 봇

커피 브레이크도 없고, “나중에 볼게”라는 말도 없는, 모든 풀 리퀘스트가 도착하자마자 리뷰해주는 지칠 줄 모르는 팀원이 있다고 상상해보세요. 그게 바로 Hermes Agent로 만들 수 있는 것입니다.

만들고자 하는 것

GitHub 저장소를 감시하고 새 풀 리퀘스트를 자동으로 리뷰하는 봇입니다. 누군가 PR을 열면 봇이 뛰어들어 diff를 확인하고 피드백을 게시합니다. 모든 과정이 WeChat을 통해 이루어져서 채팅 앱에서 바로 리뷰를 확인할 수 있습니다.

1단계: WeChat 게이트웨이 준비하기

먼저 Hermes를 WeChat에 연결해야 합니다. 이 과정에서는 iLink Bot을 사용하는데, 서버를 실행하지 않고도 메시지를 받고 보낼 수 있게 해줍니다.

# Hermes Agent 설치
pip install hermes-agent

# WeChat 어댑터 설정
hermes gateway setup

QR 코드가 표시되면 WeChat으로 스캔하여 로그인하세요. 자격 증명은 자동으로 저장됩니다.

2단계: 봇 설정하기

config.yaml 파일을 만들고 WeChat 설정을 추가하세요:

platforms:
  weixin:
    extra:
      account_id: your-account-id
      dm_policy: open

이제 GitHub 통합을 추가합니다. GitHub에서 개인 액세스 토큰이 필요합니다:

integrations:
  github:
    token: your-github-token
    repos:
      - your-username/your-repo

3단계: 리뷰 로직 작성하기

새 PR이 열릴 때 트리거되는 간단한 스크립트를 만드세요:

from hermes import Agent

agent = Agent()

@agent.on("github.pull_request.opened")
async def review_pr(event):
    pr = event.pull_request
    diff = await pr.get_diff()
    
    # 간단한 검사: 큰 PR에 플래그 표시
    if len(diff.splitlines()) > 500:
        await pr.comment("⚠️ 이 PR은 상당히 큽니다. 분할하는 것을 고려해보세요.")
    
    # 테스트 누락 확인
    if "test" not in diff.lower():
        await pr.comment("참고: 테스트 변경 사항이 감지되지 않았습니다.")

4단계: 게이트웨이 실행하기

hermes gateway

끝입니다! 이제 봇이 작동합니다. 누군가 PR을 열면 자동으로 PR에 코멘트를 게시하고 WeChat 알림을 보내줍니다.

왜 이게 좋은가

웹훅이나 서버 불필요 — Hermes가 GitHub를 롱폴링하므로 공개 엔드포인트가 필요 없습니다
스마트한 메시지 처리 — 긴 리뷰도 하나의 버블에 유지되어 어색하게 분할되지 않습니다
입력 표시기 — 봇이 작업하는 동안 WeChat에서 “입력 중…“이 표시됩니다
내장 재시도 — 일시적인 오류로 봇이 중단되지 않습니다

요약 및 실용 팁

인프라 없이 WeChat에서 작동하는 PR 리뷰 봇을 방금 만들었습니다. 간단하게 시작하세요 — 큰 PR에 플래그를 표시하고, 테스트 누락을 확인하고, 체인지로그 업데이트를 알려주는 것부터요.

실용적인 팁: 처음에는 하나의 검사(위의 테스트 감지 같은)만으로 시작하세요. 일주일간 실행하면서 팀이 실제로 무엇을 필요로 하는지 확인한 다음 규칙을 추가하세요. 세 가지를 잘하는 봇이 모든 것을 시도하다 모두를 짜증나게 하는 봇보다 낫습니다.