专业写作风格
了解新闻、说服、说明和技术写作模式
专业写作风格 是 CoddyKit 上的免费 AI Prompt Engineering 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 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 框架：
- 问题——放大读者正在经历的痛点
- 激化——加深这个问题带来的情感共鸣
- 解决方案——将您提供的方案呈现为解决之道
适用场景：销售文案、提案、演示文稿、资助申请和变革管理备忘录。
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激发欲望——让读者对解决方案产生情感上的渴望
- 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）：问题 → 激化 → 解决方案，或吸引注意力 → 引发兴趣 → 激发欲望 → 促成行动——适用于销售、营销、提案
- 指导性写作：编号步骤、祈使动词、每个步骤一个操作、验证——适用于操作指南、教程、入门引导
- 技术性写作：精准、简洁、定义术语、量化行为——适用于应用程序编程接口文档、工程规范提案、规范文档
在提示词中指定风格，模型就会自动应用相应的结构模式。
常见问题解答
「专业写作风格」课时是免费的吗？
是的 — 「专业写作风格」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 AI Prompt Engineering 课程的其余内容，请升级到 CoddyKit PRO。 AI Prompt Engineering 课程共包含 4 节课。
「专业写作风格」这节课中我会学到什么？
了解新闻、说服、说明和技术写作模式 你通过在浏览器中直接运行的动手代码来练习 AI Prompt Engineering，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 AI Prompt Engineering 需要有经验吗？
无需任何先前经验。CoddyKit 上的 AI Prompt Engineering 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「专业写作风格」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 AI Prompt Engineering 课中编写并运行代码吗？
能。每节 AI Prompt Engineering 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 正式语气与非正式语气
- 指定受众
- 专业写作风格
- 调整词汇难度