실전 프롬프트 작성법: 코드, 글쓰기, 요약에 AI를 제대로 쓰는 법

AI에게 묻는 일은 쉬워 보인다.

질문을 쓰고, 답을 기다리면 된다. 하지만 막상 원하는 답을 얻으려 하면 생각보다 자주 어긋난다. 답은 나오지만 방향이 다르고, 형식이 다르고, 내가 처한 상황과 맞지 않는다.

문제는 AI가 항상 부족해서가 아니다.

내가 무엇을 원하는지, 어떤 맥락에서 필요한지, 어떤 형태로 받아야 하는지를 충분히 건네지 못했을 때가 많다.

이 글은 하나의 개념을 깊게 다루기보다, 자주 마주치는 상황에서 바로 꺼내 쓸 수 있는 프롬프트의 형태를 모아둔 실전 노트에 가깝다.

1. 코드 수정 / 디버깅

흐릿한 요청

이거 왜 안 돼? 고쳐줘

코드가 없으면 분석할 수 없다. 에러 메시지가 없으면 원인을 추측해야 한다. AI는 코드를 상상해서 답하고, 그 코드가 실제와 다르면 답은 맞지 않는다.

기준을 넣은 요청

아래 Python 함수가 특정 조건에서 None을 반환하는 버그가 있어.

[코드 붙여넣기]

에러 메시지:
[에러 메시지 붙여넣기]

이 버그가 발생하는 상황:
- 입력값이 빈 리스트일 때

원하는 것:
1. 버그 원인 설명
2. 수정된 코드 (수정 전/후 함께 보여줘)
3. 같은 실수를 피하는 방법

코드 + 에러 메시지 + 발생 상황 + 원하는 출력 형식. 이 네 가지가 있으면 답의 방향이 좁아진다.

바로 쓸 수 있는 틀

아래 {{언어/프레임워크}} 코드에서 문제가 발생하고 있어.

[코드]
{{코드 붙여넣기}}

[에러 메시지]
{{에러 메시지 붙여넣기}}

[발생 상황]
{{어떤 조건에서 에러가 나는지}}

[환경]
- 언어 버전: {{예: Python 3.11}}
- 주요 라이브러리: {{예: FastAPI 0.100}}

원하는 것:
1. 원인 분석
2. 수정된 코드 (변경된 부분에 주석으로 설명)
3. 이 패턴에서 주의해야 할 점

2. 코드 리뷰

흐릿한 요청

이 코드 리뷰해줘

어떤 관점에서 리뷰해야 하는지 모른다. 성능인지, 가독성인지, 보안인지. 결국 AI는 방향 없이 일반적인 피드백을 줄 가능성이 높다.

기준을 넣은 요청

아래 Python FastAPI 코드를 리뷰해줘.

[코드]
{{코드}}

리뷰 관점:
1. 보안 취약점 (SQL 인젝션, 인증 누락 등)
2. 에러 처리가 적절한가
3. 성능 개선 가능한 부분

형식:
- 각 항목마다 "문제점 / 위험도(상/중/하) / 수정 제안" 형식으로
- 수정이 필요한 코드는 수정 예시도 포함
- 이미 잘 된 부분은 별도로 언급하지 않아도 됨

바로 쓸 수 있는 틀

아래 {{언어/프레임워크}} 코드를 리뷰해줘.

[코드]
{{코드}}

[리뷰 관점] (해당하는 것만 남겨)
- 보안 취약점
- 성능 최적화
- 가독성 / 코드 품질
- 에러 처리
- 테스트 커버리지

[형식]
각 문제마다: 문제점 / 심각도(상중하) / 수정 코드 예시
전체 한 줄 평가도 마지막에 추가해줘.

3. 글쓰기 (블로그, 아티클)

흐릿한 요청

AI에 대한 블로그 글 써줘

누구를 위한 글인지, 어떤 톤인지, 얼마나 길어야 하는지. 아무것도 없으면 어디서 본 것 같은 일반적인 글이 나온다.

기준을 넣은 요청

아래 조건으로 블로그 글을 써줘.

