Agent Code Review

Agent Code Review는 AI Agent가 작성한 코드의 변경사항을 추적하고, 라인 단위의 정교한 피드백을 통해 완벽한 AI 페어 프로그래밍 환경을 제공하는 오픈소스 툴입니다.

왜 사용해야할까요?

• 코드 작성은 Agent가 하지만, 결국 코드의 품질을 결정하는 것은 여전히 개발자의 몫이라고 생각합니다.
• 에이전트에게 구현의 자유를 주되, 개발자는 리뷰를 통해 규율을 부과합니다.
• 기존의 채팅 기반 인터페이스는 변경된 코드 전체를 파악하기 어렵고, 특정 라인에 대한 수정을 지시할 때 문맥(Context) 손실이 컸습니다.
• 이를 해결하기 위해 익숙한 GitHub 스타일의 인터페이스를 기반으로 손쉽게 Agent의 변경사항을 리뷰할 수 있는 툴을 개발하게 되었습니다.

스크린샷

Key Features

• GitHub/Bitbucket과 동일한 Side-by-Side 및 Unified Diff 뷰를 제공하여 변경사항을 즉시 파악합니다.
• 코드의 특정 위치를 클릭하여 즉시 리뷰를 작성합니다. Agent는 이 위치 정보(Context)를 정확히 이해하고 응답합니다.
• /reply 커멘드 하나로 Agent가 당신의 모든 리뷰를 읽고 코드를 수정하거나 추가 답변합니다.
• 모든 코멘트는 프로젝트 내 .review/ 폴더에 저장됩니다.
• 로컬 디렉토리 기반으로 프로젝트 선택을 통해, 개발자는 자신이 관리하는 여러 프로젝트의 코드 리뷰를 손쉽게 진행할 수 있습니다.

설치

git clone https://github.com/leeyunbo/agent-code-review.git
cd agent-code-review
npm install

사용법

1. 서버 실행

# 현재 디렉토리 리뷰
npm start

# 특정 프로젝트 리뷰
npm start /path/to/your/project

http://localhost:3000 에서 확인

2. 코멘트 작성

1. 커밋 선택 (드롭다운)
2. 파일 선택 (왼쪽 트리)
3. 코드 라인 클릭 → 코멘트 작성

3. Agent 답변 받기 (예시: Claude)

리뷰 대상 프로젝트에서 Claude 실행 후

/reply

Claude가 .review/comments.json의 코멘트를 읽고 답변을 추가합니다.

4. 1차 코멘트 후, 추가 리뷰 진행하기

1. Claude 답변 아래 Reply 버튼 클릭
2. 추가 질문 작성
3. 다시 /reply 실행

프로젝트 구조

agent-code-review/
├── server.js              # Express 서버
├── public/
│   ├── index.html         # 메인 페이지
│   ├── app.js             # 프론트엔드 로직
│   └── style.css          # 스타일
├── .claude/
│   └── skills/
│       └── reply/
│           └── SKILL.md   # /reply 스킬 정의
└── package.json

/reply 스킬 설정

리뷰 대상 프로젝트에서 /reply 명령어를 사용하려면

방법 1: 글로벌 설치

mkdir -p ~/.claude/skills/reply
cp .claude/skills/reply/SKILL.md ~/.claude/skills/reply/

방법 2: 프로젝트별 설치

# 리뷰 대상 프로젝트에서
mkdir -p .claude/skills/reply
cp /path/to/agent-code-review/.claude/skills/reply/SKILL.md .claude/skills/reply/

코멘트 저장 위치

코멘트는 리뷰 대상 프로젝트 내에 저장됩니다.

your-project/
└── .review/
    └── comments.json

.review/는 .gitignore에 추가하는 것을 권장합니다.

라이선스

MIT