공식 스킬 · 고객 성공
지원 티켓으로 쓰는 버그 리포트
고객 불만을 개발팀이 바로 쓸 수 있는 버그 리포트로 바꾼다. 재현 단계, 기대·실제 동작, 환경, 영향, 증거, 물어볼 질문을 담는다.
Claude, ChatGPT, 코딩 에이전트에서 쓸 수 있어요. Team, Business 요금제에서는 포드에 넣은 공식 스킬이 개선될 때마다 알아서 최신 버전으로 바뀌어요.
언제 쓰나요
- 티켓에 고장 신고가 들어와 개발팀에 넘겨야 할 때
- 개발팀이 정보가 더 필요하다며 티켓을 돌려보냈을 때
AI에게 주는 것
- 티켓이나 채팅 스레드
- 알고 있다면 고객 환경
- 직접 재현한 결과(선택)
받는 결과
Jira, Linear, GitHub에 바로 붙여 넣을 수 있는 버그 리포트와 고객에게 보낼 질문.
진행 방법
- 장애와 위치를 담은 제목을 쓴다 형식: "[어디서/언제] [동작]이 [어떻게 실패]": "리포트에서 CSV 내보내기 시 1,000행을 넘는 행이 빠짐". "내보내기 고장"이나 고객의 말 "긴급 버그!!"는 쓰지 않는다.
- 재현 단계를 번호를 붙인 한 동작씩 쓴다 알려진 상태에서 시작한다("Team 요금제의 관리자로 로그인한 상태"). 한 단계에 클릭이나 입력 하나. 화면의 라벨은 그대로 굵게 쓴다. 고객이 말한 단계가 모호하면 쓸 수 있는 만큼 쓰고 불확실한 단계에 "[미확인]"을 붙인다.
- 기대 동작과 실제 동작을 쓴다 기대 동작: 문서나 이전 동작에 따라 제품이 해야 하는 일. 실제 동작: 일어난 일을 눈에 보이는 말로(메시지 문구, 나타난 것, 나타나지 않은 것). 오류 메시지는 그대로 인용한다.
- 환경과 빈도를 적는다 브라우저, 앱 버전, OS, 요금제, 계정 ID, 발생 시각과 시간대. 빈도: 매번, 가끔(y번 중 x번), 한 번.
- 영향 범위를 잡는다 보고한 고객이나 티켓 수, 우회 방법이 있는지, 돈·데이터·보안이 걸려 있는지. 심각도(S1~S4)를 제안하고 이유를 한 줄로 쓴다.
- 증거를 붙인다 스크린샷, 녹화, 로그, 티켓 ID를 나열한다. 고객 개인정보는 리포트에 넣지 않고 티켓 ID로 대신한다.
- 고객에게 물어볼 것을 나열한다 빠진 사실마다 지원 담당자가 그대로 붙여 넣을 수 있는 질문으로 쓴다: "어떤 브라우저와 버전을 쓰셨나요?" 최대 4개, 중요한 것부터.
팀과 함께 쓰기
AI Skill Pod에 추가하면 외부 협력자를 포함해 팀원 모두가 자기 AI에서 같은 버전을 써요. 팀에서 AI 스킬을 공유하는 방법 읽기
변경 기록
- v1.0.0 · · First release.
출처
출처는 영어 페이지예요.
- Bug Writing Guidelines (2026-11-04 확인)
- Bug Report Guidelines | WebKit (2026-11-04 확인)
- Configuring issue templates for your repository (2026-11-04 확인)