주제: Claude API로 챗봇 만드는 법
대상 독자: Python 기초는 알지만 AI API는 처음 써보는 개발자
목적: 이 글 읽고 30분 안에 작동하는 챗봇 만들기
분량: 1500자 내외
톤: 친근하고 실용적. 이론 최소화, 예제 코드 중심
구조:
  1. 완성 화면 스크린샷(텍스트로 묘사)
  2. 필요한 것 (pip install 포함)
  3. 코드 단계별 설명
  4. 실행 결과 예시
  5. 자주 나오는 에러 해결법
SEO 키워드: Claude API, 파이썬 챗봇, AI API 연동

바로 쓸 수 있는 틀

아래 조건으로 블로그 글을 써줘.

주제: {{주제}}
대상 독자: {{예: 비개발자 직장인 / 초보 개발자 / 시니어 개발자}}
목적: {{이 글을 읽고 독자가 얻어야 하는 것}}
분량: {{글자 수 또는 단어 수}}
톤: {{예: 전문적 / 친근한 / 유머러스}}

구조:
- 도입: {{어떻게 시작할지}}
- 본문 섹션: {{어떤 내용이 들어가야 하는지}}
- 마무리: {{어떻게 끝낼지}}

포함할 것: {{예: 코드 예시 / 표 / 실제 사례}}
피할 것: {{예: 너무 기술적인 용어 / 이론 위주}}
SEO 키워드: {{주요 키워드 3개}}

4. SNS / 소셜 미디어 콘텐츠

흐릿한 요청

인스타그램 포스트 써줘

어떤 계정인지, 무슨 내용인지, 해시태그는 몇 개인지. 아무것도 없으면 아무 계정에나 쓸 수 있는 글이 나온다.

기준을 넣은 요청

내 인스타그램 계정(@_dev, AI/개발 콘텐츠)용 포스트를 써줘.

이번 포스트 내용:
"프롬프트를 잘 쓰면 일이 10배 빨라진다"는 주제

톤: 실용적이고 공감가게. 너무 광고스럽지 않게.
길이: 캡션 150자 내외
해시태그: 관련 해시태그 10개
마지막에 팔로워 참여 유도 질문 하나 포함
이모지: 자연스럽게 사용

바로 쓸 수 있는 틀

{{플랫폼}} 포스트를 써줘.

계정 성격: {{예: AI/개발 정보 계정 / 라이프스타일 / 음식 블로그}}
포스트 주제: {{주제나 전달할 메시지}}
톤: {{예: 친근한 / 전문적 / 유머러스 / 동기부여}}
길이: {{글자 수 또는 "짧게/길게"}}
포함할 것:
- 해시태그 {{개수}}개
- {{이모지 사용 여부}}
- {{CTA: 좋아요 유도 / 댓글 유도 / 링크 클릭 유도}}

5. 유튜브 / 쇼츠 대본

흐릿한 요청

유튜브 쇼츠 대본 짜줘

어떤 주제인지, 몇 초짜리인지, 누구를 위한 건지. 아무것도 없으면 평범한 대본이 나온다. 쇼츠에서 처음 3초 안에 시청자를 잡지 못하면 스크롤해서 내려간다. 이 3초 훅이 가장 중요한데, "대본 짜줘"만으로는 이걸 제대로 만들 수 없다.

기준을 넣은 요청

유튜브 쇼츠 대본을 써줘.

채널: AI 활용 팁 채널 (구독자 5만, 20~40대 직장인 대상)
주제: "ChatGPT에 이렇게 물어보면 답변 질이 3배 달라집니다"
길이: 55초 (말하는 속도 기준 약 165단어)
톤: 빠르고 실용적. 친근한 반말체.

구조:
- 훅 (0~3초): 시청자가 멈춰서 볼 만한 충격적인 사실이나 질문
- 문제 제기 (3~15초): 대부분의 사람들이 AI를 잘못 쓰는 현실
- 핵심 내용 (15~45초): 구체적인 팁 2~3가지, 예시 포함
- CTA (45~55초): 구독 또는 댓글 유도

추가 조건:
- 자막으로 보여줄 핵심 키워드도 [자막] 표시로 포함
- 화면에 보여줄 시각적 요소도 간단히 지시

바로 쓸 수 있는 틀

유튜브 {{영상 종류: 쇼츠/일반}} 대본을 써줘.

