전문적인 글쓰기 스타일
저널리즘, 설득, 설명 및 기술 문서 작성 방식을 살펴봅니다.
전문적인 글쓰기 스타일은(는) CoddyKit의 무료 AI Prompt Engineering 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 AI Prompt Engineering 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. AI Prompt Engineering 강의에는 총 4개의 강의가 포함되어 있습니다.
사고의 구조를 만드는 스타일
전문적인 글쓰기는 어조만의 문제가 아니라 구조와 의도의 문제이기도 합니다. 각 직업 분야에서는 특정한 소통 목표를 달성하기 위해 서로 다른 글쓰기 스타일이 발전해 왔습니다.
이러한 스타일과 요청 방법을 알면 저널리즘식, 설득식, 교육식, 기술식 글쓰기처럼 검증된 글쓰기 패턴을 활용할 수 있습니다.
저널리즘식 스타일: 역피라미드
저널리즘식 스타일은 역피라미드 구조를 사용합니다. 가장 중요한 정보를 먼저 제시하고, 뒷받침하는 세부 정보를 두 번째로, 배경 정보를 마지막에 제시합니다.
특징은 다음과 같습니다.
- 첫 문장에서 누가, 무엇을, 언제, 어디서, 왜를 답합니다
- 각 문단이 독립적으로 기능할 수 있습니다
- 서론을 길게 준비하지 않고 즉시 핵심으로 들어갑니다
- 문장과 문단이 짧습니다
- 결론을 덧붙이지 않습니다. 이야기 자체가 말하게 합니다
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=200,
messages=[{
'role': 'user',
'content': (
'Write in journalistic inverted-pyramid style. '
'Lead immediately with the most important fact. '
'No setup, no preamble. Short sentences, short paragraphs. '
'Max 100 words.\n\n'
'Announce: Anthropic has released Claude 4, achieving a new benchmark score of 94% '
'on a standard reasoning test, surpassing previous models by 8 percentage points. '
'Available via API today. Pricing unchanged.'
)
}]
)
print(response.content[0].text)비즈니스 콘텐츠에 저널리즘식 스타일 사용하기
역피라미드 구조는 뉴스 외에도 유용합니다. 다음과 같은 경우에 저널리즘식 스타일을 사용하세요.
- 리더가 첫 문단만 훑어보는 내부 메모
- 바쁜 엔지니어가 읽는 제품 출시 기록
- 시간이 매우 제한된 경영진 브리핑
- 이메일 제목과 첫 문장
다음과 같이 요청합니다. '이 내용을 저널리즘식 스타일로 작성해 주세요. 첫 문장에 가장 중요한 사실을 넣고, 나머지는 뒷받침하는 세부 정보로 작성해 주세요.'
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write an internal engineering memo using journalistic style. '
'Most critical information in sentence 1. Max 3 short paragraphs.\n\n'
'Facts: We will have a 30-minute planned downtime on Saturday, March 15 at 2 AM UTC. '
'Cause: database migration to PostgreSQL 16. '
'Impact: all API endpoints unavailable. '
'Action needed: engineers should not deploy during this window. '
'Status page will show updates.'
)
}]
)
print(response.choices[0].message.content)설득식 스타일: 문제와 해결책
설득식 글쓰기는 명확한 구조를 따릅니다. 먼저 문제를 제시한 다음 해결책을 그 답으로 제시합니다. 이를 PAS 프레임워크라고도 합니다.
- P문제 — 독자가 겪는 고통을 부각합니다
- A자극 — 문제의 감정적 울림을 심화합니다
- S해결책 — 제공하는 제품이나 서비스를 해결책으로 제시합니다
다음과 같은 경우에 사용합니다. 판매 문구, 제안서, 발표 자료, 보조금 신청서, 변화 관리 메모
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=250,
messages=[{
'role': 'user',
'content': (
'Write landing page copy using the Problem-Agitate-Solution (PAS) persuasive framework.\n'
'Structure:\n'
'- Paragraph 1 (Problem): name the pain clearly\n'
'- Paragraph 2 (Agitate): make the reader feel how serious this problem is\n'
'- Paragraph 3 (Solution): introduce the product as the answer\n'
'Product: A tool that automatically generates commit messages from git diffs.\n'
'Audience: developers who write bad or no commit messages under time pressure.\n'
'Max 150 words total.'
)
}]
)
print(response.content[0].text)설득형 문체: AIDA 프레임워크
AIDA 프레임워크는 마케팅에서 널리 사용되는 또 다른 설득 구조입니다:
- A주의 — 독자의 시선을 즉시 사로잡습니다
- I관심 — 호기심과 관련성을 높입니다
- D욕구 — 해결책을 원하는 감정을 create합니다
- A행동 — 명확한 CTA(행동 유도 문구)를 제시합니다
요청문: '다음 내용을 AIDA 프레임워크를 사용해 작성하세요: 주의, 관심, 욕구, 행동.'
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write a cold email using the AIDA framework. '
'Label each section: [ATTENTION], [INTEREST], [DESIRE], [ACTION].\n'
'Product: AI-powered code review tool that catches security bugs.\n'
'Audience: CTO at a 50-150 person software company.\n'
'Length: max 150 words. Tone: direct, professional, no hype.'
)
}]
)
print(response.choices[0].message.content)교육형 문체: 단계별 설명
교육형 글쓰기는 독자를 과정에 따라 안내합니다. 다음을 우선합니다:
- 번호가 매겨진 단계 — 각 작업을 명확히 구분합니다
- 명령형 동사 — '클릭', '입력', '선택', '실행'
- 단계마다 하나의 작업 — 여러 작업을 한 단계에 넣지 않습니다
- 명시적인 사전 조건 — 시작하기 전에 독자에게 필요한 사항입니다
- 확인 단계 — 각 단계가 제대로 작동했는지 확인하는 방법입니다
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=400,
messages=[{
'role': 'user',
'content': (
'Write step-by-step instructional documentation for setting up a Python virtual environment.\n'
'Style rules:\n'
'- Begin with Prerequisites (1-3 items)\n'
'- Number every step\n'
'- Start each step with an imperative verb\n'
'- Maximum one action per step\n'
'- Include the exact command to run in a bash code block where applicable\n'
'- Add a verification command after every 2-3 steps\n'
'Audience: first-year developer who knows Python basics but never used a terminal.'
)
}]
)
print(response.content[0].text)교육형 문체: 사용 방법 안내문
사용 방법 안내문은 웹 콘텐츠를 위한 특정 형태의 교육형 글쓰기입니다. 다음 구조를 따릅니다:
- 도입부 — 이것이 중요한 이유를 1~2문장으로 설명합니다
- 배우게 될 내용(간략히)
- 사전 조건
- 단계(번호를 매겨 명확하게 제시)
- 결과 — 완료한 후 독자에게 남는 것입니다
- 다음 단계 또는 추가 읽을거리
올바른 구조를 얻으려면 각 섹션을 명시적으로 요청하세요.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write a how-to article outline (headings + 1-sentence descriptions only) '
'for "How to Set Up GitHub Actions for Python Testing".\n'
'Include exactly:\n'
'- 1 hook sentence\n'
'- What You Will Learn section (3 bullets)\n'
'- Prerequisites section (3 bullets)\n'
'- 5 numbered steps with H3 headings\n'
'- Final Result section (1 sentence)\n'
'- 2 Next Steps bullets\n'
'No body content — outline only.'
)
}]
)
print(response.choices[0].message.content)기술 문체: 정확하고 간결하게
기술 문서는 설득보다 정확성을, 친밀감보다 간결성을 우선합니다. 특징은 다음과 같습니다:
- 처음 사용할 때 모든 용어를 정의합니다
- 전체에서 일관된 용어를 사용합니다(기술 용어에 동의어를 사용하지 않습니다)
- 짧고 직접적인 문장을 사용합니다 — 평균 12~15단어입니다
- 주로 능동태를 사용합니다
- 수량화할 수 있는 모든 것을 수량화합니다
- 정확성을 높이는 경우가 아니면 은유나 비유를 사용하지 않습니다
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=250,
messages=[{
'role': 'user',
'content': (
'Write technical documentation for a Python function that rate-limits API calls.\n'
'Technical style rules:\n'
'- Define every parameter and return value precisely\n'
'- Include type annotations in the description\n'
'- Quantify all behaviors (e.g., "raises ValueError after 3 retries")\n'
'- Active voice, no passive\n'
'- Max 15 words per sentence\n'
'- No analogies or metaphors\n'
'Function: takes a callable, max_calls (int), window_seconds (int). '
'Returns a wrapped callable that enforces the rate limit.'
)
}]
)
print(response.content[0].text)알맞은 문체 선택하기
목표에 맞게 문체를 선택하는 것이 핵심 기술입니다:
- 저널리즘식: 훑어 읽기가 예상되는 뉴스, 메모, 공지
- 설득형(PAS/AIDA): 영업, 마케팅, 변화 관리, 제안서
- 교육형: 사용 방법 안내서, 온보딩, 기술 튜토리얼
- 기술 문체: 응용 프로그래밍 인터페이스 문서, 사양 문서, 엔지니어링 기술 제안 문서
실제 문서는 대부분 여러 문체를 결합합니다. 블로그 게시물은 도입부에서 저널리즘식 문체를, 본문에서 교육형 문체를, 마지막에서 설득형 CTA를 사용할 수 있습니다.
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
# Hybrid style: journalistic intro + instructional body + persuasive CTA
response = client.chat.completions.create(
model='gpt-4o',
messages=[{
'role': 'user',
'content': (
'Write a 3-section technical blog post intro for "How to Cut Your AWS Bill by 40%".\n'
'Section 1 (Journalistic): 1 sentence hook — state the key finding immediately.\n'
'Section 2 (Instructional): 3-bullet overview of what the reader will learn/do.\n'
'Section 3 (Persuasive): 1 sentence CTA to continue reading.\n'
'Audience: AWS-using startup CTOs. Tone: direct, no hype.'
)
}]
)
print(response.choices[0].message.content)섹션 전체에서 문체 일관성 유지하기
하나의 문서 안에서 문체가 일관되지 않으면 읽는 흐름이 끊깁니다. 설득형 도입부 뒤에 건조한 기술 문장이 이어지면 읽기가 불편해집니다. 문체를 섞을 때는 다음 규칙을 지키세요:
- 내용의 70% 이상에는 주된 문체를 사용합니다
- 문체를 전환할 때는 전환 표현이 도움이 됩니다(예: '다음은 시작하는 방법입니다:')
- 혼합형 문체가 필요하다면 프롬프트에서 각 섹션의 문체를 명시적으로 정의합니다
- 항상 시작할 때 사용한 문체로 끝내세요 — 글이 완결된 느낌을 줍니다
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=300,
messages=[{
'role': 'user',
'content': (
'Write a product launch announcement combining three styles — '
'label each section.\n\n'
'[JOURNALISTIC LEAD]: 2-sentence news-style announcement of the launch.\n'
'[PERSUASIVE VALUE]: 2-sentence why-it-matters with problem-solution framing.\n'
'[INSTRUCTIONAL NEXT STEP]: 3 numbered steps to get started.\n\n'
'Product: Sentry AI — error monitoring with automatic root cause analysis.\n'
'Audience: developer teams who currently spend hours debugging production errors.'
)
}]
)
print(response.content[0].text)프롬프트에서 문체 이름 지정하기
전문적인 글쓰기 문체를 활성화하는 가장 간단한 방법은 프롬프트에 문체 이름을 직접 적는 것입니다:
- '저널리즘식 역피라미드 문체로 작성하세요'
- 'PAS(문제-자극-해결책) 프레임워크를 사용하세요'
- '단계별 교육 문서를 작성하세요'
- '정확하고 간결한 기술 문서 문체로 작성하세요'
모델은 이러한 문체 이름을 인식하고 관련된 구조적 패턴을 자동으로 적용합니다. 일반적으로 추가 설명은 필요하지 않습니다.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
style_names = [
'journalistic inverted-pyramid style',
'PAS (Problem-Agitate-Solution) persuasive framework',
'step-by-step instructional documentation style',
'technical documentation style — precise and concise'
]
topic = 'how to reset a forgotten password in our web app'
for style in style_names:
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=80,
messages=[{
'role': 'user',
'content': f'Write about {topic} using {style}. Max 3 sentences or 3 steps.'
}]
)
print(f'Style: {style[:45]}...')
print(response.content[0].text.strip())
print()지식 확인
한 개발자가 새로운 응용 프로그래밍 인터페이스를 위한 온보딩 문서를 작성하고 있습니다. 사용자가 지원팀에 문의하지 않고 인증 설정을 성공적으로 완료하기를 원합니다. 기본 문체로 어떤 글쓰기 문체가 가장 적절할까요?
전문적인 글쓰기 문체 — 복습
네 가지 전문적인 글쓰기 문체와 각 문체를 사용하는 경우는 다음과 같습니다:
- 저널리즘식: 역피라미드 구조, 가장 중요한 내용을 먼저 제시, 짧은 문장 — 메모, 공지, 뉴스에 사용합니다
- 설득형(PAS/AIDA): 문제 → 자극 → 해결책 또는 주의 → 관심 → 욕구 → 행동 — 영업, 마케팅, 제안서에 사용합니다
- 교육형: 번호가 매겨진 단계, 명령형 동사, 단계마다 하나의 작업, 확인 — 사용 방법 안내서, 튜토리얼, 온보딩에 사용합니다
- 기술 문체: 정확하고 간결하며, 용어를 정의하고 동작을 수량화합니다 — 응용 프로그래밍 인터페이스 문서, 기술 제안 문서, 사양 문서에 사용합니다
프롬프트에 문체 이름을 적으면 모델이 구조적 패턴을 자동으로 적용합니다.
자주 묻는 질문
“전문적인 글쓰기 스타일” 강의는 무료인가요?
네 — “전문적인 글쓰기 스타일” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 AI Prompt Engineering 강의 전체를 잠금 해제할 수 있습니다. AI Prompt Engineering 강의에는 총 4개의 강의가 포함되어 있습니다.
“전문적인 글쓰기 스타일”에서 뭘 배우나요?
저널리즘, 설득, 설명 및 기술 문서 작성 방식을 살펴봅니다. 브라우저에서 직접 실행하는 실습 코드로 AI Prompt Engineering을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
AI Prompt Engineering을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 AI Prompt Engineering은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“전문적인 글쓰기 스타일” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 AI Prompt Engineering 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 AI Prompt Engineering 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 격식 있는 어조와 비격식적인 어조
- 대상 독자 지정하기
- 전문적인 글쓰기 스타일
- 어휘 수준 조정하기