pr-review-processor-agent

An agent that automatically reviews and applies AI code reviews posted on PRs.

항목	내용
Model	sonnet

/pr-review-processor — AI 코드 리뷰 자동 반영 도우미#

한마디로#

PR(코드 변경 제안서)에 AI 리뷰어(Gemini, Claude, Copilot 등)가 남긴 지적 사항을 사람 대신 읽고, 맞는 지적은 코드에 바로 고쳐 반영하고, 틀린 지적은 걸러서 규칙으로 정리해 두는 자동 비서입니다. 마치 여러 검토 의견을 받아 "이건 반영, 저건 반려"를 알아서 처리해 주는 편집 담당자와 같아요.

누가·언제 쓰나요#

PR에 AI 리뷰 코멘트가 잔뜩 달려서 하나하나 직접 확인하고 고치기 번거로울 때
새 코드 변경을 올린 뒤, AI 리뷰 지적들을 빠르게 정리하고 반영하고 싶을 때

무엇을 해주나요#

AI 리뷰어들이 남긴 코멘트를 모아 타당한 지적은 코드에 직접 반영하고, 변경을 커밋·푸시까지 처리합니다.
타당하지 않은 지적(프로젝트 규칙·아키텍처와 충돌하는 경우)은 반려하고, 그 패턴을 CLAUDE.md 규칙 파일에 추가해 같은 지적이 반복되지 않도록 합니다.
마지막에 반영된 리뷰 / 반려된 리뷰 / CLAUDE.md 업데이트 내역을 표로 정리해 보여 줍니다.

어떻게 쓰나요#

# 특정 PR(예: 1639번)의 리뷰를 처리
/pr-review-processor 1639

# 현재 브랜치에 열려 있는 PR의 리뷰를 처리
/pr-review-processor

PR 번호를 적으면 그 PR을, 생략하면 지금 작업 중인 브랜치의 열린 PR을 자동으로 찾아 처리합니다.

안에서 무슨 일이 벌어지나요#

리뷰 수집 — GitHub에서 해당 PR에 달린 리뷰 코멘트를 가져옵니다.
AI 리뷰어만 추리기 — Gemini, Claude, Copilot 등 AI가 남긴 리뷰만 골라냅니다.
하나씩 판단 — 타당한 지적이면 코드를 고치고, 타당하지 않으면 CLAUDE.md에 규칙을 추가합니다.
- 반영하는 경우: 중복 제거, 검증(null/빈 값) 추가, 성능 최적화, 보안 취약점 수정, 접근성·사용성 개선, 타입 안전성 강화 등
- 반려하는 경우: 프로젝트 lint 규칙·아키텍처 패턴·최신 Dart/Flutter 관례·CLAUDE.md 규칙과 충돌하는 지적
변경 저장 — 고친 내용이 품질 검사(포맷·린트·DCM 0건)를 통과한 뒤에만 커밋하고 푸시합니다.
결과 요약 출력 — 처리 결과를 한눈에 볼 수 있게 정리해 보여 줍니다.

⚙️ 상세 옵션·실행 명세 (개발자 / AI 에이전트용)

Role#

Review Collection: Query PR comments via GitHub API
Review Analysis: Determine validity and classify priorities
Code Modification: Apply valid reviews
Rule Update: Add invalid review patterns to CLAUDE.md

Execution Flow#

┌─────────────────────────────────────────────────────────────┐
│  PR Review Processor Flow                                   │
├─────────────────────────────────────────────────────────────┤
│  1. Query PR review comments via gh api                     │
│  2. Filter AI reviewers (gemini, claude, copilot)           │
│  3. Analyze each review:                                    │
│     - Valid → modify code                                   │
│     - Invalid → add rule to CLAUDE.md                       │
│  4. Per-Push Verification Gate (required before push):      │
│     melos run format → dart fix --apply →                   │
│     melos run analyze (0 issues) →                          │
│     melos run dcm:analyze (0 error issues)                  │
│     → gate failure = push blocked (fix first)               │
│  5. Commit and push changes                                 │
│  6. Output processing result summary                        │
└─────────────────────────────────────────────────────────────┘

Review Validity Criteria#

✅ Valid Reviews (Apply)#

Code duplication removal (DRY principle)
Adding validation checks (null/empty checks)
Performance optimization (removing unnecessary computation)
Security vulnerability fixes
Accessibility improvements
UX improvements (user experience)
Type safety enhancement

❌ Invalid Reviews (Reject + Add Rule)#

Conflicts with project lint rules
Inconsistent with existing architecture patterns
Conflicts with latest Dart/Flutter conventions
Violates rules specified in CLAUDE.md

Usage Examples#

# Process specific PR review
/pr-review-processor 1639

# Process review for current branch ' s open PR
/pr-review-processor

Output Format#

## PR #1639 Code Review Processing Result

### ✅ Applied Reviews (3 items)
| File | Line | Content | Action |
|------|------|---------|--------|
| file.dart | 45 | Add validation | Code modified |

### ❌ Rejected Reviews (1 item)
| File | Line | Content | Reason |
|------|------|---------|--------|
| file.dart | 10 | ... | Project convention conflict |

### 📝 CLAUDE.md Updated
- Added rule: ...

MCP Tool Usage#

gh api - Query GitHub PR comments
Read - Read files
Edit - Modify code
Bash - Git operations