bug-report-ko
버그 재현과 보고서
버그를 재현 단계, 기대와 실제, 환경, 원인 후보로 정리해서 누구든 이어받을 수 있는 보고서로 만들어요.
2026년 11월 17일 추가한국어로 씀
까는 법
터미널에 붙여 넣으면 ~/.claude/skills/bug-report-ko/SKILL.md에 파일 하나가 받아져요. Claude Code를 다시 켜면 스킬 목록에 나타나요.
mkdir -p ~/.claude/skills/bug-report-ko && curl -fsSL https://beautifulsoup.dev/skill-files/bug-report-ko/SKILL.md -o ~/.claude/skills/bug-report-ko/SKILL.md
명령을 쓰기 어렵다면 아래 SKILL.md를 복사하거나 내려받아, 같은 위치에 bug-report-ko 폴더를 만들고 그 안에 넣어도 돼요. 한 프로젝트에서만 쓰려면 프로젝트 안의 .claude/skills/에 넣어요.
에이전트가 이 스킬을 꺼내는 때
버그를 보고하거나, 이슈를 쓰거나, 에이전트나 동료에게 버그 수정을 넘길 때 쓴다. 사용자가 "버그 리포트", "이슈 작성", "이거 안 돼"라고 할 때 쓴다.
SKILL.md 머리말의 설명이에요. 에이전트는 이 설명을 보고 언제 이 스킬을 쓸지 정해요. 이름을 직접 불러 써도 돼요.
SKILL.md
먼저 재현한다
- 사용자가 말한 증상을 한 문장으로 정리한다.
- 가장 짧은 재현 단계를 찾는다. 재현되지 않으면 그 사실과 시도한 단계를 적는다.
- 늘 생기는지, 가끔 생기는지, 어떤 조건에서만 생기는지 적는다.
보고서 꼴
- 제목: 어디서 무엇이 어떻게 잘못되는지 한 줄
- 재현 단계: 번호 목록
- 기대한 동작과 실제 동작
- 환경: 운영체제, 브라우저, 버전, 계정 종류
- 오류 메시지와 로그: 자르지 않고, 비밀 값은 가리고
- 화면 캡처나 영상 자리
- 원인 후보: 확인한 것과 추측을 나눠서
- 영향: 누가, 얼마나 자주, 우회 방법이 있는지
지킬 것
- 추측을 사실처럼 쓰지 않는다.
- 개인정보와 비밀 값은 가린다.
- 하나의 보고서에 버그 하나.
개발의 다른 스킬
이런 스킬도 있으면 좋겠다 싶으면 알려 주세요