code-review-ko

심각도 순 코드 리뷰, 한국어 보고

코드를 버그, 보안, 데이터 손실부터 취향 문제까지 무게별로 나눠 검토하고 한국어로 보고해요.

2026년 11월 17일 추가한국어로 씀

까는 법

터미널에 붙여 넣으면 ~/.claude/skills/code-review-ko/SKILL.md에 파일 하나가 받아져요. Claude Code를 다시 켜면 스킬 목록에 나타나요.

mkdir -p ~/.claude/skills/code-review-ko && curl -fsSL https://beautifulsoup.dev/skill-files/code-review-ko/SKILL.md -o ~/.claude/skills/code-review-ko/SKILL.md

명령을 쓰기 어렵다면 아래 SKILL.md를 복사하거나 내려받아, 같은 위치에 code-review-ko 폴더를 만들고 그 안에 넣어도 돼요. 한 프로젝트에서만 쓰려면 프로젝트 안의 .claude/skills/에 넣어요.

에이전트가 이 스킬을 꺼내는 때

코드, diff, 풀 리퀘스트를 검토할 때 쓴다. 사용자가 "코드 리뷰", "이 코드 봐 줘", "합쳐도 돼?"라고 할 때 쓴다.

SKILL.md 머리말의 설명이에요. 에이전트는 이 설명을 보고 언제 이 스킬을 쓸지 정해요. 이름을 직접 불러 써도 돼요.

SKILL.md

내려받기

순서

  1. 변경의 목적을 먼저 파악한다. 목적이 분명하지 않으면 묻는다.
  2. 바뀐 코드가 불리는 곳과 불러 쓰는 곳까지 읽는다. diff만 보고 판단하지 않는다.
  3. 문제를 찾으면 실제로 그 문제가 생기는 입력이나 상황을 구체적으로 떠올린다. 떠올릴 수 없으면 "확인 필요"로 낮춘다.

무게

  • 고쳐야 함: 버그, 보안 취약점, 데이터 손실, 경쟁 상태, 되돌리기 어려운 변경
  • 고치면 좋음: 읽기 어려움, 중복, 테스트 부족, 오해를 부르는 이름
  • 취향: 스타일, 다른 방법도 괜찮은 것

지적 꼴

  • 파일과 줄
  • 문제 한 문장
  • 문제가 생기는 입력이나 상황
  • 고친 코드(바뀐 부분만)

지킬 것

  • 이번 변경과 상관없는 오래된 문제는 따로 묶어 적는다.
  • 확신이 없으면 단정하지 않는다.
  • 잘한 점도 하나 이상 적는다.
  • 보고는 한국어로, 코드와 식별자는 그대로 둔다.

돌려줄 것

판단(합쳐도 됨, 고친 뒤 합침, 다시 설계), 무게별 지적 목록, 빠진 테스트, 상관없이 보인 것.

개발의 다른 스킬

이런 스킬도 있으면 좋겠다 싶으면 알려 주세요

기술 라이브러리

혼자 공부한 것을 정리해 두는 개발자의 서재예요. 예제는 직접 돌려 보고 씁니다.

© 2026 기술 라이브러리