receiving-code-review

개요

receiving-code-review 스킬이 하는 일

receiving-code-review 스킬은 에이전트가 특히 GitHub pull request에서 코드 리뷰 피드백을 받았을 때 어떻게 응답해야 하는지를 위한 명확하고 반복 가능한 패턴을 정의합니다. 이 스킬은 사회적 제스처보다 기술적 평가에 초점을 둡니다.

리뷰어에게 무조건 동의하거나 제안을 곧바로 구현하는 대신, 이 스킬은 에이전트가 다음을 수행하도록 훈련합니다:

• 반응하기 전에 모든 피드백을 먼저 읽기
• 요청된 변경 사항을 재진술하거나 명확히 하기
• 실제 코드베이스와 대조해 피드백을 검증하기
• 해당 저장소에 기술적으로 적합한 제안인지 평가하기
• 아부가 아닌, 근거 있는 기술적 논리를 바탕으로 응답하기
• 이해와 검증을 마친 후에야 변경 사항을 하나씩 구현하기

이 스킬이 필요한 사람

다음에 해당한다면 receiving-code-review 사용을 고려하세요:

• GitHub PR 또는 코드 리뷰 대화에서 AI 어시스턴트와 함께 작업한다
• 어시스턴트가 예스맨이 아니라, 신중한 리뷰어/리뷰이처럼 행동하길 원한다
• 리뷰 코멘트를 해석하고 다음에 무엇을 해야 할지 결정하는 데 도움이 필요하다
• 빠르지만 피상적인 합의보다 변경 사항의 정확성과 안전성을 더 중시한다

특히 다음과 같은 경우에 유용합니다:

• 기능 브랜치와 pull request로 협업하는 개발자
• 리뷰 피드백을 일관되게 처리하고 싶은 테크 리드
• Claude나 기타 LLM을 PR 리뷰 파트너로 실험해 보는 팀

이 스킬이 맞지 않는 경우

이 스킬은 다음과 같은 용도로 설계된 것이 아닙니다:

• 완전히 새로운 기능을 처음부터 생성하는 작업
• 리뷰 문맥 없이 진행하는 대규모 리팩터링
• 예의, 칭찬, 진행 상황 보고와 같은 사회적 커뮤니케이션

코드 생성, 문서 초안 작성, 상위 수준 설계 지원이 주된 목적이라면 다른 스킬과 함께 사용하는 것이 좋습니다. receiving-code-review는 특히 에이전트가 코드 리뷰 피드백을 받고 응답하는 상황에 있을 때에만 사용하세요.

핵심 이점

receiving-code-review를 설치하면 에이전트는 다음과 같이 행동합니다:

• "You're absolutely right!", "Great point!" 같은 보여주기식 대답을 피함
• 가정이 아니라 실제 코드를 근거로 응답함
• 피드백이 불명확할 때 추측 대신 추가 설명을 요청함
• 제안이 기술적으로 틀렸을 경우 정중하게 이의를 제기함
• 오해되었거나 유해한 변경을 구현할 위험을 줄임

이를 통해 code-review, git-workflows, pr-review 프로세스에서 에이전트를 더 신뢰할 수 있게 됩니다.

사용 방법

1. 설치

obra/superpowers 저장소에서 receiving-code-review 스킬을 설치하려면 다음을 실행합니다:

npx skills add https://github.com/obra/superpowers --skill receiving-code-review

이 명령은 스킬 정의(포함: SKILL.md)를 에이전트 스킬 환경으로 가져옵니다. 설치는 이미 npx skills 도구가 준비되어 있다는 전제하에 진행되며, 그렇지 않다면 먼저 사용하는 플랫폼이나 에이전트 호스트 설명에 따라 해당 도구를 설정해야 합니다.

2. 설치 후 확인할 파일

설치가 끝나면 이 스킬의 핵심 파일을 확인하세요:

• skills/receiving-code-review/SKILL.md – 코드 리뷰 피드백을 받을 때의 행동 패턴에 대한 정본 설명

더 넓은 obra/superpowers 저장소에서는 다음과 같은 공통 패턴 파일을 볼 수 있습니다:

• 루트에 있는 README.md, AGENTS.md, metadata.json 등 – 스킬이 어떻게 구성되고 사용되는지에 대한 일반적인 문맥 제공

이 파일들은 receiving-code-review가 더 큰 Claude/에이전트 규칙 집합 안에서 어떤 역할을 하는지 이해하는 데 도움이 되지만, 실제 동작의 핵심은 SKILL.md에 담겨 있습니다.

3. 핵심 응답 워크플로우

이 스킬은 에이전트가 코드 리뷰 피드백(예: GitHub PR 코멘트 스레드)을 받을 때마다 따를 응답 패턴을 정의합니다:

1. READ:     반응하기 전에 모든 피드백을 읽는다
2. UNDERSTAND: 요구사항을 자신의 말로 재진술하거나 질문하여 이해를 확인한다
3. VERIFY:   피드백을 실제 코드베이스와 대조해 검증한다
4. EVALUATE: 해당 저장소에 기술적으로 타당한 제안인지 판단한다
5. RESPOND:  기술적인 수용 여부 또는 근거 있는 이견을 제시한다
6. IMPLEMENT: 변경사항을 한 항목씩 구현하고 각각 테스트한다

실제로는 다음을 의미합니다:

• 에이전트는 제안을 즉시 구현하겠다고 말하지 않습니다.
• 먼저 리뷰어가 원하는 바를 정확히 이해했는지 확인합니다.
• 관련 파일/라인 또는 저장소 상태를 살펴봅니다.
• 그 후에야 제안을 적용할지, 수정할지, 거절할지를 결정합니다.

이 패턴은 속도보다 문맥과 정확성이 중요한 GitHub pull request 리뷰 상황에서 특히 유용합니다.

4. 금지되거나 지양해야 할 응답

이 스킬은 LLM에서 흔하지만 진지한 코드 리뷰 상황에서는 해로운 특정 유형의 응답을 명시적으로 금지합니다:

금지 예시:

• "You're absolutely right!" (상위 CLAUDE 규칙 위반으로 명시된 표현)
• "Great point!", "Excellent feedback!" 등 칭찬만 담긴 응답
• 제안을 아직 검증하지 않았는데도 "Let me implement that now"라고 말하는 것

대신, receiving-code-review를 사용할 때 에이전트는 다음과 같이 행동해야 합니다:

• 기술적 요구사항을 재진술: 예) "중복을 피하기 위해 이 로직을 별도의 함수로 추출하라는 요청으로 이해했습니다."
• 불명확한 부분이 있다면 구체적인 질문을 던짐
• 제안이 틀렸거나 불완전하다고 판단되면 그 이유를 기술적으로 설명함
• 과도한 설명이나 칭찬 대신 실제 변경 작업으로 자연스럽게 이어짐

이렇게 하면 대화의 초점을 아부가 아닌 코드 품질에 맞출 수 있습니다.

5. 불명확하거나 부분적인 피드백 처리

이 스킬은 모호한 피드백에 대해 엄격한 규칙을 정의합니다:

IF 피드백 항목 중 하나라도 불명확하다면:
  STOP – 아직 아무것도 구현하지 않는다
  ASK – 불명확한 항목에 대해 명확히 해달라고 요청한다

그 이유는 개별 리뷰 항목들이 서로 연관되어 있을 수 있기 때문입니다. 일부 항목은 이해했다고 생각해 구현하고, 나머지는 모호한 상태로 남겨두면 다음과 같은 문제가 발생할 수 있습니다:

• 서로 충돌하는 변경
• 깨진 워크플로우
• 리뷰어 의도와 어긋난 동작

