Prompt Engineering Guide

---
name: prompt-engineering-guide
description: 단일 통합 AI 프롬프트 엔지니어링 스킬. 모델별 전략, 이미지/동영상, 리서치/팩트체크, 슬라이드, 전문가 도메인 프라이밍, Context Engineering을 모두 이 파일에서 관리합니다.
version: 3.0.0
updated: 2026-05-12
---

# AI 프롬프트 엔지니어링 통합 가이드

> 이 가이드는 AI 모델별로 최적화된 프롬프트를 작성하는 방법을 안내합니다.
> 전문 용어가 어렵다면 아래 "용어 해설" 섹션을 먼저 확인하세요.

---

## 단일 스킬 운영 원칙

이 파일이 프롬프트 엔지니어링 계열의 단일 권원입니다. 기존에 분리되어 있던 모델별 전략, 이미지/동영상 프롬프트, 리서치/팩트체크, 슬라이드 프롬프트, 전문가 도메인 프라이밍, Context Engineering 원칙은 모두 이 파일 안의 섹션과 통합 부록으로 관리합니다.

| 영역 | 이 파일에서 볼 위치 |
|------|-------------------|
| GPT 5.x | 모델별 프롬프트 전략 → GPT-5.5 / GPT-5.2 / legacy XML |
| Claude 4.x | 모델별 프롬프트 전략 → Claude 및 통합 부록의 Claude 전략 |
| Gemini / Veo / 이미지 | Gemini, Nano Banana, 이미지/동영상 통합 부록 |
| 리서치 / 팩트체크 | 목적별 추가 블록, 글쓰기/리서치 개요, 리서치 통합 부록 |
| 슬라이드 / PPT | 중간 구조화 워크플로우, 슬라이드 통합 부록 |
| 전문가 프라이밍 | Expert Domain Priming 섹션과 전문가 DB 통합 부록 |
| Context Engineering | Context Engineering 원칙 적용, 심층 통합, CE 통합 부록 |

운영 규칙:
- `skills/`에는 이 파일 하나만 둡니다.
- GPTs/Gems 지식 파일 업로드도 이 파일 하나만 사용합니다.
- 새 모델/워크플로우가 추가되면 새 스킬 파일을 만들지 말고 이 파일의 관련 섹션에 병합합니다.
- `/prompt`와 `/prompt-sync`는 이 단일 파일을 기준으로 섹션을 라우팅합니다.

---

## 용어 해설 (Glossary)

이 가이드에서 자주 등장하는 전문 용어를 쉽게 설명합니다.

### 기본 용어

| 용어 | 쉬운 설명 | 비유 |
|------|----------|------|
| **프롬프트 (Prompt)** | AI에게 주는 지시문/질문 | 주문서 |
| **토큰 (Token)** | AI가 텍스트를 처리하는 단위 (한글 1글자 ≈ 1-2토큰) | 글자 조각 |
| **컨텍스트 (Context)** | AI가 현재 기억하고 있는 대화 내용 전체 | 대화 기억 |
| **시스템 프롬프트** | AI의 역할과 규칙을 정하는 지시문 | 직원 매뉴얼 |

### 고급 용어

| 용어 | 쉬운 설명 | 왜 중요한가? |
|------|----------|-------------|
| **Context Engineering** | AI에게 주는 정보를 효율적으로 구성하는 기술 | 같은 질문도 어떻게 물어보느냐에 따라 답이 달라짐 |
| **Progressive Disclosure** | 필요한 정보를 단계별로 제공하는 방식 | 한 번에 너무 많은 정보를 주면 AI가 혼란스러워함 |
| **Attention Budget** | AI가 한 번에 집중할 수 있는 정보량의 한계 | 사람처럼 AI도 긴 글의 중간은 잘 기억 못함 |
| **Signal-to-Noise Ratio** | 중요 정보 vs 불필요 정보의 비율 | 핵심만 전달해야 정확한 답을 받음 |
| **Lost-in-Middle** | AI가 긴 글의 중간 내용을 잘 기억하지 못하는 현상 | 중요한 건 처음이나 끝에 배치해야 함 |

### 모델별 용어