채널 성격: {{채널 주제와 주 시청자}}
영상 주제: {{주제}}
길이: {{초 또는 분}}
톤: {{예: 친근한 / 전문적 / 유머러스}}
말투: {{예: 존댓말 / 반말 / 혼합}}

구조:
- 훅 (처음 {{초}}): {{어떤 방식으로 시작할지}}
- 본론 {{초}}: {{전달할 핵심 내용}}
- CTA {{초}}: {{원하는 행동: 구독 / 댓글 / 좋아요}}

포함할 것:
- [자막] 표시로 강조할 키워드
- (화면) 표시로 시각적 지시사항

6. 이메일 / 업무 문서 작성

흐릿한 요청

이메일 써줘. 미팅 일정 잡는 거

누구에게 보내는 이메일인지, 어떤 관계인지, 어떤 미팅인지. 없으면 AI는 가장 일반적인 이메일 형식으로 쓴다. 상대방과의 관계나 회사 문화가 전혀 반영되지 않는다.

기준을 넣은 요청

비즈니스 이메일을 써줘.

수신자: 처음 연락하는 스타트업 CTO (LinkedIn에서 팔로우 중)
목적: 협업 가능성 탐색을 위한 30분 미팅 요청
내 소개: AI 컨설팅 회사 대표, 3년 경력
미팅 제안 날짜: 5월 8일(목) 오후 2~5시 사이, 또는 9일(금) 오전
형식: 영어로, 전문적이지만 너무 딱딱하지 않게
길이: 150단어 이내로 간결하게
필수 포함: 미팅 요청 이유 한 문장, 나의 가치 제안 한 문장, 명확한 CTA

바로 쓸 수 있는 틀

{{이메일 / 슬랙 메시지 / 공문}} 형식으로 써줘.

수신자: {{수신자 직책, 회사, 관계}}
발신자 정보: {{내 직책, 회사, 관련 배경}}
목적: {{이메일로 달성하려는 것}}
톤: {{예: 격식체 / 친근한 / 협력적}}
길이: {{글자/단어 수 또는 짧게/보통/길게}}

반드시 포함할 내용:
- {{항목 1}}
- {{항목 2}}

피할 것: {{예: 너무 긴 인사말 / 불필요한 부연 설명}}

7. 요약

흐릿한 요청

이거 요약해줘 + [긴 텍스트]

어떤 목적으로 요약하는 건지 모른다. 한 줄 요약인지, 항목별 요약인지, 어떤 핵심을 뽑아야 하는지. 방향이 없으면 결과물이 너무 길거나, 원하지 않는 부분이 강조될 수 있다.

기준을 넣은 요청

아래 회의록을 요약해줘.

[텍스트]
{{회의록 내용}}

요약 목적: 참석 못한 팀원에게 공유할 용도
형식:
- 한 줄 요약 (전체 내용 압축)
- 주요 결정 사항 (bullet point, 3개 이내)
- 다음 액션 아이템 (담당자 - 할 일 - 기한 형식)
- 다음 미팅 일정 (있다면)

제외할 것: 잡담, 반복된 내용, 미결 논의사항

바로 쓸 수 있는 틀

아래 {{텍스트 종류: 기사/회의록/논문/보고서}}을 요약해줘.

[텍스트]
{{내용}}

요약 목적: {{예: 발표용 / 팀 공유용 / 개인 학습용 / SNS 공유용}}
형식:
- {{예: 한 줄 / bullet point 5개 / 섹션별 요약}}
- {{예: 표로 정리 / 이야기 형식}}
분량: {{글자 수 또는 "최대한 짧게"}}

반드시 포함: {{핵심 수치 / 결론 / 행동 지침 등}}
제외할 것: {{반복 내용 / 예시 / 각주 등}}

8. 번역

흐릿한 요청

이거 영어로 번역해줘

어떤 맥락의 텍스트인지, 공식 문서인지 SNS 게시물인지. 이런 정보 없이는 직역체의 어색한 영어가 나올 수 있다.

기준을 넣은 요청

아래 한국어 텍스트를 영어로 번역해줘.

[원문]
{{텍스트}}

