장애 진단 프롬프트는 오류 메시지를 실행 가능한 점검 목록으로 바꿔줍니다. 오류 메시지, 관련 로그, 고장나기 직전에 바꾼 코드를 붙여넣으면 AI가 가장 가능성 높은 원인을 먼저 찾고, 쉬운 순서대로 확인할 단계를 나열한 뒤, 수정 단계와 검증 방법을 알려줍니다. 개발자, 운영 담당자, 남의 코드를 막 이어받은 사람에게 적합하며, 오류가 뜨는 즉시 쓸 수 있습니다. 원인을 추측하거나 문서를 뒤질 필요가 없습니다.
이 프롬프트를 복사해 그대로 쓰세요
당신은 10년 경력의 소프트웨어 엔지니어로, 운영 장애와 로컬 오류의 원인 파악에 능숙합니다. 아래 단계에 따라 문제 해결을 도와주세요. 단계를 건너뛰지 말고 결론부터 말하지 마세요.
[오류 메시지]
[오류 코드와 스택 트레이스 앞 20줄을 포함한 전체 오류를 붙여넣으세요]
[관련 로그]
[오류 발생 전후 1분간의 로그를 붙여넣으세요. 관련된 서비스만]
[최근 변경 사항]
[오류 직전에 마지막으로 바꾼 내용을 적으세요: 파일, 설정, 의존성 버전]
[실행 환경]
[언어와 버전, 프레임워크, 운영체제, 배포 방식]
다음 순서대로 출력하세요:
1. 가장 가능성 높은 원인 3개를 가능성 순으로, 각각 근거를 한 문장으로
2. 검증 방법: 각 원인마다 빠르게 확인할 수 있는 명령어나 체크포인트 하나씩
3. 수정 단계: 가장 가능성 높은 원인부터 순서대로. 무엇을 먼저 바꾸고, 바꾼 뒤 어떻게 검증할지
4. 위의 어느 것에도 해당하지 않으면 추가로 필요한 정보를 나열하세요변수만 바꾸면 같은 문장을 계속 쓸 수 있습니다
대괄호 안의 네 곳이 매번 바꿀 변수이며, 나머지 문장은 그대로 둡니다. 오류 메시지는 이번 장애와 관련된 부분만 붙여넣고, 스택 트레이스가 20줄을 넘으면 반복되는 프레임을 잘라냅니다. 로그는 오류 전후 1분이면 충분하고, 전체를 붙여넣으면 진짜 원인이 묻힙니다. 최근 변경 사항은 가장 자주 빠뜨리는 항목입니다. 오류만 붙여넣고 무엇을 바꿨는지 적지 않는 사람이 많아, 그 경우 AI는 추측할 수밖에 없습니다. 변경 내용을 분명히 적으면 원인은 대개 한 번에 맞습니다. 실행 환경에는 버전 번호를 빠짐없이 적으세요. Python 3.12인지 3.9인지, 의존성을 올렸는지. 마이너 버전 하나 차이로 전혀 다른 문제가 되기도 합니다.
AI에 휘둘리지 않고 쓰는 방법
한 번에 하나의 오류만 조사하세요. 두 개의 오류를 섞어 붙여넣으면 AI가 존재하지 않는 하나의 원인으로 합쳐버립니다. 답을 받으면 먼저 첫 번째 원인의 검증 방법을 보고, 1분 들여 실행한 뒤 수정을 시작하세요. 다섯 곳을 한 번에 바꾸고 되돌아 찾는 대신, 한 단계 바꿀 때마다 검증하세요. AI가 제시한 명령어는 테스트 환경에서 먼저 실행하고, 무해함을 확인한 뒤 운영 환경에 적용하세요. 로그에 비밀키, 실제 사용자 데이터, 내부 주소가 있으면 붙여넣기 전에 가리세요. 원인을 찾고 코드를 수정한 뒤에는 코드 리뷰 프롬프트를 이용해 AI에게 변경 내용을 심각도 순으로 확인시키고 새로운 문제가 남지 않았는지 확인하세요. 확산 중인 운영 장애는 진단보다 먼저 피해를 막는 것이 우선이며, 재현되지 않는 문제는 재현 단계를 먼저 보완해야 합니다. 이 프롬프트는 그 두 가지에는 도움이 되지 않습니다.
