| name | git-review-context |
| description | 리뷰 전 변경 사항을 사전 분석하여 리뷰에 필요한 핵심 정보를 정리합니다. git-review 실행 전의 사전 분석 단계로, 사용자가 명시적으로 요청한 경우에만 실행합니다(git-review가 자동 호출하지 않음). 리뷰 컨텍스트, review context, 리뷰 준비 시 사용합니다. |
개요
사람(PR 리뷰어 또는 작성자 본인)이 리뷰할 때 병목을 줄이고 생산성을 높이기 위해,
AI가 변경 사항을 사전 분석하여 리뷰에 필요한 핵심 정보를 .ai/99_workspace/temp_review_context.md에 정리합니다.
관련 skill
- git-review (권장): 컨텍스트 빌드 후 이어서 리뷰를 진행할 수 있습니다.
- ai-workspace (권장):
.ai/99_workspace/ 경로에 결과를 기록합니다.
구조가 없으면 필요한 디렉토리를 직접 생성합니다.
참조 문서
- 공통 규칙:
.ai/10_rules/context-loading.md — 있으면 따르며, 이미 적재되어 있으면 재로딩하지 않습니다.
- 스킬 고유 추가 참조:
.ai/60_codebase/index.md — 호출 흐름 파악.ai/30_contract/index.md, .ai/40_domain/index.md — 리뷰 포인트 도출 (계약·정책 영향 확인)
실행 조건
사용자가 명시적으로 요청한 경우에만 실행합니다. 다른 skill(git-review 등)이 자동으로 호출하지 않습니다.
분석 절차
1단계: 변경 사항 수집
git diff 또는 PR 정보를 통해 변경된 파일 목록과 diff를 수집합니다.
- 변경된 파일 수, 추가/삭제 라인 수를 파악합니다.
- 파일을 기능 단위(도메인, 레이어, 모듈 등)로 그룹화합니다.
2단계: 변경 요약 작성
각 파일 그룹을 기준으로 변경 내용을 한눈에 파악할 수 있도록 요약합니다.
- 무엇이 추가·수정·삭제되었는지 서술합니다.
- 변경 의도(왜 변경했는가)를 코드와 커밋 메시지를 통해 추정합니다.
3단계: 코드베이스 색인 참조
.ai/60_codebase/index.md에 내용이 있으면 참고하여 변경 사항과 관련된 기능의 엔트리포인트와 호출 흐름을 빠르게 파악한다.
단, SSoT는 소스코드이므로 색인을 신뢰하지 않고 반드시 실제 코드를 확인한다.
분석 과정에서 색인과 실제 코드가 다른 부분을 발견하면, 결과 기록에 "코드베이스 색인 갱신이 필요해 보입니다 (/code-map)" 의견을 남긴다.
4단계: 기능별 엔트리 포인트 식별
변경 사항에서 외부에서 진입 가능한 엔트리 포인트를 기능 단위로 정리합니다.
엔트리 포인트 유형 예시:
- API 엔드포인트 (REST, GraphQL 등)
- 이벤트 핸들러 / 메시지 컨슈머
- CLI 커맨드
- UI 컴포넌트 / 페이지
- 공개 함수·클래스·모듈
5단계: 호출 흐름 분석
3단계에서 식별한 각 엔트리 포인트를 기준으로 코드 흐름을 추적합니다.
- 엔트리 포인트 → 핵심 로직 → 외부 의존성(DB, 외부 API 등) 순서로 흐름을 정리합니다.
- 변경된 파일이 흐름의 어느 지점에 위치하는지 명시합니다.
- 흐름이 복잡한 경우 의사코드 또는 단계별 목록 형태로 표현합니다.
- 호출 흐름은 디렉토리 트리 형태의 ASCII 다이어그램으로 시각화하여 가시성을 높입니다.
- 각 노드에 클래스명과 메서드명을 명시합니다(예:
ClassName#methodName).
- 들여쓰기와 트리 기호(
├──, └──)로 호출 계층을 표현합니다.
- 핵심 로직은 노드 옆에
# 설명 주석 형태로 간략히 기재합니다.
호출 흐름 ASCII 다이어그램 예시:
OrderController#createOrder
├── OrderService#placeOrder # 주문 생성 트랜잭션 관리
│ ├── InventoryService#reserve # 재고 차감 및 락 획득
│ │ └── InventoryRepository#decreaseStock (DB)
│ └── PaymentService#charge # 결제 요청 및 실패 시 재고 롤백
│ └── PaymentGatewayClient#requestPayment (외부 API)
└── OrderEventPublisher#publish # 주문 완료 이벤트 발행
6단계: 리뷰 포인트 도출
앞선 분석을 바탕으로 리뷰어가 집중해야 할 항목을 도출합니다.
.ai/30_contract/index.md와 .ai/40_domain/index.md를 훑어 변경이 계약·정책에 영향을 주는지 확인하고, 해당 시 리뷰 포인트 분류에 "계약·정책 영향"을 추가합니다.
리뷰 포인트 분류 예시:
- 로직 검증: 비즈니스 규칙이 올바르게 구현되었는가
- 경계 조건: 예외·에러·엣지 케이스 처리가 충분한가
- 의존성 영향: 변경이 다른 모듈·서비스에 미치는 영향
- 테스트 커버리지: 변경된 로직에 대한 테스트가 존재하는가
- 기타: 성능, 보안, 코드 가독성 등 특이 사항
결과 기록
분석이 완료되면 .ai/99_workspace/temp_review_context.md에 아래 구조로 기록합니다.
# 리뷰 컨텍스트
## 변경 요약
<!-- 파일 그룹별 변경 내용과 변경 의도 -->
## 기능별 엔트리 포인트
<!-- 기능명과 해당 엔트리 포인트(파일 경로 + 함수/메서드명) -->
## 호출 흐름
<!-- 엔트리 포인트별 호출 흐름 -->
## 리뷰 포인트
<!-- 분류별 리뷰 집중 항목 -->
기록 완료 후 사용자에게 파일 위치를 안내합니다.
이후 git-review skill로 이어서 리뷰를 진행할지는 사용자의 선택에 따릅니다.
