코드리뷰
GitHub PR 또는 원격 PC의 미커밋 변경을 diff chunk 단위로 스캔해, finding·코멘트·점검 리포트를 한 페이지로 보는 도구입니다.
한눈에 보기
코드리뷰는 "변경분 연결 → diff 스캔 → chunk별 finding → 리포트"를 목표로 합니다. 파일 전체가 아니라 바뀐 구간(hunk) 만 박스로 나누고, 각 chunk에 판단·설명·다음 행동을 붙입니다.
| 할 수 있는 것 | 설명 |
|---|---|
| PR 리뷰 | GitHub 저장소의 open PR diff를 스캔해 리뷰 리포트 생성 |
| 커밋 전 점검 | 원격 PC의 staged·unstaged 변경을 스캔해 올리기 전 점검 |
| chunk finding | 변경 구간마다 보안·로직·스타일 등 이슈를 색으로 표시 |
| 코멘트·가이드 | 리뷰어 코멘트 초안, merge 전 확인 포인트, 권장 수정 방향 |
| 예시 리포트 | 로그인 전에도 샘플 UI·리포트 형식 미리보기 |
| 내 리포트 보관 | 스캔 요약·finding을 저장하고 나중에 다시 열람 (diff 본문은 재조회) |
누구를 위한 기능인가요?
PR을 자주 리뷰하는 시니어·테크리드, 리뷰를 받는 주니어, 커밋·푸시 전에 한 번 더 확인하고 싶은 개발자를 위한 도구입니다.
프로젝트 분석이 "저장소 전체 판단"이라면, 코드리뷰는 이번에 바뀐 코드만 집중해서 봅니다.
두 가지 이용 방식
| 방식 | 대상 | 연결 방법 | 받는 결과 |
|---|---|---|---|
| PR 리뷰 | 리뷰어 | GitHub 저장소 → open PR 선택 | 블로킹·확인 포인트·코멘트 초안·리뷰 요약 |
| 커밋 전 점검 | 작성자 | 원격 PC 에이전트 → 작업 폴더 | 권장 방향·확인 체크·PR 설명 초안 |
처음 들어가면 소개 화면에서 두 방식 중 하나를 고르거나, 작업대 상단에서 PR 리뷰 ↔ 커밋 전 점검을 전환할 수 있습니다.
접속하기
- 상단 메뉴 분석 → 코드리뷰를 선택합니다.
- 또는 주소창에
/code-review를 입력합니다.
예시 리포트는 별도 페이지에서 둘러볼 수 있습니다.
로그인 없이 소개·예시 리포트는 둘러볼 수 있습니다. 실제 스캔은 로그인 후 이용하세요.
PR 리뷰 — 사용 흐름
GitHub에 연결된 PR의 diff를 읽고, merge 전에 볼 포인트를 정리합니다.
1단계 — GitHub PR 연결
저장소를 선택하면 open PR 목록이 표시됩니다. 점검할 PR을 고릅니다. 여러 PR을 한 번에 스캔할 수도 있습니다.
2단계 — diff 스캔
선택한 PR의 변경 파일·hunk를 읽고 chunk 리포트를 생성합니다. 민감 경로(인증·시크릿 등)는 먼저 볼 파일로 표시됩니다.
3단계 — chunk별 확인
각 chunk 박스에서 다음을 확인합니다.
- finding — 이 구간에서 주의할 점 (색·심각도)
- diff 본문 — 추가·삭제·주변 맥락
- 코멘트 입력 — GitHub에 올릴 리뷰 코멘트 초안 작성·수정
4단계 — 리뷰 요약·게시 (선택)
리포트 하단의 리뷰 요약으로 merge 판단을 정리합니다. 준비가 되면 GitHub Review 게시로 이어갈 수 있습니다.
5단계 — 저장·이력
코드리뷰 탭에는 이번 세션에서 점검한 PR만, 내 리포트 탭에는 과거 전체 이력이 쌓입니다. diff 본문은 서버에 장기 저장하지 않으며, 다시 열 때 GitHub에서 불러옵니다.
커밋 전 점검 — 사용 흐름
아직 PR을 만들기 전, 로컬·원격 PC에서 커밋·푸시하기 직전 변경을 점검합니다.
1단계 — 원격 PC 연결
에이전트가 설치·연결된 PC와 작업 폴더를 지정합니다. 터미널과 같은 에이전트를 사용합니다.
2단계 — 변경 범위 선택
staged·unstaged 중 점검할 범위를 고릅니다. 파일 단위로 범위를 좁힐 수도 있습니다.
3단계 — diff 스캔·리포트 확인
chunk별 finding, 권장 수정 방향, 확인 체크리스트를 봅니다. PR에 붙일 설명 초안도 함께 받을 수 있습니다.
4단계 — PR로 이어가기 (선택)
점검이 끝나 PR을 올릴 때, PR 리뷰 흐름으로 넘기면 같은 저장소·브랜치 맥락을 이어갈 수 있습니다.
세션은 브라우저에 잠시 보관되어, 새로고침 후에도 같은 PC·폴더면 이어서 작업할 수 있습니다.
chunk 리포트란?
일반 diff 목록과 달리, 코드리뷰는 의미 있는 변경 구간 단위로 화면을 나눕니다.
| 요소 | 설명 |
|---|---|
| 파일 헤더 | 경로, 변경량(+/−), 민감 경로 여부 |
| chunk 박스 | hunk 하나 + finding + (선택) 코멘트 |
| finding | 녹색·황색·적색으로 우선순위 표시 |
| executive 요약 | 이번 PR·점검 전체의 한 줄 결론 |
리뷰어는 "어디부터 볼지"를 chunk 순서로 따라가고, 작성자는 "고칠 곳·확인할 곳"을 체크리스트처럼 사용하면 됩니다.
프로젝트 분석과의 차이
| 프로젝트 분석 | 코드리뷰 | |
|---|---|---|
| 범위 | 저장소·폴더 전체 | 이번 PR·미커밋 diff |
| 질문 | "이 코드베이스, 괜찮은가?" | "이 변경, 지금 merge·push해도 되는가?" |
| 연결 | GitHub URL 또는 원격 폴더 | GitHub PR 또는 원격 staged diff |
| 결과 | 보안·건강·구조·스택 판단 리포트 | chunk finding·코멘트·점검 리포트 |
저장소를 처음 받았을 때는 프로젝트 분석, PR·커밋 단위로 볼 때는 코드리뷰를 쓰면 됩니다.
관련 도구
| 도구 | 관계 |
|---|---|
| 프로젝트 분석 | 저장소 전체 판단·온보딩·실사 |
| 터미널 | 원격 PC 연결 (커밋 전 점검) |
| GitHub | PR·저장소 연동 |
| 에이전트 설치 | 원격 PC 스캔 전제 |
요금
코드리뷰는 프로젝트 분석과 같이 서비스 메이커 사용량(BP) 을 사용합니다. 설정에서 잔여량을 확인하세요.
diff 저장 정책
점검 요약·finding·메타는 저장해 이력을 남기지만, diff 원문은 서버에 장기 보관하지 않습니다. 다시 열 때 GitHub 또는 원격 PC에서 최신 diff를 불러옵니다.