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

내려받기

먼저 재현한다

  1. 사용자가 말한 증상을 한 문장으로 정리한다.
  2. 가장 짧은 재현 단계를 찾는다. 재현되지 않으면 그 사실과 시도한 단계를 적는다.
  3. 늘 생기는지, 가끔 생기는지, 어떤 조건에서만 생기는지 적는다.

보고서 꼴

  • 제목: 어디서 무엇이 어떻게 잘못되는지 한 줄
  • 재현 단계: 번호 목록
  • 기대한 동작과 실제 동작
  • 환경: 운영체제, 브라우저, 버전, 계정 종류
  • 오류 메시지와 로그: 자르지 않고, 비밀 값은 가리고
  • 화면 캡처나 영상 자리
  • 원인 후보: 확인한 것과 추측을 나눠서
  • 영향: 누가, 얼마나 자주, 우회 방법이 있는지

지킬 것

  • 추측을 사실처럼 쓰지 않는다.
  • 개인정보와 비밀 값은 가린다.
  • 하나의 보고서에 버그 하나.

개발의 다른 스킬

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

기술 라이브러리

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

© 2026 기술 라이브러리