receiving-code-review로 PR 리뷰 지적에 근거를 갖고 대응하기
機械翻訳 / Machine-translated

機械翻訳 / Machine-translated
원문: receiving-code-reviewでPRのレビュー指摘に根拠を持って対応(cccskills)
스킬 페이지: receiving-code-review
이 글의 결론
PR에서 받은 리뷰 지적을 그대로 수정해야 할지 고민될 때가 있습니다.
receiving-code-review를 도입하면, 지적을 코드와 대응 환경에 비추어 확인한 뒤 답변하고 수정할 수 있습니다.
이 글에서는 스킬이 진행하는 확인 절차와 설치 방법, 요청문 예시, 도입 전에 알아두어야 할 주의사항을 정리했습니다.
에이전트는 지적을 바로 구현하지 않습니다.
먼저 코드와 대조하고, 근거가 담긴 답변 초안을 제시합니다.
예를 들어 외부 리뷰에서 오래된 구현의 삭제를 요구받았을 때의 요청문은 다음과 같습니다.
PR 리뷰에서 "레거시 코드는 삭제해 주세요"라는 지적을 받았습니다.
삭제해도 되는지, 코드와 대응 환경에 비추어 확인해 주세요.
에이전트는 지적을 읽고, 요건을 자신의 말로 다시 정리합니다.
그런 다음 빌드 대상 버전이나 사용 중인 API의 요건을 조사하는 흐름입니다.
SKILL.md 예시에서 제시되는 결론은 "빌드 대상은 10.15 이상이고, 이 API는 13 이상이 필요합니다.
하위 호환을 위해 오래된 구현이 필요합니다"라는 것입니다.
이어서 13 미만 지원을 중단할지 여부를 사용자에게 되묻습니다.
답변에는 "말씀하신 대로입니다"와 같은 동조나 감사 인사가 포함되지 않습니다.
올바른 지적이라면 "수정했습니다"라고 변경 사항을 간략히 전달하고, 오류가 있는 지적에는 코드나 테스트를 근거로 반론합니다.
**지적을 맹목적으로 수용하지 않고, 확인한 뒤 수정한다.
이것이 이 스킬의 핵심입니다.
**
이 스킬은 리뷰 지적에 대한 대응을 정해진 6단계로 진행합니다.
판단 기준은 상대방의 기분이 아니라 기술적으로 올바른지 여부입니다.
지적 중에 이해하기 어려운 항목이 하나라도 있으면, 에이전트는 구현을 멈춥니다.
항목들이 서로 관련되어 있을 경우, 일부만 이해하고 진행하면 잘못된 구현이 될 수 있기 때문입니다.
그래서 "1, 2, 3, 6은 이해했습니다.
4와 5는 확인이 필요합니다"와 같이, 이해한 항목과 이해하지 못한 항목을 나누어 전달합니다.
사용자 본인의 지시인지, 외부 리뷰어의 지적인지에 따라 처리 방식이 달라집니다.
차이는 다음과 같습니다.
| 지적의 출처 | 처리 방식 |
|---|---|
| 사용자 본인 | 신뢰하여 처리한다. 이해하면 구현하고, 범위가 모호하면 질문한다 |
| 외부 리뷰어 | 구현 전에 확인한다. 이 코드베이스에서 올바른지, 기존 기능을 망가뜨리지 않는지, 현재 구현의 이유, 모든 환경·버전에서 동작하는지, 리뷰어가 전체 맥락을 파악하고 있는지를 확인한다 |
외부의 제안이 사용자가 이전에 결정한 설계와 충돌하는 경우도 있을 것입니다.
그 경우에는 먼저 사용자와 상의합니다.
"제대로 구현해야 한다"는 제안을 받으면, 먼저 코드베이스를 검색하여 실제 사용처를 찾습니다.
어디서도 호출되지 않는다면, "이 엔드포인트는 호출되지 않고 있습니다.
삭제해도 될까요?"라고 되묻는 흐름입니다.
필요하지 않은 기능은 만들지 않는다는 사고방식(YAGNI)에 따른 확인이라고 할 수 있습니다.
지적이 많을 때는 불명확한 사항을 해소한 뒤 다음 순서로 수정합니다.
수정할 때마다 개별적으로 테스트하고, 마지막에 기존 기능이 망가지지 않았는지(회귀가 없는지)를 확인하는 절차입니다.
한꺼번에 수정한 뒤 한 번에 테스트하는 방식은 흔한 실패 사례로 지양됩니다.
반론한 뒤 자신의 오류를 깨달아도, 긴 사과나 변명은 하지 않습니다.
"확인해 보니 지적대로였습니다.
이유는 ~입니다. 수정하겠습니다"라고 사실을 말하고 작업으로 돌아갑니다.
터미널에서 다음 명령어를 실행해 주세요.
npx skills add에서는 Claude Code나 Codex 등, 설치할 에이전트를 선택할 수 있습니다.
npx skills add https://github.com/obra/superpowers --skill receiving-code-review
에이전트에게 설치를 맡기는 경우, 다음 문장을 그대로 전송해 주세요.
次の Agent Skill をインストールしてください。
https://github.com/obra/superpowers/tree/main/skills/receiving-code-review
まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/receiving-code-review/、Codex なら ~/.agents/skills/receiving-code-review/ に配置してください。
저장 위치는 사용 범위에 따라 다음 두 가지입니다.
| 에이전트 | 모든 프로젝트에서 사용 | 특정 프로젝트에서만 사용 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | 프로젝트의 .claude/skills/ |
| Codex | ~/.agents/skills/ | 프로젝트의 .agents/skills/ |
스킬의 내용은 SKILL.md 파일 하나뿐이며, 스크립트는 포함되지 않습니다.
에이전트의 진행 방식을 결정하는 절차서이므로, 로컬 환경에서 동작합니다.
외부와 통신하는 것은 GitHub에 답변을 게시할 때 gh 명령어를 사용하는 경우뿐입니다.
요청문은 한국어로 작성해도 됩니다.
아래는 목적별 3가지 예시입니다.
이 PR의 리뷰 코멘트를 코드와 대조하여, 타당한 지적과 불명확한 지적으로 분류해 주세요.
지적별로 요건의 재정리와 코드와의 대조 결과가 반환됩니다.
불명확한 항목에 대해서는 무엇을 확인해야 하는지를 질문 형태로 모아서 제시합니다.
이 단계에서는 어떤 수정도 진행하지 않습니다.
리뷰어로부터 "메트릭 집계를 데이터베이스와 날짜 필터, CSV 출력 기능까지 제대로 만들어 주세요"라는 말을 들었습니다.
정말 필요한지 조사해 주세요.
에이전트는 코드베이스를 검색하여 해당 엔드포인트의 호출처를 찾습니다.
호출이 없다면, "어디서도 호출되지 않고 있습니다.
삭제해도 될까요, 아니면 놓친 사용처가 있을까요?"라고 확인을 반환합니다.
합의된 지적을 1건씩 수정하고, 각각 테스트해 주세요.
마지막에 기존 기능에 대한 영향도 확인해 주세요.
수정은 동작이나 보안에 관련된 지적부터 순서대로 진행합니다.
1건 수정할 때마다 테스트를 실시하고, 완료되면 변경 내용을 간략히 보고합니다.
마지막으로 회귀가 없는지 확인하고 작업이 종료됩니다.
무엇을 수정할지의 최종 판단은 리뷰어와 사용자의 합의로 결정해 주세요.
이 스킬은 반론의 근거를 갖추어 주지만, 설계에 관한 판단은 사용자와 상의하는 절차로 되어 있습니다.
로컬에서 확인할 수 없는 지적에 대해서는, "~가 없으면 검증할 수 없습니다.
조사할까요, 물어볼까요, 아니면 진행할까요?"라고 방침을 묻습니다.
GitHub의 행별 코멘트에는 해당 코멘트의 스레드 내에서 답변합니다.
PR 전체에 대한 코멘트로는 게시하지 않습니다.
게시에는 gh api를 사용하므로, gh 명령어를 사용할 수 있는 환경이 전제입니다.
답변문에서는 감사나 동조의 말이 의도적으로 제외되어 있습니다.
팀의 관례상 한마디 덧붙이고 싶다면, 게시 전에 직접 추가해 주세요.
라이선스는 MIT이며, 원문은 영어로 작성되어 있습니다.
**도입 전에 SKILL.md의 내용을 읽고, 절차가 자신의 운영 방식에 맞는지 확인해 주세요.
**
같은 obra/superpowers의 스킬을 조합하면, 리뷰 전후의 작업도 연결할 수 있습니다.
requesting-code-review는 구현 후나 머지 전에 다른 에이전트에게 리뷰를 요청하는 스킬입니다.
반환된 지적을 receiving-code-review로 확인한 뒤 수정하는 흐름을 만들 수 있습니다.
systematic-debugging은 버그나 테스트 실패의 원인을 재현 절차, 로그, 최근 변경 사항으로부터 조사하는 스킬입니다.
수정 후 테스트에서 실패가 발생했을 때의 조사에 적합합니다.
finishing-a-development-branch는 구현 완료 후 모든 테스트를 확인하고, 머지 또는 Pull Request 생성을 선택하여 진행합니다.
리뷰 대응을 마친 뒤의 마무리 작업에 적합합니다.
아니요, 반론이 전제는 아닙니다.
올바른 지적은 그대로 수정하고 변경 사항을 간략히 전달합니다.
반론하는 경우는 기존 기능을 망가뜨리거나, 리뷰어의 맥락이 부족하거나, 사용되지 않는 기능을 추가하는 등 기술적인 이유가 있을 때뿐입니다.
사용자 본인의 지시는 신뢰하여 처리하고, 이해한 뒤 구현합니다.
다만 범위가 모호할 때는 질문이 반환됩니다.
답변 대상은 행별 리뷰 코멘트라면 해당 코멘트의 스레드 내입니다.
PR 전체에 대한 코멘트로는 게시하지 않습니다.
receiving-code-review는 리뷰 지적을 확인, 답변, 수정 및 테스트 순서로 진행하기 위한 스킬입니다.
불명확한 사항은 먼저 모아서 질문하고, 외부의 제안은 코드와 대응 환경에 비추어 확인합니다.
수정은 1건씩 테스트하고, 마지막에 기존 기능에 대한 영향까지 확인하는 것이 특징입니다.
지적을 수정해야 할지 고민하는 경우가 많다면, 먼저 PR 하나로 시험해 보세요.
자세한 내용은 cccskills 페이지를 참고해 주세요.
이 글은 cccskills의 읽을거리 「receiving-code-reviewでPRのレビュー指摘に根拠を持って対応」의 전재입니다.
스킬의 상세 내용과 설치 방법은 cccskills의 receiving-code-review 페이지에 있습니다.