번역 목적: 미국 투자자에게 보내는 사업계획서
톤: 전문적이고 설득력 있게
수준: 비즈니스 영어, 원어민이 자연스럽게 읽을 수 있게
주의: 직역 금지, 영어 표현 방식에 맞게 의역 허용
번역 후: 어색하거나 자연스럽지 않은 표현이 있으면 대안도 함께 제시해줘

바로 쓸 수 있는 틀

아래 {{출발 언어}} 텍스트를 {{도착 언어}}로 번역해줘.

[원문]
{{텍스트}}

번역 목적: {{예: 이메일 / SNS / 공식 문서 / 발표 자료}}
수신자: {{예: 원어민 / 비원어민 / 전문가}}
톤: {{예: 격식체 / 캐주얼 / 전문적}}
허용: 의역 {{가능/불가능}}
추가 요청: {{예: 어색한 표현 있으면 대안 제시 / 원문과 번역 나란히 표시}}

9. 이미지 분석

흐릿한 요청

[이미지 올리기] 이거 봐줘

무엇을 봐야 하는지 모른다. 이미지 속 텍스트를 읽어야 하는지, 디자인을 평가해야 하는지, 에러를 찾아야 하는지. 방향이 없으면 AI는 이미지 안의 여러 요소 중 무엇을 중심으로 답해야 할지 알 수 없다.

기준을 넣은 요청

[이미지 올리기]

이 이미지는 내 웹사이트 메인 페이지 스크린샷이야.

아래 관점에서 분석해줘:
1. 첫인상 — 처음 보는 사람이 3초 안에 이 사이트가 뭔지 알 수 있는가
2. 가독성 — 폰트 크기, 색상 대비, 여백이 적절한가
3. CTA — 가장 중요한 버튼이 눈에 띄는가
4. 모바일 — 모바일에서도 잘 보일 것 같은가 (화면 크기 고려)

각 항목마다 "현재 상태 / 문제점 / 개선 제안" 형식으로

바로 쓸 수 있는 틀

[이미지 첨부]

이 이미지는 {{이미지 설명: 스크린샷/사진/다이어그램}}.

분석 관점:
{{분석하고 싶은 것들}}

출력 형식: {{예: 항목별 / 표 / 자유 서술}}
특별히 집중할 부분: {{예: 오른쪽 상단 / 텍스트 부분 / 그래프}}
불명확한 부분은 추측하지 말고 "불명확"으로 표시해줘.

10. 브레인스토밍 / 아이디어 발상

흐릿한 요청

아이디어 줘

어떤 분야의 아이디어인지, 어떤 제약 조건이 있는지. 이 정도 요청에는 인터넷에서 찾을 수 있는 가장 일반적인 아이디어들이 나온다.

기준을 넣은 요청

유튜브 채널 콘텐츠 아이디어를 20개 줘.

채널 주제: AI 도구 실용 활용법
주 시청자: 30~40대 직장인, AI를 업무에 써보고 싶지만 어디서 시작할지 모르는 사람
현재 구독자: 3천명 (성장 단계)
잘 됐던 콘텐츠: "ChatGPT로 보고서 초안 30분에 끝내기" (12만 뷰)
안 됐던 콘텐츠: AI 개념 설명 영상 (평균 500뷰)

조건:
- 제목에 숫자 포함 (예: "5가지", "10분 만에")
- 실용적이고 즉시 써먹을 수 있는 내용
- 이미 많이 다뤄진 ChatGPT 기초 제외
- 쇼츠로도 만들 수 있는 아이디어 절반 포함

바로 쓸 수 있는 틀

{{주제}}에 대한 아이디어를 {{개수}}개 줘.

맥락:
- 목적: {{이 아이디어를 왜 필요로 하는가}}
- 대상: {{누구를 위한 아이디어인가}}
- 제약 조건: {{예산, 시간, 기술 수준, 팀 규모 등}}

참고할 것:
- 잘 됐던 것: {{과거에 효과적이었던 것}}
- 피할 것: {{이미 시도했거나 안 맞는 방향}}

형식:
- 아이디어 제목 + 한 줄 설명
- 실현 난이도 (쉬움/보통/어려움) 표시

11. 데이터 분석 / 엑셀

흐릿한 요청

이 데이터 분석해줘 + [표 붙여넣기]

