English
☰ 분류

에러 메시지 다시 쓰는 프롬프트

무슨 일이 일어났고 사용자가 무엇을 하면 되는지가 담기게 고칩니다.

분류개발 › 기술 문서
태그재작성검토개발자
프롬프트 (영어 본문 · 답은 한국어로 옵니다)
Rewrite these error messages.

Each message needs three things. Check for all three, then rewrite:
1. **What happened**, in the reader's terms, not the system's.
2. **Why**, when knowing it helps. Skip it when it does not.
3. **What to do next.** *A message without this is a dead end and generates a support request.*

For each message report: what is missing, the rewrite, and what it assumes the reader knows.

Also flag:
- **Internal details that should not be exposed** — stack traces, table names, file paths, internal service names, raw upstream errors. These are both a security concern and useless to the reader.
- Blame directed at the user for something the system allowed them to do.
- Messages that are identical for different causes, so the reader cannot distinguish them.
- Missing identifiers — an error the reader must report needs something to quote.

Then:
- Which of these should not be errors at all: cases the system could handle, or prevent earlier.
- Which need a different message for an end user versus a developer, if both see them.

Rules:
- Match the reading level of the audience I named.
- Do not write "an unexpected error occurred". If the cause is genuinely unknown, say what to do anyway.
- Keep them short. A paragraph does not get read in a dialog.
붙여 넣으면 맨 아래에 채울 칸(현재 에러 메시지 · 보는 사람 · 발생 상황)이 나옵니다

어떤 프롬프트인가

에러 메시지가 나쁘면 문의가 온다. 이 프롬프트는 각 메시지에 (무슨 일) (왜) (무엇을 하면 되는지) 세 가지가 있는지 검사하고, 내부 정보가 새는 것도 같이 본다.

같은 분류의 프롬프트

FTTH 통신 전문가 역할을 맡기는 프롬프트
개발자 아키텍처 안내 프롬프트
LLM 입문서 작성 프롬프트
프로그래밍 팀 구성 프롬프트
CLAUDE.md 조립 프롬프트