---
name: review-feedback
description: "코드리뷰 피드백 분석 및 반영 자동화"
category: workflow
complexity: standard
mcp-servers: [sequential]
personas: [developer, qa-specialist]
---

# /sc:review-feedback - 코드리뷰 피드백 반영

> **Context Framework Note**: 이 명령어는 코드리뷰에서 받은 피드백을 분석하고 순차적으로 반영하는 워크플로우를 제공합니다.

## Triggers
- PR 리뷰 코멘트 반영 요청
- 코드리뷰 피드백 텍스트 처리
- 리뷰 코멘트 일괄 반영 필요

## Usage
```
/sc:review-feedback [--pr <number>] [--commit] [--interactive]
```

**Arguments:**
- `--pr <number>`: GitHub PR 번호 (PR 코멘트 자동 수집)
- `--commit`: 반영 후 자동 커밋 (기본값: false)
- `--interactive`: 각 피드백 반영 전 확인 요청

**Examples:**
```
/sc:review-feedback --pr 123 --commit
/sc:review-feedback "변수명 camelCase로 변경, 불필요한 import 제거" --commit
/sc:review-feedback --pr 456 --interactive
```

## Behavioral Flow

### Phase 1: 피드백 수집
1. **PR 코멘트 수집** (--pr 옵션 사용 시)
   - `gh pr view <number> --comments` 로 PR 코멘트 수집
   - `gh api repos/{owner}/{repo}/pulls/{number}/comments` 로 인라인 코멘트 수집
   - 리뷰어별, 파일별로 피드백 분류

2. **텍스트 피드백 수집** (직접 입력 시)
   - 사용자가 입력한 피드백 텍스트 파싱
   - 개행 또는 번호로 구분된 항목 분리

### Phase 2: 피드백 분석
1. **피드백 분류**
   - 코드 변경 필요 (수정, 추가, 삭제)
   - 스타일/포맷팅 개선
   - 로직 변경
   - 질문/논의 (반영 불필요)

2. **우선순위 결정**
   - Critical: 버그, 보안 이슈
   - High: 로직 오류, 성능 문제
   - Medium: 코드 스타일, 가독성
   - Low: 선택적 개선사항

3. **영향 파일 식별**
   - PR 코멘트의 경우 파일 경로 자동 추출
   - 텍스트 입력의 경우 코드베이스 검색으로 관련 파일 식별

### Phase 3: 피드백 반영
1. **TodoWrite로 작업 목록 생성**
   - 각 피드백 항목을 개별 태스크로 등록
   - 우선순위 순으로 정렬

2. **순차적 반영**
   - 각 피드백 항목에 대해:
     a. 관련 파일 읽기
     b. 필요한 수정 적용
     c. 태스크 완료 처리
   - `--interactive` 모드: 각 변경 전 사용자 확인

3. **변경사항 검증**
   - 수정된 파일 문법 검사
   - 기존 기능 영향도 확인

### Phase 4: 완료 처리
1. **자동 커밋** (--commit 옵션)
   - 변경사항 스테이징
   - 커밋 메시지 생성:
     ```
     refactor: 코드리뷰 피드백 반영

     - [피드백 1 요약]
     - [피드백 2 요약]
     ...

     Co-Authored-By: Claude <noreply@anthropic.com>
     ```

2. **결과 요약**
   - 반영된 피드백 목록
   - 스킵된 항목 (질문/논의 등)
   - 추가 검토 필요 항목

## MCP Integration
- **Sequential MCP**: 복잡한 피드백 분석 및 다단계 반영 계획 수립

## Tool Coordination
- **Bash**: `gh` CLI로 PR 코멘트 수집
- **Read/Grep/Glob**: 관련 코드 분석 및 파일 검색
- **Edit/MultiEdit**: 피드백 반영을 위한 코드 수정
- **TodoWrite**: 피드백 항목별 진행 상황 추적

## Key Patterns

### PR 코멘트 수집 패턴
```bash
# PR 일반 코멘트
gh pr view <number> --comments --json comments

# 인라인 리뷰 코멘트
gh api repos/{owner}/{repo}/pulls/{number}/comments

# 리뷰 요약
gh pr view <number> --json reviews
```

### 피드백 분류 패턴
- `// TODO:`, `FIXME:` 포함 → 코드 변경 필요
- `nit:`, `minor:` 포함 → Low 우선순위
- `bug`, `critical`, `security` 포함 → Critical 우선순위
- `?`, `왜`, `이유가` 포함 → 질문/논의 (반영 불필요)

### 커밋 메시지 패턴
```
refactor: 코드리뷰 피드백 반영 (#PR번호)

Changes:
- 변수명 camelCase로 통일
- 불필요한 import 제거
- 에러 핸들링 추가

Reviewed-by: @reviewer-username
Co-Authored-By: Claude <noreply@anthropic.com>
```

## Examples

### PR 코멘트 반영
```
/sc:review-feedback --pr 123 --commit
# 1. PR #123의 모든 리뷰 코멘트 수집
# 2. 피드백 분석 및 분류
# 3. TodoWrite로 작업 목록 생성
# 4. 순차적으로 피드백 반영
# 5. 자동 커밋 생성
```

### 텍스트 피드백 반영
```
/sc:review-feedback "1. UserViewModel에서 불필요한 import 제거
2. fetchData 함수 async/await로 변경
3. 에러 메시지 한글화" --commit

# 입력된 3개 피드백 항목을 순차적으로 반영
```

### 대화형 모드
```
/sc:review-feedback --pr 456 --interactive
# 각 피드백 반영 전 사용자에게 확인 요청
# "이 변경사항을 적용할까요? (Y/n)"
```

## Boundaries

**Will:**
- PR 코멘트와 텍스트 피드백 모두 처리
- 피드백 우선순위 분류 및 순차 반영
- 자동 커밋 메시지 생성
- 반영 결과 요약 제공

**Will Not:**
- 질문/논의 형태의 코멘트 자동 반영 (목록에만 표시)
- 대규모 아키텍처 변경 자동 적용
- 테스트 없이 Critical 피드백 반영
- 기존 기능 손상 가능성 있는 변경 무조건 적용