재현 절차가 있는 버그 리포트 쓰기

증상만 있던 제보를 개발자가 쓸 형태로 바꾼다

프롬프트 · 변수 3개

당신은 개발팀에 결함을 전달해 온 QA 담당자입니다. 개발자가 되묻지 않고 바로 재현할 수 있는 리포트를 쓰는 것이 목표입니다.

저는 사용자에게 받은 제보를 개발팀에 넘길 형태로 정리하려 합니다. 문제가 난 환경은 {{사용 환경}} 이고, 원래대로라면 {{기대 동작}} 이어야 합니다.

아래 제보 메모를 버그 리포트로 다시 써 주세요. 메모에 흩어져 있는 내용을 항목별로 나누고, 특히 재현 절차는 개발자가 그대로 따라 할 수 있는 조작 단위로 풀어 주세요.

항목은 이 순서로 해 주세요. 제목(무엇이 언제 안 되는지 한 줄) · 재현 절차(번호를 매기고 한 줄에 조작 하나) · 기대 결과 · 실제 결과 · 사용 환경 · 발생 빈도(항상·가끔·한 번만 중에서, 메모에 근거가 있을 때만) · 첨부하면 좋을 자료.

메모에 없는 내용은 지어내지 말고 "제보에 없음" 이라고 적어 주세요. 원인 추측은 쓰지 말아 주세요. 대신 담당자가 제보자에게 되물어야 할 질문을 마지막에 3개까지 따로 적어 주세요. 메모에 사람 이름이나 연락처, 주문 번호가 들어 있으면 "고객 A", "주문 1" 처럼 바꿔 주세요.

제보 메모: """ {{증상 메모}} """

복사한 뒤 여기에 붙여 넣으세요 · ChatGPT·Claude는 프롬프트를 실은 채 열립니다 ChatGPT에서 열기 ↗Claude에서 열기 ↗Gemini에서 열기 ↗뤼튼에서 열기 ↗ 빌더에서 고치기 수업용 카드 이미지 받기

이 프롬프트에는 개인정보가 들어갈 수 있는 변수가 있습니다. 실제 이름·번호·회사명은 가명으로 바꿔 넣으세요.

결과 예시

7개 항목이 순서대로 나왔고, 화면 이름과 오류 문구는 "제보에 없음"으로 남아 되물을 질문 3개로 내려갔다. 발생 빈도는 오전 성공·오후 실패 기록을 근거로 "가끔"이 붙었다.

제목: 오후 시간대에 결제 버튼을 눌러도 다음 화면으로 넘어가지 않음 재현 절차: 1. 앱 4.2.1로 로그인한다 2. 상품을 담고 결제 화면까지 이동한다 3. 결제 버튼을 누른다 — 누른 뒤 나타나야 할 화면 이름은 제보에 없음

화면 캡처를 받으면 다시 넣어 절차를 채우면 된다.

Claude에서 실제로 실행해 확인 · 2026-09

왜 이렇게 쓰는가

역할
당신은 개발팀에 결함을 전달해 온 QA 담당자입니다. 개발자가 되묻지 않고 바로 재현할 수 있는 리포트를 쓰는 것이 목표입니다.
맥락
저는 사용자에게 받은 제보를 개발팀에 넘길 형태로 정리하려 합니다. 문제가 난 환경은 {{사용 환경}} 이고, 원래대로라면 {{기대 동작}} 이어야 합니다.
과제
아래 제보 메모를 버그 리포트로 다시 써 주세요. 메모에 흩어져 있는 내용을 항목별로 나누고, 특히 재현 절차는 개발자가 그대로 따라 할 수 있는 조작 단위로 풀어 주세요.
형식
항목은 이 순서로 해 주세요. 제목(무엇이 언제 안 되는지 한 줄) · 재현 절차(번호를 매기고 한 줄에 조작 하나) · 기대 결과 · 실제 결과 · 사용 환경 · 발생 빈도(항상·가끔·한 번만 중에서, 메모에 근거가 있을 때만) · 첨부하면 좋을 자료.
제약
메모에 없는 내용은 지어내지 말고 "제보에 없음" 이라고 적어 주세요. 원인 추측은 쓰지 말아 주세요. 대신 담당자가 제보자에게 되물어야 할 질문을 마지막에 3개까지 따로 적어 주세요. 메모에 사람 이름이나 연락처, 주문 번호가 들어 있으면 "고객 A", "주문 1" 처럼 바꿔 주세요.
입력 자료
제보 메모: """ {{증상 메모}} """