어떤 인사이트를 원하는지, 어떤 결정을 내리려고 분석하는 건지. 방향 없이 데이터만 주면 일반적인 통계 요약이 나온다.

기준을 넣은 요청

아래 월별 매출 데이터를 분석해줘.

[데이터]
{{표 붙여넣기}}

분석 목적: 다음 달 마케팅 예산 어디에 집중할지 결정하기 위해
질문:
1. 가장 매출이 높은 제품 카테고리는?
2. 전월 대비 성장률이 가장 높은/낮은 카테고리는?
3. 이 데이터에서 주목할 이상한 패턴이 있는가?
4. 다음 달 집중해야 할 카테고리와 이유

출력 형식:
- 각 질문에 번호 맞춰 답변
- 핵심 수치는 굵게 표시
- 마지막에 3줄 이내 실행 권고사항

바로 쓸 수 있는 틀

아래 데이터를 분석해줘.

[데이터]
{{데이터 또는 표}}

분석 목적: {{이 분석으로 어떤 결정을 내릴 것인가}}

알고 싶은 것:
1. {{질문 1}}
2. {{질문 2}}
3. {{질문 3}}

출력 형식:
- {{표 / bullet point / 서술형}}
- 핵심 수치 강조
- 마지막에 {{실행 권고 / 주의할 점}} 포함

12. 학습 / 개념 이해

흐릿한 요청

RAG가 뭐야?

어느 수준으로 설명해야 하는지 모른다. 초등학생 수준인지, 개발자 수준인지. 이론만 원하는지 실제 예시도 원하는지. 결국 위키피디아 수준의 설명이 나온다.

기준을 넣은 요청

RAG(Retrieval-Augmented Generation)를 설명해줘.

내 배경: Python은 잘 알고, 머신러닝 기초 개념은 이해하지만
         NLP나 LLM은 처음 공부하는 중

원하는 것:
1. 한 문장 정의
2. 왜 필요한지 (LLM만으로 안 되는 이유)
3. 실제 작동 과정 (코드 없이, 그림 설명으로)
4. 실제 사용 사례 2가지
5. 배우려면 어떤 것부터 시작해야 하는지

이해하기 쉬운 비유를 써줘. 어려운 용어는 쓸 때마다 괄호로 쉬운 설명 추가해줘.

바로 쓸 수 있는 틀

{{개념/기술/주제}}를 설명해줘.

내 배경: {{현재 수준과 관련 지식}}

원하는 것:
- 설명 깊이: {{입문 / 중급 / 심화}}
- 형식: {{비유 중심 / 예시 중심 / 도식 (텍스트로) / 코드 포함}}
- 길이: {{짧게 / 보통 / 자세하게}}

포함해줘:
- {{예: 실제 사용 사례 / 비유 / 한계점 / 다른 개념과 비교}}

피해줘:
- {{예: 너무 학문적인 표현 / 코드 예시 / 심화 개념}}

13. 면접 준비

흐릿한 요청

면접 질문 알려줘

어떤 회사인지, 어떤 직무인지, 어떤 단계의 면접인지. 없으면 아무 면접에나 쓸 수 있는 일반적인 질문 목록이 나온다.

기준을 넣은 요청

면접 준비를 도와줘.

지원 회사: 네이버 (200명+ 규모 IT 기업)
지원 직무: 백엔드 개발자 (Python, FastAPI, 3년 경력)
면접 단계: 2차 기술 면접 (화상으로 1시간)

내 강점:
- FastAPI 프로젝트 2개 경험
- Redis 캐싱 최적화 경험
- 코드 리뷰 문화 팀에서 일한 경험

걱정되는 부분:
- 알고리즘 코딩 테스트 약함
- 대규모 시스템 설계 경험 없음

요청:
1. 이 면접에서 나올 가능성 높은 질문 10개
2. 각 질문에 대한 답변 프레임워크 (STAR 기법 등)
3. 내 강점을 자연스럽게 어필하는 방법
4. 걱정되는 부분을 어떻게 솔직하면서도 긍정적으로 답할지

바로 쓸 수 있는 틀

{{직무}} 면접 준비를 도와줘.

