korean-commit-pr
한국어 커밋 메시지와 PR 설명
변경 내용을 보고 무엇을 왜 바꿨는지 드러나는 한국어 커밋 메시지와 풀 리퀘스트 설명을 써요.
2026년 11월 17일 추가한국어로 씀
까는 법
터미널에 붙여 넣으면 ~/.claude/skills/korean-commit-pr/SKILL.md에 파일 하나가 받아져요. Claude Code를 다시 켜면 스킬 목록에 나타나요.
mkdir -p ~/.claude/skills/korean-commit-pr && curl -fsSL https://beautifulsoup.dev/skill-files/korean-commit-pr/SKILL.md -o ~/.claude/skills/korean-commit-pr/SKILL.md
명령을 쓰기 어렵다면 아래 SKILL.md를 복사하거나 내려받아, 같은 위치에 korean-commit-pr 폴더를 만들고 그 안에 넣어도 돼요. 한 프로젝트에서만 쓰려면 프로젝트 안의 .claude/skills/에 넣어요.
에이전트가 이 스킬을 꺼내는 때
git 커밋 메시지나 풀 리퀘스트 설명을 한국어로 쓸 때 쓴다. 사용자가 "커밋해 줘", "커밋 메시지 써 줘", "PR 올려 줘"라고 할 때, 그리고 프로젝트가 한국어 커밋을 쓸 때 따른다.
SKILL.md 머리말의 설명이에요. 에이전트는 이 설명을 보고 언제 이 스킬을 쓸지 정해요. 이름을 직접 불러 써도 돼요.
SKILL.md
커밋 메시지
- 프로젝트에 정해진 규칙(Conventional Commits 등)이 있으면 먼저 따른다. 최근 커밋 기록을 보고 꼴을 맞춘다.
- 제목은 50자 안팎, 무엇을 했는지 한 줄로: "검색 결과에 태그 이름도 포함", "로그인 실패 시 안내 문구 수정"
- 본문은 왜 바꿨는지와 무엇이 달라지는지를 쓴다. 어떻게 바꿨는지는 코드가 말한다.
- 서로 다른 변경이 섞였으면 커밋을 나누자고 제안한다.
- 비밀 키, 토큰, 개인정보가 변경에 섞이지 않았는지 커밋 전에 확인한다.
PR 설명
순서:
- 요약: 무엇을 왜 바꿨는지 세 줄 안에
- 바꾼 것: 사용자나 다른 개발자에게 보이는 변화 중심
- 확인한 방법: 돌린 테스트와 명령, 결과
- 확인하지 못한 것: 숨기지 않고 적는다
- 리뷰어에게: 특히 봐 줬으면 하는 곳
- 관련 이슈, 화면이 바뀌었으면 전후 화면
피할 것
- "수정", "업데이트", "작업" 같은 뜻 없는 제목
- 확인하지 않은 것을 확인했다고 쓰기
- 영어식 긴 줄표
개발의 다른 스킬
이런 스킬도 있으면 좋겠다 싶으면 알려 주세요