예를 들어, 리뷰어가 "1–6까지 고쳐주세요"라고 했는데 에이전트가 1, 2, 3, 6번만 이해했다면, receiving-code-review는 다음과 같이 안내합니다:

• 구현을 잠시 중단
• 4, 5번 항목에 대해 구체적인 확인 질문을 함
• 전체 요구사항을 이해한 후에만 구현을 진행

이러한 동작은 부분적인 이해가 곧바로 깨진 브랜치로 이어질 수 있는 자동화 또는 세미 자동화된 git 워크플로우에서 특히 중요합니다.

6. GitHub / PR 워크플로우에 통합하기

실제 프로젝트에서 receiving-code-review의 효과를 극대화하려면 다음을 수행하세요:

1. 해당 스킬을 사용하는 에이전트에 연결합니다. 용도 예:

   • pull request 리뷰
   • 리뷰 코멘트에 대한 응답 초안 작성
   • 리뷰 피드백 분류 또는 요약 지원

2. 에이전트가 제안을 실제로 검증할 수 있도록 저장소 접근 권한을 보장합니다. 예:

   • 현재 브랜치의 코드
   • 관련 파일과 모듈

3. 다음과 같은 보완 스킬과 함께 사용하면 더 좋은 결과를 얻을 수 있습니다:

   • 합의된 변경사항을 실제로 구현하는 코딩/리팩터링 스킬
   • 영향을 받는 코드를 빠르게 찾는 저장소 탐색 또는 검색 스킬

4. 팀에 이 동작 방식을 공유하세요. 에이전트는:

   • 추측 대신 명확한 설명을 요구하는 질문을 할 수 있고
   • 틀렸거나 위험한 제안에 대해서는 이견을 제시할 수 있으며
   • 포괄적인 칭찬 대신 구체적인 기술적 응답을 우선한다는 점을 알립니다.

이렇게 통합하면 receiving-code-review는 코드 리뷰 대화에서 AI 협업자를 더 엄격하고 신뢰할 수 있게 유지하는 가드레일 역할을 합니다.

7. 이 스킬을 활성화할 시점

다음과 같은 경우에는 receiving-code-review를 사용하세요:

• pull request에 대한 사람 또는 봇의 피드백을 읽을 때
• GitHub diff 뷰의 인라인 코멘트를 검토할 때
• 코드 리뷰 도구에서 리뷰 노트를 처리할 때

반대로 다음과 같은 경우에는 일반적으로 필요하지 않습니다:

• 초기 코드나 기능 초안을 생성할 때
• 설계 문서나 ADR을 작성할 때
• 의존성 업데이트 같은 비리뷰 작업을 수행할 때

이 스킬을 리뷰 문맥에서만 활성화하면 에이전트의 행동을 예측 가능하고 집중된 상태로 유지할 수 있습니다.

자주 묻는 질문 (FAQ)

receiving-code-review는 어떤 문제를 해결하나요?

receiving-code-review 스킬은 코드 리뷰 피드백에 대한 피상적이고 형식적인 AI 응답 문제를 해결합니다. 무조건 동의하고 코드를 바로 바꾸는 대신, 에이전트가 다음을 수행하도록 합니다:

• 모든 피드백을 읽고
• 기존 코드베이스와 대조해 검증하며
• 모호한 요청을 명확히 하고
• 필요할 경우 기술적 근거를 들어 이견을 제시합니다.

이로 인해 GitHub PR 및 기타 코드 리뷰 도구에서 잘못된 구현과 오해가 크게 줄어듭니다.

receiving-code-review는 어떻게 설치하나요?

obra/superpowers 저장소에서 다음 명령으로 스킬을 설치합니다:

npx skills add https://github.com/obra/superpowers --skill receiving-code-review

설치 후에는 receiving-code-review 스킬 디렉터리 아래의 SKILL.md를 확인해 구체적인 행동 규칙을 파악하세요.

이 스킬이 코드 작성 방식도 바꾸나요?

