결과 예시
7개 항목이 순서대로 나왔고, 화면 이름과 오류 문구는 "제보에 없음"으로 남아 되물을 질문 3개로 내려갔다. 발생 빈도는 오전 성공·오후 실패 기록을 근거로 "가끔"이 붙었다.
제목: 오후 시간대에 결제 버튼을 눌러도 다음 화면으로 넘어가지 않음 재현 절차: 1. 앱 4.2.1로 로그인한다 2. 상품을 담고 결제 화면까지 이동한다 3. 결제 버튼을 누른다 — 누른 뒤 나타나야 할 화면 이름은 제보에 없음
화면 캡처를 받으면 다시 넣어 절차를 채우면 된다.
Claude에서 실제로 실행해 확인 · 2026-09
왜 이렇게 쓰는가
버그 리포트 작성이 어려운 이유는 글솜씨가 아니라 정보의 모양 때문입니다. "결제가 안 된대요" 한 줄로 전달되면 개발자는 재현부터 실패하고, 되묻는 메시지가 몇 번 오간 뒤에야 조사가 시작됩니다. 그 사이 제보자는 이미 잊어버렸습니다.
출력 형식 을 항목으로 못 박은 것이 이 프롬프트의 전부라고 해도 됩니다. 특히 "기대 결과" 와 "실제 결과" 를 나눠 적게 하는 것이 중요합니다. 둘을 나누는 순간 "안 돼요" 가 "결제 수단 선택 화면으로 넘어가야 하는데 화면이 그대로다" 로 바뀌고, 이것만으로도 어디를 볼지가 좁혀집니다. 재현 절차를 한 줄에 조작 하나로 제한한 것도 같은 이유로, 두 동작이 한 줄에 묶여 있으면 어느 쪽에서 실패했는지 알 수 없습니다.
제약 세 줄은 각각 다른 잡음을 걷어 냅니다. "지어내지 말고 제보에 없음" 은 QA 결함 보고서 chatgpt 로 만들 때 가장 자주 생기는 문제, 곧 그럴듯한 브라우저 버전이나 오류 문구가 채워지는 일을 막습니다. "원인 추측 금지" 는 리포트가 진단서로 변해 개발자가 엉뚱한 곳부터 보게 되는 것을 막고, 대신 되물을 질문을 따로 받아 두면 제보자에게 한 번에 확인할 수 있습니다.
제보 메모를 """ 로 감싼 이유는 두 가지입니다. 메모와 지시가 섞이지 않게 하고, 메모 안의 "이거 급하니까 바로 처리해 주세요" 같은 문장이 지시로 읽히는 것을 막습니다. 이름과 연락처를 바꾸라는 줄은 이슈 트래커에 고객 정보가 그대로 남지 않게 하는 장치입니다.
용어가 낯설면 아하AI에서: output-format, prompt-injection
나쁜 예와 비교
고객이 결제 안 된다는데 버그 리포트 좀 써줘 어제는 됐다고 하고 오늘은 안 된대요
메모에 없는 정보를 AI가 채워 넣습니다. 겪지도 않은 오류 메시지와 확인한 적 없는 브라우저 버전이 그럴듯하게 적히고, 개발자가 그 정보를 믿고 조사하다 시간을 잃습니다. 재현 절차도 "결제를 시도한다" 한 줄로 뭉뚱그려져, 어느 화면 어느 버튼에서 멈췄는지는 결국 다시 물어보게 됩니다.
변형
내가 직접 겪은 문제를 정리할 때
제가 직접 겪은 문제를 이슈로 등록하려 합니다. 환경은 {{사용 환경}}, 원래 동작은 {{기대 동작}} 입니다. 아래 메모를 이슈 본문으로 정리하되, 제가 이미 시도해 본 것과 아직 시도하지 않은 것을 나눠 적어 주세요. 시도하지 않은 것 중 등록 전에 해 보면 좋을 확인 3가지를 먼저 알려 주세요.
""" {{증상 메모}} """
직접 겪은 문제는 재현 조건을 더 좁힐 수 있습니다. 등록 전 확인 목록을 받아 두면 "제 환경에서는 되는데요" 로 닫히는 이슈가 줄어듭니다.
여러 건의 제보를 한 번에 추릴 때
아래는 며칠 동안 들어온 제보를 모아 둔 것입니다. 같은 원인으로 보이는 것끼리 묶고, 묶음마다 대표 제목 한 줄과 공통점·차이점을 정리해 주세요. 한 건뿐이라 판단이 어려운 제보는 따로 모아 주세요. 추측으로 묶지 말고, 묶은 근거를 제보 안의 표현으로 인용해 주세요.
""" {{증상 메모}} """
제보가 쌓였을 때 씁니다. 묶음별로 리포트를 쓰면 같은 문제를 여러 번 등록하는 일을 줄일 수 있습니다.
모델별 주의
화면 캡처나 오류 화면 사진이 있으면 함께 올리세요. 메모로는 빠지기 쉬운 화면 이름과 오류 문구를 그림에서 읽어 냅니다
관련 프롬프트
마지막 수정 2026-09-02 · 잘못된 점이 있나요? 알려 주세요