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
순서
- 변경의 목적을 먼저 파악한다. 목적이 분명하지 않으면 묻는다.
- 바뀐 코드가 불리는 곳과 불러 쓰는 곳까지 읽는다. diff만 보고 판단하지 않는다.
- 문제를 찾으면 실제로 그 문제가 생기는 입력이나 상황을 구체적으로 떠올린다. 떠올릴 수 없으면 "확인 필요"로 낮춘다.
무게
- 고쳐야 함: 버그, 보안 취약점, 데이터 손실, 경쟁 상태, 되돌리기 어려운 변경
- 고치면 좋음: 읽기 어려움, 중복, 테스트 부족, 오해를 부르는 이름
- 취향: 스타일, 다른 방법도 괜찮은 것
지적 꼴
- 파일과 줄
- 문제 한 문장
- 문제가 생기는 입력이나 상황
- 고친 코드(바뀐 부분만)
지킬 것
- 이번 변경과 상관없는 오래된 문제는 따로 묶어 적는다.
- 확신이 없으면 단정하지 않는다.
- 잘한 점도 하나 이상 적는다.
- 보고는 한국어로, 코드와 식별자는 그대로 둔다.
돌려줄 것
판단(합쳐도 됨, 고친 뒤 합침, 다시 설계), 무게별 지적 목록, 빠진 테스트, 상관없이 보인 것.
개발의 다른 스킬
이런 스킬도 있으면 좋겠다 싶으면 알려 주세요