Pr Review

---
description: "PR 체계적 리뷰로 품질 확보. 「PR 리뷰해줘」「이 풀리퀘스트 확인해줘」「코드 리뷰해줘」등으로 기동."
allowed-tools:
  - Bash(gh *)
  - Read
  - Grep
  - Glob
---

# PR 체계적 리뷰로 품질 확보

Pull Request 의 체계적 리뷰로 코드 품질과 아키텍처 건전성을 확보합니다.

## 사용법

```bash
# PR 을 포괄적으로 리뷰
gh pr view 123 --comments
"이 PR 을 체계적으로 리뷰해서 코드 품질, 보안, 아키텍처 관점으로 피드백하세요"

# 보안 특화 리뷰
gh pr diff 123
"보안 리스크와 취약점에 초점을 맞춰서 리뷰하세요"

# 아키텍처 관점의 리뷰
gh pr checkout 123 && find . -name "*.js" | head -10
"레이어 분리, 의존관계, SOLID 원칙 관점으로 아키텍처를 평가하세요"
```

## 기본 예시

```bash
# 코드 품질의 정량적 평가
find . -name "*.js" -exec wc -l {} + | sort -rn | head -5
"코드의 복잡도, 함수 크기, 중복도를 평가해서 개선점을 지적하세요"

# 보안 취약점 체크
grep -r "password\|secret\|token" . --include="*.js" | head -10
"기밀정보 누출, 하드코딩, 인증 우회 리스크를 체크하세요"

# 아키텍처 위반 탐지
grep -r "import.*from.*\.\./\.\." . --include="*.js"
"레이어 위반, 순환 의존, 결합도 문제를 평가하세요"
```

## 코멘트 분류 체계

```text
🔴 critical.must: 치명적 문제
├─ 보안 취약점
├─ 데이터 정합성 문제
└─ 시스템 장애 리스크

🟡 high.imo: 높은 우선도 개선
├─ 기능 불량 리스크
├─ 성능 문제
└─ 유지보수성 대폭 저하

🟢 medium.imo: 중간 우선도 개선
├─ 가독성 향상
├─ 코드 구조 개선
└─ 테스트 품질 향상

🟢 low.nits: 경미한 지적
├─ 스타일 통일
├─ 오타 수정
└─ 주석 추가

🔵 info.q: 질문·정보 제공
├─ 구현 의도 확인
├─ 설계 판단 배경
└─ 베스트 프랙티스 공유
```

## 리뷰 관점

### 1. 코드 정확성

- **로직 에러**: 경계값, Null 체크, 예외 처리
- **데이터 정합성**: 타입 안전성, 밸리데이션
- **에러 핸들링**: 망라성, 적절한 처리

### 2. 보안

- **인증·인가**: 적절한 체크, 권한 관리
- **입력 검증**: SQL 인젝션, XSS 대책
- **기밀정보**: 로그 출력 금지, 암호화

### 3. 성능

- **알고리즘**: 시간 계산 복잡도, 메모리 효율성
- **데이터베이스**: N+1 쿼리, 인덱스 최적화
- **리소스**: 메모리 누수, 캐시 활용

### 4. 아키텍처

- **레이어 분리**: 의존 방향, 적절한 분리
- **결합도**: 느슨한 결합, 인터페이스 활용
- **SOLID 원칙**: 단일 책임, 개방 폐쇄, 의존성 역전

## 리뷰 플로

1. **사전 확인**: PR 정보, 변경 차분, 관련 Issue
2. **체계적 체크**: 보안 → 정확성 → 성능 → 아키텍처
3. **건설적 피드백**: 구체적인 개선안과 코드 예시
4. **팔로우업**: 수정 확인, CI 상태, 최종 승인

## 효과적인 코멘트 예시

### 보안 문제 템플릿

**포맷**:

```text
**critical.must.** [문제점 요약]

[구체적인 위험 설명]

권장 해결방안:
[해결 방법]
```

**예시**:

```text
**critical.must.** 패스워드가 평문으로 저장되고 있습니다

보안 리스크를 방지하기 위해 해싱화가 필수입니다.

권장 해결방안:
const bcrypt = require('bcrypt');
const hashedPassword = await bcrypt.hash(password, 12);
```

### 성능 개선 템플릿

**포맷**:

```text
**high.imo.** [성능 문제점]

[문제 상황 설명]

개선안:
[최적화 방법]
```

**예시**:

```text
**high.imo.** N+1 쿼리 문제가 발생합니다

쿼리 수를 대폭 줄일 수 있습니다.

개선안:
// Eager Loading 사용
const users = await User.findAll({ include: [Post] });
```

### 아키텍처 위반 템플릿

**포맷**:

```text
**high.must.** [아키텍처 문제점]

[위반 내용 설명]
[개선 방향 제시]
```

**예시**:

```text
**high.must.** 레이어 위반이 발생하고 있습니다

도메인 레이어가 인프라 레이어에 직접 의존하고 있습니다.
의존성 역전 원칙으로 인터페이스를 도입하세요.
```

## 주의사항

- **건설적 톤**: 공격적이 아닌 협조적인 커뮤니케이션
- **구체적 제안**: 문제 지적뿐만 아니라 해결안 제시
- **우선순위**: Critical → High → Medium → Low 순으로 대응
- **지속적 개선**: 리뷰 결과를 지식베이스화