code-review

code-review 스킬 개요

code-review 스킬은 커밋과 배포 전에 코드 변경사항을 반드시 검토하는 워크플로입니다. 변경된 내용을 대충 “괜찮아 보인다” 수준으로 넘기지 않고, 반복 가능한 /code-review 단계로 정리된 리뷰를 받고 싶은 개발자와 팀에게 가장 유용합니다.

code-review 스킬의 강점은 엔진 선택 방식에 있습니다. 변경의 규모, 위험도, 복잡도에 따라 Claude, OpenAI Codex, Google Gemini 또는 멀티 엔진 워크플로로 리뷰를 보낼 수 있습니다. 그래서 리뷰 속도보다 품질이 더 중요한 상황, 특히 병합 전 점검, 릴리스 후보, 고위험 리팩터링에 더 잘 맞습니다.

이건 단순한 체크리스트가 아닙니다. code-review 스킬은 이미 변경된 파일, diff, 또는 명확한 리뷰 대상이 있는 시점에 호출하도록 설계되어 있어, 변경을 차단할지 승인할지 판단할 수 있을 만큼 실행 가능한 피드백을 만들어 냅니다.

code-review 스킬을 설치해야 하는 사람

AI 보조 또는 도구 보조 개발 워크플로에 일관된 리뷰 게이트를 두고 싶다면 code-review 스킬을 설치하는 것이 좋습니다. 특히 혼자 일하는 개발자, 소규모 팀, 그리고 코드를 배포하기 전에 예측 가능한 리뷰 단계가 필요한 에이전트에게 적합합니다.

이미 코드 리뷰가 필요하지만 실행 방식이 그때그때 달라진다면, 이 스킬은 운영 패턴을 더 선명하게 만들어 줍니다. 반대로 조각 코드에 대해 가끔 스타일 피드백만 받고 싶다면, 일반 프롬프트로도 충분한 경우가 많습니다.

code-review 스킬이 해결하는 문제

이 스킬이 맡는 핵심 일은 리뷰의 모호함을 줄이는 것입니다. “이 코드 리뷰해줘”라고만 묻고 막연한 통과 답변을 받는 대신, code-review 스킬은 엔진 선택, 범위, 기대 수준을 분명하게 정해 더 실제적인 문제를 잡아내기 쉽게 만듭니다.

특히 다음이 필요할 때 의미가 큽니다:

• 커밋 전 리뷰 게이트
• 배포 안전성 점검
• 큰 변경 이후의 2차 리뷰
• 정확성, 유지보수성, 위험도를 함께 보는 넓은 점검

code-review 스킬이 돋보이는 이유

code-review 스킬은 의사결정 중심입니다. 가장 실용적인 차별점은 하나의 모델이나 분석 스타일에 묶이지 않고 리뷰 엔진을 선택할 수 있다는 점입니다.

덕분에 이런 식의 유용한 트레이드오프를 가져갈 수 있습니다:

• 로컬 맥락과 편의성이 필요하면 Claude
• 코드 중심 리뷰 워크플로가 필요하면 Codex
• 더 긴 컨텍스트 창이 필요하면 Gemini
• 위험한 변경을 더 확실하게 검증하고 싶으면 여러 엔진을 함께 사용

code-review 스킬 사용 방법

code-review 스킬 설치와 실행

사용 중인 환경에 맞는 저장소의 스킬 설치 흐름을 먼저 따르고, 검토할 코드가 준비되면 /code-review를 호출하세요. 이 스킬은 사용자가 직접 호출하는 방식이므로, 더 큰 assistant 프롬프트 안에 숨어 있는 것이 아니라 워크플로의 한 단계로 바로 쓰도록 되어 있습니다.

저장소 일부에 allowed-tools: [Read, Glob, Grep, Bash]가 보인다면, 이 스킬이 단순히 붙여넣은 코드 조각만 읽는 것이 아니라 파일과 주변 맥락까지 살펴보도록 의도되었다는 뜻입니다.

리뷰 가능한 입력을 정확히 주기

code-review 스킬은 정확한 리뷰 대상과 리뷰 이유를 함께 줄 때 가장 잘 작동합니다. 좋은 입력에는 보통 다음이 들어갑니다:

• 브랜치, PR, 또는 커밋 범위
• 변경된 파일
• 변경 유형: 버그 수정, 리팩터링, 기능 추가, 의존성 업데이트
• 위험 수준: 낮음, 보통, 높음
• 리뷰 초점: 정확성, 보안, 테스트, API 동작, 성능

약한 프롬프트는: “코드 리뷰해줘.”
더 강한 프롬프트는: “src/login.ts와 src/session.ts의 인증 리팩터링에 /code-review를 실행해 주세요. main에 병합하기 전에 회귀, 엣지 케이스, 테스트 공백을 중심으로 봐 주세요.”

