메뉴
리뷰 전 변경 사항을 사전 분석하여 리뷰에 필요한 핵심 정보를 정리합니다. git-review 실행 전의 사전 분석 단계로, 사용자가 명시적으로 요청한 경우에만 실행합니다(git-review가 자동 호출하지 않음). 리뷰 컨텍스트, review context, 리뷰 준비 시 사용합니다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
이슈 단위로 스펙, 실행 계획, 수행 요약을 관리하는 워크플로우입니다. 이슈 작업, issue, 이슈 시작, 이슈 완료, 워크플로우 복구(--workflow-only), 이어하기, resume, 작업 재개(--resume), 이슈 정리, 작업공간 정리, 정리(--clear), audit 리포트 검토·피드백 후 승인 보정(--response) 시 사용합니다.
현재 스킬 repo의 skill을 선택하여 Claude Code·Agents·Antigravity·Codex·Junie 경로(~/.claude/skills/ 등 5개)에 설치합니다. --all(전체 경로)·--clear(클린 재설치)·--self(self-install 부트스트랩) 옵션을 지원합니다. skill 설치, install skills, 스킬 배포, 스킬 재설치, self-install 시 사용합니다.
이슈 스펙 대비 구현 완료 여부를 독립 감사인 관점에서 검증합니다. 이슈 감사, issue audit, 구현 검증, 크로스체크 시 사용합니다.
대화 중 중요한 맥락(배경, 결정, 미결 사항, 다음 액션)을 `.ai/99_workspace/notes/` 아래 마크다운 파일로 저장합니다. 맥락 저장, context save, 임시 저장, 논의 스냅샷, 작업 메모 시 사용합니다.
PR 제목과 메시지를 정책(Conventional Commits 제목 + 이슈별 비즈니스/테크 관점)에 맞게 작성합니다. PR 작성, PR 메시지·설명 작성, pull request, 풀리퀘스트, PR 올리기 전 정리, 리뷰어용 설명 정리 시 사용합니다. 실제 PR 생성·제출이 아니라 메시지 텍스트 작성용입니다.
멀티 repo 워크스페이스 루트의 로비 `.ai/AI-CONTEXT.md`를 생성하거나 진단·재구성합니다. `ai-workspace`의 자매 스킬로, building 안내판(=lobby) 역할의 lean 라우터를 만듭니다. 로비, lobby, AI-CONTEXT.md, building 인덱스, 워크스페이스 안내판 작업 시 사용합니다.
| name | git-review-context |
| description | 리뷰 전 변경 사항을 사전 분석하여 리뷰에 필요한 핵심 정보를 정리합니다. git-review 실행 전의 사전 분석 단계로, 사용자가 명시적으로 요청한 경우에만 실행합니다(git-review가 자동 호출하지 않음). 리뷰 컨텍스트, review context, 리뷰 준비 시 사용합니다. |
사람(PR 리뷰어 또는 작성자 본인)이 리뷰할 때 병목을 줄이고 생산성을 높이기 위해,
AI가 변경 사항을 사전 분석하여 리뷰에 필요한 핵심 정보를 .ai/99_workspace/temp_review_context.md에 정리합니다.
.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 등)이 자동으로 호출하지 않습니다.
git diff 또는 PR 정보를 통해 변경된 파일 목록과 diff를 수집합니다.
각 파일 그룹을 기준으로 변경 내용을 한눈에 파악할 수 있도록 요약합니다.
.ai/60_codebase/index.md에 내용이 있으면 참고하여 변경 사항과 관련된 기능의 엔트리포인트와 호출 흐름을 빠르게 파악한다.
단, SSoT는 소스코드이므로 색인을 신뢰하지 않고 반드시 실제 코드를 확인한다.
분석 과정에서 색인과 실제 코드가 다른 부분을 발견하면, 결과 기록에 "코드베이스 색인 갱신이 필요해 보입니다 (/code-map)" 의견을 남긴다.
변경 사항에서 외부에서 진입 가능한 엔트리 포인트를 기능 단위로 정리합니다.
엔트리 포인트 유형 예시:
3단계에서 식별한 각 엔트리 포인트를 기준으로 코드 흐름을 추적합니다.
ClassName#methodName).├──, └──)로 호출 계층을 표현합니다.# 설명 주석 형태로 간략히 기재합니다.호출 흐름 ASCII 다이어그램 예시:
OrderController#createOrder
├── OrderService#placeOrder # 주문 생성 트랜잭션 관리
│ ├── InventoryService#reserve # 재고 차감 및 락 획득
│ │ └── InventoryRepository#decreaseStock (DB)
│ └── PaymentService#charge # 결제 요청 및 실패 시 재고 롤백
│ └── PaymentGatewayClient#requestPayment (외부 API)
└── OrderEventPublisher#publish # 주문 완료 이벤트 발행
앞선 분석을 바탕으로 리뷰어가 집중해야 할 항목을 도출합니다.
.ai/30_contract/index.md와 .ai/40_domain/index.md를 훑어 변경이 계약·정책에 영향을 주는지 확인하고, 해당 시 리뷰 포인트 분류에 "계약·정책 영향"을 추가합니다.
리뷰 포인트 분류 예시:
분석이 완료되면 .ai/99_workspace/temp_review_context.md에 아래 구조로 기록합니다.
# 리뷰 컨텍스트
## 변경 요약
<!-- 파일 그룹별 변경 내용과 변경 의도 -->
## 기능별 엔트리 포인트
<!-- 기능명과 해당 엔트리 포인트(파일 경로 + 함수/메서드명) -->
## 호출 흐름
<!-- 엔트리 포인트별 호출 흐름 -->
## 리뷰 포인트
<!-- 분류별 리뷰 집중 항목 -->
기록 완료 후 사용자에게 파일 위치를 안내합니다.
이후 git-review skill로 이어서 리뷰를 진행할지는 사용자의 선택에 따릅니다.