버그 리포트 작성이 어려운 이유는 글솜씨가 아니라 정보의 모양 때문입니다. "결제가 안 된대요" 한 줄로 전달되면 개발자는 재현부터 실패하고, 되묻는 메시지가 몇 번 오간 뒤에야 조사가 시작됩니다. 그 사이 제보자는 이미 잊어버렸습니다.

출력 형식 을 항목으로 못 박은 것이 이 프롬프트의 전부라고 해도 됩니다. 특히 "기대 결과" 와 "실제 결과" 를 나눠 적게 하는 것이 중요합니다. 둘을 나누는 순간 "안 돼요" 가 "결제 수단 선택 화면으로 넘어가야 하는데 화면이 그대로다" 로 바뀌고, 이것만으로도 어디를 볼지가 좁혀집니다. 재현 절차를 한 줄에 조작 하나로 제한한 것도 같은 이유로, 두 동작이 한 줄에 묶여 있으면 어느 쪽에서 실패했는지 알 수 없습니다.

제약 세 줄은 각각 다른 잡음을 걷어 냅니다. "지어내지 말고 제보에 없음" 은 QA 결함 보고서 chatgpt 로 만들 때 가장 자주 생기는 문제, 곧 그럴듯한 브라우저 버전이나 오류 문구가 채워지는 일을 막습니다. "원인 추측 금지" 는 리포트가 진단서로 변해 개발자가 엉뚱한 곳부터 보게 되는 것을 막고, 대신 되물을 질문을 따로 받아 두면 제보자에게 한 번에 확인할 수 있습니다.

제보 메모를 """ 로 감싼 이유는 두 가지입니다. 메모와 지시가 섞이지 않게 하고, 메모 안의 "이거 급하니까 바로 처리해 주세요" 같은 문장이 지시로 읽히는 것을 막습니다. 이름과 연락처를 바꾸라는 줄은 이슈 트래커에 고객 정보가 그대로 남지 않게 하는 장치입니다.

용어가 낯설면 아하AI에서: output-format, prompt-injection

나쁜 예와 비교

흔한 나쁜 예

고객이 결제 안 된다는데 버그 리포트 좀 써줘 어제는 됐다고 하고 오늘은 안 된대요

메모에 없는 정보를 AI가 채워 넣습니다. 겪지도 않은 오류 메시지와 확인한 적 없는 브라우저 버전이 그럴듯하게 적히고, 개발자가 그 정보를 믿고 조사하다 시간을 잃습니다. 재현 절차도 "결제를 시도한다" 한 줄로 뭉뚱그려져, 어느 화면 어느 버튼에서 멈췄는지는 결국 다시 물어보게 됩니다.

변형

내가 직접 겪은 문제를 정리할 때

내가 직접 겪은 문제를 정리할 때

제가 직접 겪은 문제를 이슈로 등록하려 합니다. 환경은 {{사용 환경}}, 원래 동작은 {{기대 동작}} 입니다. 아래 메모를 이슈 본문으로 정리하되, 제가 이미 시도해 본 것과 아직 시도하지 않은 것을 나눠 적어 주세요. 시도하지 않은 것 중 등록 전에 해 보면 좋을 확인 3가지를 먼저 알려 주세요.

""" {{증상 메모}} """

직접 겪은 문제는 재현 조건을 더 좁힐 수 있습니다. 등록 전 확인 목록을 받아 두면 "제 환경에서는 되는데요" 로 닫히는 이슈가 줄어듭니다.

여러 건의 제보를 한 번에 추릴 때

여러 건의 제보를 한 번에 추릴 때

아래는 며칠 동안 들어온 제보를 모아 둔 것입니다. 같은 원인으로 보이는 것끼리 묶고, 묶음마다 대표 제목 한 줄과 공통점·차이점을 정리해 주세요. 한 건뿐이라 판단이 어려운 제보는 따로 모아 주세요. 추측으로 묶지 말고, 묶은 근거를 제보 안의 표현으로 인용해 주세요.

""" {{증상 메모}} """

제보가 쌓였을 때 씁니다. 묶음별로 리포트를 쓰면 같은 문제를 여러 번 등록하는 일을 줄일 수 있습니다.

모델별 주의

화면 캡처나 오류 화면 사진이 있으면 함께 올리세요. 메모로는 빠지기 쉬운 화면 이름과 오류 문구를 그림에서 읽어 냅니다

관련 프롬프트

마지막 수정 2026-09-02 · 잘못된 점이 있나요? 알려 주세요