Code Reviewer — 코드 리뷰 자동화 파이프라인
코드의 스타일→보안→성능→아키텍처를 에이전트 팀이 체계적으로 리뷰한다.
실행 모드
에이전트 팀 — 5명이 SendMessage로 직접 통신하며 교차 검증한다.
에이전트 구성
| 에이전트 |
파일 |
역할 |
타입 |
| style-inspector |
.claude/agents/style-inspector.md |
컨벤션, 포맷팅, 네이밍, 가독성 |
general-purpose |
| security-analyst |
.claude/agents/security-analyst.md |
취약점, 인젝션, 인증, 데이터 노출 |
general-purpose |
| performance-analyst |
.claude/agents/performance-analyst.md |
복잡도, 메모리, 동시성, 쿼리 |
general-purpose |
| architecture-reviewer |
.claude/agents/architecture-reviewer.md |
설계 패턴, SOLID, 의존성, 결합도 |
general-purpose |
| review-synthesizer |
.claude/agents/review-synthesizer.md |
우선순위 종합, 충돌 해결, 최종 판정 |
general-purpose |
워크플로우
Phase 1: 준비 (오케스트레이터 직접 수행)
- 사용자 입력에서 추출한다:
- 대상 코드: 파일 경로, PR 번호, diff, 디렉토리
- 언어/프레임워크: 자동 감지 또는 사용자 지정
- 리뷰 범위 (선택): 특정 영역만 요청한 경우
- 컨텍스트 (선택): PR 설명, 관련 이슈, 변경 이유
- 스타일 가이드 (선택): 팀 고유 컨벤션
_workspace/ 디렉토리를 프로젝트 루트에 생성한다
- 입력을 정리하여
_workspace/00_input.md에 저장한다
- 대상 코드를 식별하고 리뷰 범위를 결정한다
- 기존 파일이 있으면
_workspace/에 복사하고 해당 Phase를 건너뛴다
- 요청 범위에 따라 실행 모드를 결정한다
Phase 2: 팀 구성 및 실행
| 순서 |
작업 |
담당 |
의존 |
산출물 |
| 1a |
스타일 리뷰 |
style-inspector |
없음 |
_workspace/01_style_review.md |
| 1b |
보안 리뷰 |
security-analyst |
없음 |
_workspace/02_security_review.md |
| 1c |
성능 리뷰 |
performance-analyst |
없음 |
_workspace/03_performance_review.md |
| 1d |
아키텍처 리뷰 |
architecture-reviewer |
없음 |
_workspace/04_architecture_review.md |
| 2 |
종합 리뷰 |
review-synthesizer |
작업 1a~1d |
_workspace/05_review_summary.md |
작업 1a~1d(4개 영역 리뷰)는 모두 병렬 실행한다.
팀원 간 소통 흐름:
- style-inspector → security-analyst에게 주석 내 민감 정보 전달, performance-analyst에게 복잡 함수 목록 전달
- security-analyst → performance-analyst에게 보안 조치 성능 영향 전달, architecture-reviewer에게 인증 아키텍처 전달
- performance-analyst → architecture-reviewer에게 구조적 병목 전달
- review-synthesizer는 모든 리뷰를 통합. 영역 간 충돌 발견 시 해당 분석가에게 추가 분석 요청
Phase 3: 통합 및 최종 산출물
종합 보고서를 기반으로 최종 산출물을 정리한다:
_workspace/ 내 모든 리뷰를 확인한다
- 최종 판정(Approve/Request Changes/Reject)을 결정한다
- 최종 요약을 사용자에게 보고한다
작업 규모별 모드
| 사용자 요청 패턴 |
실행 모드 |
투입 에이전트 |
| "코드 리뷰해줘", "전체 리뷰" |
풀 리뷰 |
5명 전원 |
| "보안 리뷰만 해줘" |
보안 모드 |
security-analyst + review-synthesizer |
| "성능 분석해줘" |
성능 모드 |
performance-analyst + review-synthesizer |
| "아키텍처 리뷰해줘" |
아키텍처 모드 |
architecture-reviewer + review-synthesizer |
| "코드 스타일만 봐줘" |
스타일 모드 |
style-inspector + review-synthesizer |
PR 리뷰: PR 번호가 제공되면 diff를 추출하여 변경된 코드만 리뷰한다. 전체 파일 컨텍스트도 참조하지만 리뷰 대상은 diff에 집중한다.
데이터 전달 프로토콜
| 전략 |
방식 |
용도 |
| 파일 기반 |
_workspace/ 디렉토리 |
주요 산출물 저장 및 공유 |
| 메시지 기반 |
SendMessage |
실시간 핵심 정보 전달, 추가 분석 요청 |
| 태스크 기반 |
TaskCreate/TaskUpdate |
진행 상황 추적, 의존 관계 관리 |
파일명 컨벤션: {순번}_{에이전트}_{산출물}.{확장자}
에러 핸들링
| 에러 유형 |
전략 |
| 언어 미식별 |
파일 확장자 + 코드 패턴에서 자동 감지 |
| 대용량 코드 |
변경된 파일 또는 핵심 파일에 집중, 범위를 리뷰 보고서에 명시 |
| 에이전트 실패 |
1회 재시도 → 실패 시 해당 영역 없이 진행, 종합 보고서에 누락 명시 |
| 영역 간 충돌 |
review-synthesizer가 트레이드오프 분석 후 판정 |
| 컨텍스트 부족 |
PR 설명이나 이슈 번호가 없으면 코드만으로 리뷰, 제한 사항 명시 |
테스트 시나리오
정상 흐름
프롬프트: "이 Python Flask 프로젝트를 전체 코드 리뷰해줘" + 코드 파일/디렉토리
기대 결과:
- 스타일: PEP 8 기준, 네이밍/포맷팅/가독성 검사, Black/flake8 설정 제안
- 보안: SQL 인젝션, XSS, 하드코딩 시크릿, 의존성 CVE 검사
- 성능: 쿼리 최적화, N+1, 메모리 사용, 캐싱 기회
- 아키텍처: MVC 패턴 준수, SOLID, 의존성 분석
- 종합: 통합 우선순위, 최종 판정, 액션 아이템
기존 파일 활용 흐름
프롬프트: "이 PR의 보안만 리뷰해줘" + PR diff
기대 결과:
- 보안 모드: security-analyst + review-synthesizer 투입
- diff 중심 리뷰, 전체 파일 컨텍스트 참조
- style-inspector, performance-analyst, architecture-reviewer 건너뜀
에러 흐름
프롬프트: "이 코드 봐줘" + 단일 파일 (100줄 미만)
기대 결과:
- 소규모 코드 → 아키텍처 리뷰는 함수 분리/모듈 설계 관점으로 축소
- 풀 리뷰 모드로 실행하되, 각 영역이 코드 규모에 맞게 조정
- 종합 보고서에 "단일 파일 리뷰, 아키텍처 평가 제한적" 명시
에이전트별 확장 스킬
개별 에이전트의 도메인 전문성을 강화하는 확장 스킬:
| 스킬 |
대상 에이전트 |
역할 |
vulnerability-patterns |
security-analyst |
CWE 분류, 언어별 취약 코드 패턴, 안전한 대안 |
refactoring-catalog |
architecture-reviewer, performance-analyst |
코드 스멜→리팩토링 매핑, SOLID 위반, 복잡도 측정 |
1---2name: code-reviewer-23description: 코드 리뷰 자동화 풀 파이프라인. 스타일→보안→성능→아키텍처 4개 영역을 에이전트 팀이 협업하여 체계적으로 리뷰한다. '코드 리뷰해줘', '이 코드 봐줘', '코드 검토', 'PR 리뷰', '코드 품질 분석', '보안 리뷰', '성능 리뷰', '아키텍처 리뷰', '코드 스타일 검사' 등 코드 리뷰 전반에 이 스킬을 사용한다. 특정 영역만 요청하는 경우에도 지원한다. 단, 실제 CI/CD 통합, 자동 수정(auto-fix), Git 커밋/머지 작업은 이 스킬의 범위가 아니다.4---56# Code Reviewer — 코드 리뷰 자동화 파이프라인78코드의 스타일→보안→성능→아키텍처를 에이전트 팀이 체계적으로 리뷰한다.910## 실행 모드1112**에이전트 팀** — 5명이 SendMessage로 직접 통신하며 교차 검증한다.1314## 에이전트 구성1516| 에이전트 | 파일 | 역할 | 타입 |17|---------|------|------|------|18| style-inspector | `.claude/agents/style-inspector.md` | 컨벤션, 포맷팅, 네이밍, 가독성 | general-purpose |19| security-analyst | `.claude/agents/security-analyst.md` | 취약점, 인젝션, 인증, 데이터 노출 | general-purpose |20| performance-analyst | `.claude/agents/performance-analyst.md` | 복잡도, 메모리, 동시성, 쿼리 | general-purpose |21| architecture-reviewer | `.claude/agents/architecture-reviewer.md` | 설계 패턴, SOLID, 의존성, 결합도 | general-purpose |22| review-synthesizer | `.claude/agents/review-synthesizer.md` | 우선순위 종합, 충돌 해결, 최종 판정 | general-purpose |2324## 워크플로우2526### Phase 1: 준비 (오케스트레이터 직접 수행)27281. 사용자 입력에서 추출한다:29 - **대상 코드**: 파일 경로, PR 번호, diff, 디렉토리30 - **언어/프레임워크**: 자동 감지 또는 사용자 지정31 - **리뷰 범위** (선택): 특정 영역만 요청한 경우32 - **컨텍스트** (선택): PR 설명, 관련 이슈, 변경 이유33 - **스타일 가이드** (선택): 팀 고유 컨벤션342. `_workspace/` 디렉토리를 프로젝트 루트에 생성한다353. 입력을 정리하여 `_workspace/00_input.md`에 저장한다364. 대상 코드를 식별하고 리뷰 범위를 결정한다375. 기존 파일이 있으면 `_workspace/`에 복사하고 해당 Phase를 건너뛴다386. 요청 범위에 따라 **실행 모드를 결정**한다3940### Phase 2: 팀 구성 및 실행4142| 순서 | 작업 | 담당 | 의존 | 산출물 |43|------|------|------|------|--------|44| 1a | 스타일 리뷰 | style-inspector | 없음 | `_workspace/01_style_review.md` |45| 1b | 보안 리뷰 | security-analyst | 없음 | `_workspace/02_security_review.md` |46| 1c | 성능 리뷰 | performance-analyst | 없음 | `_workspace/03_performance_review.md` |47| 1d | 아키텍처 리뷰 | architecture-reviewer | 없음 | `_workspace/04_architecture_review.md` |48| 2 | 종합 리뷰 | review-synthesizer | 작업 1a~1d | `_workspace/05_review_summary.md` |4950작업 1a~1d(4개 영역 리뷰)는 **모두 병렬 실행**한다.5152**팀원 간 소통 흐름:**53- style-inspector → security-analyst에게 주석 내 민감 정보 전달, performance-analyst에게 복잡 함수 목록 전달54- security-analyst → performance-analyst에게 보안 조치 성능 영향 전달, architecture-reviewer에게 인증 아키텍처 전달55- performance-analyst → architecture-reviewer에게 구조적 병목 전달56- review-synthesizer는 모든 리뷰를 통합. 영역 간 충돌 발견 시 해당 분석가에게 추가 분석 요청5758### Phase 3: 통합 및 최종 산출물5960종합 보고서를 기반으로 최종 산출물을 정리한다:61621. `_workspace/` 내 모든 리뷰를 확인한다632. 최종 판정(Approve/Request Changes/Reject)을 결정한다643. 최종 요약을 사용자에게 보고한다6566## 작업 규모별 모드6768| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |69|----------------|----------|-------------|70| "코드 리뷰해줘", "전체 리뷰" | **풀 리뷰** | 5명 전원 |71| "보안 리뷰만 해줘" | **보안 모드** | security-analyst + review-synthesizer |72| "성능 분석해줘" | **성능 모드** | performance-analyst + review-synthesizer |73| "아키텍처 리뷰해줘" | **아키텍처 모드** | architecture-reviewer + review-synthesizer |74| "코드 스타일만 봐줘" | **스타일 모드** | style-inspector + review-synthesizer |7576**PR 리뷰**: PR 번호가 제공되면 diff를 추출하여 변경된 코드만 리뷰한다. 전체 파일 컨텍스트도 참조하지만 리뷰 대상은 diff에 집중한다.7778## 데이터 전달 프로토콜7980| 전략 | 방식 | 용도 |81|------|------|------|82| 파일 기반 | `_workspace/` 디렉토리 | 주요 산출물 저장 및 공유 |83| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 추가 분석 요청 |84| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 의존 관계 관리 |8586파일명 컨벤션: `{순번}_{에이전트}_{산출물}.{확장자}`8788## 에러 핸들링8990| 에러 유형 | 전략 |91|----------|------|92| 언어 미식별 | 파일 확장자 + 코드 패턴에서 자동 감지 |93| 대용량 코드 | 변경된 파일 또는 핵심 파일에 집중, 범위를 리뷰 보고서에 명시 |94| 에이전트 실패 | 1회 재시도 → 실패 시 해당 영역 없이 진행, 종합 보고서에 누락 명시 |95| 영역 간 충돌 | review-synthesizer가 트레이드오프 분석 후 판정 |96| 컨텍스트 부족 | PR 설명이나 이슈 번호가 없으면 코드만으로 리뷰, 제한 사항 명시 |9798## 테스트 시나리오99100### 정상 흐름101**프롬프트**: "이 Python Flask 프로젝트를 전체 코드 리뷰해줘" + 코드 파일/디렉토리102**기대 결과**:103- 스타일: PEP 8 기준, 네이밍/포맷팅/가독성 검사, Black/flake8 설정 제안104- 보안: SQL 인젝션, XSS, 하드코딩 시크릿, 의존성 CVE 검사105- 성능: 쿼리 최적화, N+1, 메모리 사용, 캐싱 기회106- 아키텍처: MVC 패턴 준수, SOLID, 의존성 분석107- 종합: 통합 우선순위, 최종 판정, 액션 아이템108109### 기존 파일 활용 흐름110**프롬프트**: "이 PR의 보안만 리뷰해줘" + PR diff111**기대 결과**:112- 보안 모드: security-analyst + review-synthesizer 투입113- diff 중심 리뷰, 전체 파일 컨텍스트 참조114- style-inspector, performance-analyst, architecture-reviewer 건너뜀115116### 에러 흐름117**프롬프트**: "이 코드 봐줘" + 단일 파일 (100줄 미만)118**기대 결과**:119- 소규모 코드 → 아키텍처 리뷰는 함수 분리/모듈 설계 관점으로 축소120- 풀 리뷰 모드로 실행하되, 각 영역이 코드 규모에 맞게 조정121- 종합 보고서에 "단일 파일 리뷰, 아키텍처 평가 제한적" 명시122123## 에이전트별 확장 스킬124125개별 에이전트의 도메인 전문성을 강화하는 확장 스킬:126127| 스킬 | 대상 에이전트 | 역할 |128|------|-------------|------|129| `vulnerability-patterns` | security-analyst | CWE 분류, 언어별 취약 코드 패턴, 안전한 대안 |130| `refactoring-catalog` | architecture-reviewer, performance-analyst | 코드 스멜→리팩토링 매핑, SOLID 위반, 복잡도 측정 |