공식 스킬 · 고객 성공

지원 티켓으로 쓰는 버그 리포트

고객 불만을 개발팀이 바로 쓸 수 있는 버그 리포트로 바꾼다. 재현 단계, 기대·실제 동작, 환경, 영향, 증거, 물어볼 질문을 담는다.

Claude, ChatGPT, 코딩 에이전트에서 쓸 수 있어요. Team, Business 요금제에서는 포드에 넣은 공식 스킬이 개선될 때마다 알아서 최신 버전으로 바뀌어요.

언제 쓰나요

AI에게 주는 것

받는 결과

Jira, Linear, GitHub에 바로 붙여 넣을 수 있는 버그 리포트와 고객에게 보낼 질문.

진행 방법

  1. 장애와 위치를 담은 제목을 쓴다 형식: "[어디서/언제] [동작]이 [어떻게 실패]": "리포트에서 CSV 내보내기 시 1,000행을 넘는 행이 빠짐". "내보내기 고장"이나 고객의 말 "긴급 버그!!"는 쓰지 않는다.
  2. 재현 단계를 번호를 붙인 한 동작씩 쓴다 알려진 상태에서 시작한다("Team 요금제의 관리자로 로그인한 상태"). 한 단계에 클릭이나 입력 하나. 화면의 라벨은 그대로 굵게 쓴다. 고객이 말한 단계가 모호하면 쓸 수 있는 만큼 쓰고 불확실한 단계에 "[미확인]"을 붙인다.
  3. 기대 동작과 실제 동작을 쓴다 기대 동작: 문서나 이전 동작에 따라 제품이 해야 하는 일. 실제 동작: 일어난 일을 눈에 보이는 말로(메시지 문구, 나타난 것, 나타나지 않은 것). 오류 메시지는 그대로 인용한다.
  4. 환경과 빈도를 적는다 브라우저, 앱 버전, OS, 요금제, 계정 ID, 발생 시각과 시간대. 빈도: 매번, 가끔(y번 중 x번), 한 번.
  5. 영향 범위를 잡는다 보고한 고객이나 티켓 수, 우회 방법이 있는지, 돈·데이터·보안이 걸려 있는지. 심각도(S1~S4)를 제안하고 이유를 한 줄로 쓴다.
  6. 증거를 붙인다 스크린샷, 녹화, 로그, 티켓 ID를 나열한다. 고객 개인정보는 리포트에 넣지 않고 티켓 ID로 대신한다.
  7. 고객에게 물어볼 것을 나열한다 빠진 사실마다 지원 담당자가 그대로 붙여 넣을 수 있는 질문으로 쓴다: "어떤 브라우저와 버전을 쓰셨나요?" 최대 4개, 중요한 것부터.

팀과 함께 쓰기

AI Skill Pod에 추가하면 외부 협력자를 포함해 팀원 모두가 자기 AI에서 같은 버전을 써요. 팀에서 AI 스킬을 공유하는 방법 읽기

팀 포드에 추가하기

변경 기록

출처

출처는 영어 페이지예요.

  1. Bug Writing Guidelines (2026-11-04 확인)
  2. Bug Report Guidelines | WebKit (2026-11-04 확인)
  3. Configuring issue templates for your repository (2026-11-04 확인)