간접적으로는 그렇습니다. receiving-code-review 자체가 코드를 생성하지는 않지만, 다음을 강제함으로써 코드 변경의 방식과 시점에 강하게 영향을 줍니다:

• 구현 전에 검증하기
• 항목별로 변경 및 테스트하기
• 부분적으로 이해한 상태에서의 수정 피하기

리뷰 피드백이 검증된 이후 실제 구현은 코딩 관련 스킬과 함께 사용해 처리하면 됩니다.

receiving-code-review가 사람 리뷰어에게도 이견을 제시할 수 있나요?

가능합니다. 이 스킬은 다음과 같은 경우에는 단호하지만 기술적인 근거를 담은 이견 제기를 명시적으로 허용하고 권장합니다:

• 현재 코드베이스와 맞지 않는 피드백
• 오래된 전제에 기반한 피드백
• 버그나 회귀를 유발할 가능성이 높은 제안

이때 이견은 의견이 아니라, 저장소의 구체적인 사실과 세부 사항을 근거로 해야 합니다.

이 스킬은 GitHub 전용인가요?

이 스킬은 GitHub 스타일의 PR review 워크플로우를 염두에 두고 작성되었지만, 에이전트가 구조화된 코드 리뷰 피드백을 받는 모든 환경에 적용할 수 있습니다. 예를 들어:

• Git 기반 코드 리뷰 도구
• 사내 리뷰 대시보드
• 특정 파일과 라인을 참조하는 코멘트가 오가는 채팅 기반 리뷰 세션

워크플로우가 PR 코멘트 + git 저장소 구조를 닮았다면, receiving-code-review는 좋은 선택입니다.

CLAUDE나 다른 에이전트 규칙과는 어떻게 상호작용하나요?

obra/superpowers 생태계에서 스킬은 상위 수준 규칙(주로 CLAUDE.md 같은 파일)에 레이어 형태로 쌓입니다. receiving-code-review는 "You're absolutely right!" 같은 응답을 금지함으로써 이러한 상위 규칙의 취지를 적극적으로 반영합니다.

기존 에이전트 규칙과 함께 사용하여:

• 더 엄격한 리뷰 행동을 강제하고
• 사회적 제스처에 치우친 최적화를 피하며
• 서로 다른 프로젝트와 저장소 전반에서 일관성을 유지할 수 있습니다.

우리 팀은 좀 더 공손한 응답을 선호하는데, 이 스킬을 써도 되나요?

전문적인 톤을 유지하는 것은 여전히 가능합니다. 다만 이 스킬은 예의 표현보다 명확한 기술 커뮤니케이션을 우선합니다. 더 부드러운 표현이 필요하다면 다음과 같이 할 수 있습니다:

• 별도의 스킬에 톤과 스타일에 대한 가이드를 추가하고
• receiving-code-review는 검증과 엄밀함을 담당하는 뼈대로 유지합니다.

이렇게 역할을 분리하면, 핵심 리뷰 규율을 약화시키지 않고도 문체만 조정할 수 있습니다.

이 스킬이 제대로 작동하는지 어떻게 알 수 있나요?

receiving-code-review가 활성화되어 효과적으로 작동할 때는 다음과 같은 징후를 볼 수 있습니다:

• 에이전트가 리뷰 코멘트에 대해 더 이상 형식적 칭찬만 하는 응답을 하지 않는다
• 행동에 앞서 요구사항을 재진술한다
• 피드백이 불완전하거나 모호할 때 질문을 던진다
• 제안을 수용하거나 이견을 제시할 때 특정 파일, 함수, 라인 등을 구체적으로 참조한다

반대로, 아무 검증 없이 곧바로 "I’ll implement that"과 같은 응답이 반복된다면 스킬 설정을 다시 확인해, 리뷰 문맥에서 이 스킬이 제대로 활성화되어 있는지 점검해야 합니다.