지원 정보:
- 회사: {{회사명 또는 규모/업종}}
- 직무: {{직무명}}
- 경력: {{연차와 주요 기술 스택}}
- 면접 단계: {{서류/1차/2차/최종 등}}

내 강점: {{2~3가지}}
걱정되는 부분: {{1~2가지}}

요청:
1. 예상 질문 {{개수}}개 (기술 / 인성 / 상황 판단 구분해서)
2. 각 질문 답변 가이드
3. 내 강점을 부각할 수 있는 포인트
4. 걱정되는 부분 대응 전략

14. 회의록 작성 / 정리

흐릿한 요청

이 녹취록 정리해줘

어떤 형식으로 정리해야 하는지, 누가 볼 건지, 어떤 내용을 중점으로 봐야 하는지. 없으면 AI는 긴 서술형으로 요약하거나, 반대로 너무 짧게 뽑아서 중요한 결정 사항을 빠뜨릴 수 있다.

기준을 넣은 요청

아래 회의 내용을 회의록 형식으로 정리해줘.

[녹취록 또는 메모]
{{내용}}

회의 종류: 주간 스프린트 회의
참석자: PM 1명, 개발자 3명, 디자이너 1명
목적: 지난 주 진행 상황 공유, 이번 주 우선순위 결정

출력 형식:
- 회의 일시/참석자 헤더
- 주요 논의 사항 (항목별, 2~3줄)
- 결정된 사항 (구체적으로)
- 액션 아이템 (담당자 / 내용 / 기한 표 형식)
- 다음 회의 일정

제외: 잡담, 반복된 내용, 미결 사항
언어: 존댓말, 간결하게

15. 프레젠테이션 / 발표 자료

흐릿한 요청

AI 관련 발표 자료 만들어줘

몇 페이지짜리인지, 누구 앞에서 발표하는지, 어떤 메시지를 전달해야 하는지. 없으면 AI는 내용만 있고 스토리는 없는 자료 구조를 준다.

기준을 넣은 요청

발표 자료 구조와 핵심 내용을 만들어줘.

발표 주제: 우리 팀에 AI 코딩 도구 도입 제안
청중: 비개발자 임원진 3명
발표 시간: 15분 (Q&A 5분 별도)
목적: 도입 승인 받기 (예산 승인 포함)
핵심 메시지: "AI 도구 도입으로 개발 속도 40% 향상 가능"

구조 요청:
- 슬라이드 10~12장 구성
- 각 슬라이드 제목 + 핵심 내용 2~3줄
- 임원을 설득하는 데이터/수치 어디에 넣을지
- 예상 반론과 대응 방법

임원들이 가장 신경 쓰는 것: 비용 대비 효과, 보안 위험, 학습 부담

16. 글 교정 / 피드백

흐릿한 요청

이 글 교정해줘

맞춤법만 고치면 되는지, 문체를 바꿔야 하는지, 논리 흐름을 검토해야 하는지. 방향 없이는 어떤 기준으로 교정해야 할지 모른다.

기준을 넣은 요청

아래 글을 교정해줘.

[원문]
{{글}}

교정 관점 (해당하는 것 모두):
- 맞춤법 / 문법 오류
- 어색한 문장 자연스럽게
- 논리 흐름이 끊기는 부분

유지해야 할 것:
- 내 문체와 어투 (너무 다르게 바꾸지 말 것)
- 핵심 주장과 방향

형식:
- 수정된 전체 글
- 수정한 부분은 [수정: 원문 → 수정본] 형식으로 따로 목록 표시
- 수정 이유도 간단히

좋은 프롬프트의 공통 기준

좋은 프롬프트는 멋진 문장이 아니다.

내가 원하는 결과가 무엇인지, 왜 필요한지, 어떤 조건을 지켜야 하는지 AI 앞에 분명히 놓는 일이다. 상황이 달라지면 프롬프트도 달라져야 한다. 하지만 반복되는 기준은 있다.

맥락을 준다.
목적을 말한다.
형식을 정한다.
제약을 남긴다.
원하지 않는 방향을 함께 알려준다.

AI에게 잘 묻는다는 것은 더 긴 말을 쓰는 일이 아니다.
흐릿한 요청을 다룰 수 있는 형태로 바꾸는 일이다.