differential-review은(는) 무엇을 하나요?
코드 변경 사항(PR, 커밋, diff)에 대해 보안 중심의 차등 리뷰를 수행합니다. 코드베이스 크기에 따라 분석 깊이를 조정하고, git 기록을 컨텍스트로 사용하며, 블래스트 반경을 계산하고, 테스트 커버리지를 확인한 후, 종합적인 마크다운 보고서를 생성합니다. 보안 퇴행을 자동으로 탐지하고 방지합니다.
주요 기능
- 분석 깊이 조정: 코드베이스 크기에 따라 분석 깊이를 동적으로 조정합니다. 대규모 코드베이스에서는 변경 사항의 핵심 부분에 집중하고, 소규모 코드베이스에서는 전체적인 분석을 수행합니다.
- Git 기록 컨텍스트: git 기록을 활용하여 변경 사항의 역사적 맥락을 파악합니다. 이전 커밋, 관련 이슈, 변경 사항의 빈도 등을 분석하여 보다 정확한 리뷰를 제공합니다.
- 블래스트 반경 계산: 각 변경 사항이 시스템의 다른 부분에 미치는 영향을 계산합니다. 이는 변경 사항이 예기치 않은 부작용을 일으킬 가능성을 평가하는 데 도움을 줍니다.
- 테스트 커버리지 확인: 변경된 코드 영역의 테스트 커버리지를 자동으로 확인합니다. 테스트되지 않은 코드 변경을 식별하고, 추가 테스트가 필요한 부분을 강조합니다.
- 마크다운 보고서 생성: 모든 분석 결과를 읽기 쉬운 마크다운 형식으로 정리하여 보고서를 생성합니다. 이 보고서는 팀 내 리뷰와 협업을 용이하게 합니다.
사용 방법
이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있습니다. 에이전트에게 리뷰하려는 PR 또는 diff를 제공하면 자동으로 분석을 수행하고 결과를 반환합니다.
예시 명령어
# 특정 PR 리뷰
differential-review --pr <PR-번호>
# diff 파일 리뷰
differential-review --diff <diff-파일-경로>
# 최근 커밋 리뷰
differential-review --commit <커밋-해시>
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 AI 에이전트 플랫폼
환경 변수
DIFFERENTIAL_REVIEW_DEPTH: 분석 깊이를 설정합니다. (shallow 또는 deep)
GIT_REPOSITORY_PATH: git 저장소 경로를 지정합니다.
참고 사항
- 이 스킬은 git 저장소에서 실행되어야 합니다.
- 분석 대상 코드는 접근 가능한 git 저장소에 있어야 합니다.
- 대규모 저장소의 경우 분석 시간이 길어질 수 있습니다.