aj-geddes/code-review-analysis

code-review-analysis은(는) 무엇을 하나요?

모범 사례, 보안 검사 및 건설적인 피드백을 포함한 포괄적인 코드 리뷰를 수행합니다. 풀 리퀘스트 리뷰, 코드 품질 분석, 보안 취약점 검사 또는 코드 개선 제안 시 사용하세요.

개요

이 스킬은 AI 에이전트가 체계적인 코드 리뷰를 수행할 수 있도록 설계되었습니다. 리뷰는 다음 영역에 중점을 둡니다:

• 코드 품질: 가독성, 유지보수성, 모범 사례 준수 여부
• 보안: 일반적인 취약점, 안전하지 않은 패턴, 민감 데이터 노출
• 성능: 비효율적인 알고리즘, 불필요한 연산, 메모리 사용
• 문서화: 주석, README, API 문서의 적절성
• 테스트: 커버리지, 엣지 케이스, 테스트 품질
• 일관성: 코딩 스타일, 네이밍 컨벤션, 아키텍처 패턴

사용 방법

다음과 같은 경우에 이 스킬을 활성화하세요:

1. 풀 리퀘스트 또는 코드 변경 사항 검토
2. 기존 코드베이스 품질 감사
3. 특정 기능 또는 모듈 분석
4. 보안 감사 수행
5. 코드 개선 제안 제공

리뷰 프로세스

각 리뷰는 다음 단계를 따릅니다:

1. 컨텍스트 이해: 코드의 목적, 도메인, 기술 스택 파악
2. 변경 사항 분석: 추가/삭제/수정된 라인 검토
3. 영향 평가: 관련 모듈, 종속성, 전반적 시스템에 미치는 영향 평가
4. 피드백 제공: 구체적이고 실행 가능한 제안과 함께 우선순위별 피드백 제공
5. 요약: 주요 발견 사항과 권장 사항을 요약

피드백 형식

피드백은 다음 범주로 제공됩니다:

• 🔴 중요: 반드시 해결해야 할 문제 (보안 취약점, 기능 버그)
• 🟡 경고: 해결을 권장하는 문제 (성능 저하, 모범 사례 위반)
• 🟢 제안: 선택적 개선 사항 (코드 스타일, 문서화)
• ℹ️ 정보: 추가 컨텍스트 또는 질문

예시

# 풀 리퀘스트 리뷰 수행
git diff main...feature-branch | code-review-analysis review

# 전체 코드베이스 분석
code-review-analysis audit ./src

# 특정 파일 검사
code-review-analysis check ./path/to/file.py

지원 플랫폼

• Claude Code
• Cursor
• Codex
• 기타 AI 에이전트 플랫폼

구성

review_rules.json 파일을 통해 리뷰 규칙을 커스터마이즈할 수 있습니다:

{
  "severity_levels": ["critical", "warning", "suggestion", "info"],
  "focus_areas": ["security", "performance", "quality"],
  "max_feedback_items": 20
}

이 스킬은 개방형 협업과 코드 품질 향상을 촉진하기 위해 설계되었습니다.