먼저 올바른 파일부터 읽기

먼저 SKILL.md를 확인하세요. 워크플로와 엔진 선택 방식이 거기에 정의되어 있습니다. 그다음에는 환경에서 이 스킬의 동작 방식을 좌우하는 저장소 지침을 살펴보세요. README.md, AGENTS.md, metadata.json, 그리고 존재한다면 보조 폴더도 포함됩니다.

이 저장소에서는 핵심 안내가 SKILL.md에 있는 것으로 보이므로, 설치 판단은 비교적 간단합니다. 리뷰 워크플로가 필요하다면 그 파일이 사실상 기준 문서입니다.

엔진 선택을 의도적으로 사용하기

code-review 스킬은 습관이 아니라 변경 내용에 따라 리뷰 엔진을 고를 때 가장 강력합니다. 예를 들면:

• 빠르고 통합된 리뷰가 필요하면 기본 엔진 사용
• 코드 특화 분석이 필요하면 Codex 사용
• 긴 컨텍스트가 병목이면 Gemini 사용
• 위험한 변경에서 더 높은 확신이 필요하면 여러 엔진 사용

어떤 이유로 그 엔진을 쓰는지 명시하지 않으면 리뷰가 지나치게 일반적이 될 수 있습니다. 깊이, 범위, 컨텍스트 크기 중 무엇이 가장 중요한지 스킬에 분명히 알려 주세요.

code-review 스킬 FAQ

code-review는 일반 프롬프트보다 더 나은가요?

반복 가능한 리뷰 워크플로가 필요하다면 그렇습니다. 일반 프롬프트도 코드를 검토할 수는 있지만, code-review 스킬은 구조화된 진입점, 엔진 선택, 그리고 더 분명한 커밋 전·배포 전 사용 시나리오를 제공합니다.

code-review 스킬은 초보자도 쓰기 쉬운가요?

검토할 파일이나 변경 집합을 식별할 수 있다면 대체로 그렇습니다. 이미 무엇이 바뀌었고 무엇을 확인하고 싶은지 알고 있을 때 더 쉽게 쓸 수 있습니다. 반대로 diff도, 맥락도, 구체적인 질문도 없다면 유용성이 떨어집니다.

언제 code-review를 쓰지 말아야 하나요?

작은 코드 조각을 빠르게 설명받고 싶을 때나, 아직 아이디어를 탐색 중이라 공식적인 리뷰 단계가 부담스러울 때는 쓰지 않는 편이 좋습니다. 코드가 아닌 콘텐츠에는 가장 잘 맞지 않는데, 실제 코드 변경을 살피는 데서 이 스킬의 가치가 나오기 때문입니다.

code-review는 에이전트 워크플로에 잘 맞나요?

네. code-review 스킬은 커밋과 배포 전에 안전장치처럼 호출할 수 있어 에이전트 워크플로에 잘 맞습니다. 같은 세션에서 assistant가 코드를 생성하고 그다음 검증까지 해야 할 때 특히 유용합니다.

code-review 스킬 개선 방법

리뷰 대상을 더 좁게 잡기

품질이 가장 크게 좋아지는 지점은 모호성을 줄이는 것입니다. 저장소 전체 리뷰를 요청하기보다 커밋, diff, 폴더, 기능 경계 단위로 범위를 좁히세요. code-review 스킬은 무엇이 바뀌었는지, 그리고 그 변경에서 “좋은 결과”가 무엇인지 알수록 더 잘 작동합니다.

어떤 위험을 중요하게 보는지 말하기

가장 좋은 code-review 결과는 우선순위가 분명할 때 나옵니다. 논리 버그, 회귀, 보안 문제, 테스트 커버리지 공백, API 깨짐, 유지보수성 문제 중 무엇을 찾고 싶은지 명시하세요. 아무 말도 하지 않으면 리뷰가 너무 넓게 퍼질 수 있습니다.

코멘트만이 아니라 판단을 요청하기

목표가 배포 게이트라면, code-review 스킬에 발견 사항을 심각도별로 분류하고 변경이 병합 가능한지 판단해 달라고 요청하세요. 이렇게 해야 느슨한 관찰 목록보다 훨씬 쓸모 있는 결과가 나옵니다.

첫 번째 검토 뒤에는 다시 돌리기

첫 리뷰에서 문제가 발견되면 수정 내용을 반영해 업데이트된 diff에 대해 두 번째 /code-review를 요청하세요. 이 스킬의 가치는 리뷰, 수정, 재검토의 루프에서 가장 크게 살아납니다. 그렇게 해야 code-review를 일회성 프롬프트가 아니라 신뢰할 수 있는 릴리스 습관으로 바꿀 수 있습니다.