에러를 읽어내는 일은 개발 과정에서 가장 시간을 많이 잡아먹는 단계 중 하나입니다. 스택 트레이스는 수십 줄에 달하고, 마지막 줄이 말해 주는 건 대개 겉으로 드러난 증상뿐이며, 진짜 원인은 호출 체인의 상류에 숨어 있습니다. 검색 엔진에서 무작정 뒤지기 전에 아래 프롬프트를 아무 채팅 AI에 복사한 뒤, 에러 원문과 관련 코드를 함께 붙여넣어 보세요. AI가 먼저 근본 원인을 짚어내고, 최소한의 수정안과 검증 절차를 돌려줍니다.
활용 장면: 프로그램이 실행되지 않거나, API가 에러를 반환하거나, 스크립트가 중간에 죽었는데, 에러 메시지가 영어 스택 트레이스나 에러 코드라 혼자서는 감이 잡히지 않을 때.
먼저 이 블록을 복사: 에러 디버깅 프롬프트 전문
당신은 에러 메시지와 코드 조각에서 근본 원인을 찾아내는 데 능숙한 시니어 디버깅 엔지니어입니다. 아래 요구사항에 따라 이 버그 해결을 도와주세요.
1. 실행 환경: ［프로그래밍 언어와 버전(예: Python 3.12 / Node.js 20), 운영체제, 핵심 의존 패키지의 버전］
2. 에러 원문: ［터미널이나 로그에 출력된 스택 트레이스 전체를 그대로 붙여넣기. 마지막 한 줄만 잘라내지 말 것］
3. 관련 코드: ［에러가 가리키는 코드 조각을 붙여넣고 파일명과 줄 번호를 명시］
4. 시도해 본 방법: ［시도했지만 소용없었던 방법을 나열. 아직 시도한 게 없으면 "아직 없음"이라고 쓰기］
5. 답변 순서: 먼저 근본 원인을 한 문장으로 밝히고, 다음으로 최소한의 수정안을, 마지막으로 수정이 실제로 먹혔는지 확인하는 절차를 제시
6. 정직 원칙: 불확실한 내용을 지어내지 말 것. ［확인 필요］라고 표시하고, 추가로 필요한 정보를 알려주세요
시작합니다.6개 변수에 각각 무엇을 넣을까
- 실행 환경: AI가 어떤 지식 체계로 판단할지를 결정합니다. Python 3.8과 3.12에서는 같은 에러라도 근본 원인이 완전히 다를 수 있습니다. 버전을 잘못 적으면 진단도 틀어집니다.
- 에러 원문: 반드시 스택 트레이스 전체를 텍스트로 붙여넣습니다. 스크린샷에서는 줄 번호를 읽을 수 없고, 마지막 한 줄만으로는 진짜 호출 체인이 사라집니다.
- 관련 코드: 에러가 직접 가리키는 함수나 파일 조각만 줄 번호와 함께 붙여넣습니다. 무관한 코드를 많이 붙이면 판단에 방해가 됩니다.
- 시도해 본 방법: 이미 제외한 방안을 AI가 다시 제안하는 일을 막아, 헛된 왕복을 줄입니다.
- 답변 순서: 이유도 모른 채 "이렇게 고쳐 보세요"라는 코드만 던져지는 상황을 피하고, AI가 근본 원인을 먼저 말하게 합니다.
- 정직 원칙: 이 프롬프트 전체의 안전장치입니다. 디버깅에서 가장 무서운 건 AI가 그럴듯하게 틀린 답을 확신에 차서 내놓는 것인데, 이 요구사항이 그것을 막아줍니다.
이 프롬프트를 더 잘 쓰는 세 가지 요령
- 한 번에 고치는 버그는 하나씩. 에러 출력에 두세 개의 문제가 섞여 있다면 가장 먼저 등장한 스택 트레이스부터 해결합니다. 한꺼번에 물으면 진단끼리 서로 방해합니다.
- 수정안을 바로 적용하지 말고 "근본 원인에 대한 확신도가 얼마나 되나요?"라고 한 번 더 물어봅니다. AI 스스로도 자신이 없어 보이면 먼저 검증 절차를 실행하거나, 부족한 정보를 보충한 뒤 한 바퀴 더 물어봅니다.
- 적중한 진단은 저장할 가치가 있습니다. 이 프롬프트를 미리 채워 둔 환경 템플릿과 함께 프롬프트 모음에 저장해 두면, 다음에 에러가 났을 때 변수를 채우는 데 1분도 걸리지 않습니다.