| 용어 | 해당 모델 | 쉬운 설명 |
|------|----------|----------|
| **reasoning_effort** | GPT-5.2 | AI가 생각하는 깊이 조절 (none~xhigh) |
| **Extended Thinking** | Claude 4.5 | AI가 더 깊이 생각하게 하는 기능 |
| **Adaptive Thinking** | Claude 4.6 | 모델이 자율적으로 사고 깊이를 결정하는 기능 |
| **Effort Parameter** | Claude 4.6 | 응답 상세도 제어 (low/medium/high/max) |
| **Compaction** | GPT-5.2, Claude 4.6 | 대화 내용을 요약해서 토큰을 절약하는 기능 |
| **Anti-Prompting** | GPT-5.2-Codex | 하지 말아야 할 프롬프팅 패턴 |
| **Scaffolding** | 전체 | 단계별로 구조화해서 접근하는 방법 |

### XML 태그 용어

GPT-5.2에서 자주 사용하는 XML 태그들:

| 태그 | 목적 | 언제 사용? |
|------|------|-----------|
| `<output_verbosity_spec>` | 응답 길이 제어 | **항상** (가장 중요!) |
| `<design_and_scope_constraints>` | 범위 벗어남 방지 | 코딩/디자인 |
| `<uncertainty_and_ambiguity>` | 불확실할 때 행동 규칙 | 분석/리서치 |
| `<tool_usage_rules>` | 도구 사용 규칙 | 에이전트/자동화 |
| `<default_to_action>` | 질문 대신 행동 우선 | Claude 에이전트 |
| `<investigate_before_answering>` | 환각 방지 (코드 탐색 필수) | Claude 코딩/분석 |
| `<avoid_overengineering>` | 과잉 구현 방지 | Claude 에이전트 |
| `<frontend_aesthetics>` | UI 디자인 가이드 | Claude 프론트엔드 |
| `<output_contract>` | 출력 형식/길이/구조 계약 | GPT-5.4 에이전트 |
| `<follow_through_policy>` | 도구 호출 지속성 규칙 | GPT-5.4 에이전트 |
| `<completeness_contract>` | 모든 항목 처리 보장 | GPT-5.4 에이전트 |
| `<tool_persistence>` | 도구 실패 시 재시도 규칙 | GPT-5.4 에이전트 |
| `<eagerness_control>` | 탐색 적극성 양방향 제어 | GPT-5.4 에이전트 |

> **Claude 4.5/4.6 XML 구조 상세**: `prompt-engineering-guide.md` 스킬의 Part 12 참조
> **GPT-5.4 에이전틱 패턴 상세**: `prompt-engineering-guide.md` 하단 "Legacy GPT-5.2/5.4 XML Stack" 섹션 참조

---

## Context Engineering 원칙 적용

`prompt-engineering-guide` 스킬의 핵심 원칙을 프롬프트 생성에 적용합니다.

### 1. Progressive Disclosure
- 프롬프트를 섹션별로 구조화
- 필수 정보만 포함, 부가 정보는 요청 시 제공
- 시스템 프롬프트 → 지시사항 → 예시 순서

### 2. Attention Budget 관리
- 중요 지시사항은 **시작 또는 끝**에 배치
- 중간 부분에는 맥락/배경 정보 배치
- "Lost in the middle" 현상 방지

### 3. Signal-to-Noise Ratio 최적화
- 불필요한 서술 제거
- 핵심 지시사항만 포함
- 모호한 표현 대신 구체적 지시

### 4. Context Quality > Quantity
- 최소 토큰으로 최대 효과
- 반복 제거, 핵심만 유지
- 명확한 구조로 파싱 용이성 확보

---

## Expert Domain Priming (전문가 도메인 프라이밍)

> **"act as an expert" 대신 실제 전문가를 지명하고, 그들의 전문 용어를 사용하라**

### 원칙

1. **실제 전문가 지명** → LLM 잠재 공간의 전문 영역 활성화 (MoE 라우팅 시그널)
2. **전문 용어 사용** → 문제 공간 축소 (정보의 좌표를 정확히 찍음)
3. **금지어 제거**: 알아서잘, 깔끔하게, 대충, 자세히, 완벽하게, 적당히
4. **단어의 5가지 역할 점검**: 범위(Target Scope) / 목적(Goal) / 형식(Format) / 금지(No-Go) / 행동(Behavior)

### 적용 (5단계)