출처

개요

AI 코드 리뷰는 두루뭉술한 제안으로 끝나거나 파일마다 깊이가 들쭉날쭉하기 쉽다. Code Review Skill(awesome-skills)은 AI 리뷰를 구조적이고 일관된 과정으로 바꾸려는 Claude Code 스킬이다. 20개 넘는 언어·프레임워크에 대한 21,000줄 이상의 가이드를 담았지만, 점진적 공개(progressive disclosure)로 필요한 부분만 불러온다.

핵심 포인트

  • 점진적 공개: 코어 스킬(약 220줄)만 항상 로드하고, 언어별 가이드(각 200~1,100줄)는 해당 언어를 리뷰할 때만 부른다. 예: React 리뷰 시 reference/react.md, Go 보안 리뷰 시 go.md와 보안 가이드.
  • 4단계 프로세스: ① 맥락 파악(PR 범위·연결 이슈·의도) → ② 상위 리뷰(아키텍처·성능·테스트 전략) → ③ 라인별 분석(로직·보안·유지보수성·엣지 케이스) → ④ 요약과 결정(승인 상태·액션 아이템).
  • 심각도 라벨 6종: blocking, important, nit, suggestion, learning, praise. 받는 쪽이 우선순위를 바로 구분한다.
  • 기타 원칙: 생태계별 보안 체크리스트(SQL 인젝션·XSS 등), 명령보다 질문·제안 위주의 어조, 린터가 잡을 것과 사람이 볼 것 구분.
  • 지원 범위: React 19/Next.js/TanStack Query v5, Vue 3.5, Angular, Svelte 5, Java/Spring Boot, FastAPI, Django, Go, Rust, NestJS, PHP, Rails, .NET, Kotlin, Swift, C/C++, Zig, Qt 등.
  • 설치·사용: ~/.claude/skills/code-review-skill에 clone 후 “Use code-review-skill to review this PR”. PR 복잡도 분석 스크립트와 코멘트 템플릿 포함, MIT.

왜 중요한가

방대한 도메인 지식을 스킬에 넣으면서도 컨텍스트를 아끼는 점진적 공개 설계의 좋은 예다. 심각도 라벨은 사람·AI 리뷰 모두에 쓸 수 있는 공통 형식이다.

참고 링크

관련 위키

원문 보존 위치

원문 전체는 raw source: 2026-07-22-pytorchkr-topic-11350-code-review-skill-20-claude-code에 source_url 및 HTML 원문과 함께 저장되어 있습니다.