帮助文章失败在复述 UI。教育文章成功在教底层心智，让用户自己解决相邻问题。好的 Prompt 强制这种区分。
适合哪些场景
客服负责人、客户教育写手、写第一版帮助中心的创业者、写概念文档的 DevRel。
什么时候不建议这样写 Prompt
别用来写营销文案。底层产品坏了别先写文档——先修产品。
Prompt 结构公式
每个教育 Prompt 都要带这六个要素：
- 读者：一个具体的人。
- 目标：一个动作——读完 / 点击 / 同意 / 分享。
- 语气：2-3 个锚定形容词。
- 限制：字数、禁用短语、必含事实。
- 格式：段落、列表、小标题、表格。
- 示例：1-2 条语气示例——匹配 voice 的最强杠杆。
这套 Prompt 适合用在哪
- 概念文章
- 任务步骤文章
- 排错文章
- 词汇表条目
- walkthrough 视频脚本
12 个可直接复制的 Prompt 模板
1. 任务文章骨架
Task: `{task}`. Audience: `{userPersona}`. Write a help article: (1) When you'd do this (one paragraph), (2) Prerequisites, (3) Numbered steps with one screenshot location per step, (4) Success check, (5) Troubleshooting (3 common issues), (6) Related links.可替换变量： task, userPersona
2. 概念文章
Concept: `{concept}`. Write a 600-word article: (1) What it is in plain English, (2) Why it exists (the problem it solves), (3) How it works at a high level, (4) Where you'll see it in the product, (5) Two common misunderstandings.可替换变量： concept
3. 排错文章
Problem: `{problem}`. Write a troubleshooting article: (1) Symptoms, (2) Most likely cause (with how to check), (3) Less common causes, (4) When to contact support, (5) How to gather the right info before contacting.可替换变量： problem
4. 入职第一周文章
New users get stuck on `{feature}` in the first week. Write a "your first {feature}" article: (1) Outcome promised, (2) 5-step walkthrough with success checks, (3) "What changes once you do this", (4) Next thing to learn.可替换变量： feature
5. 词汇表条目
Term: `{term}`. Write a 100-word glossary entry: (1) Definition in 1 sentence, (2) Why it matters here (1 sentence), (3) Where the user encounters it, (4) Link to deeper article. No "in plain English" wrapper sentences — be plain.可替换变量： term
6. 帮助中心对比文章
Help-center article: "Should I use A or B?" Output: (1) Quick verdict (1-line), (2) When to use A (3 specific signals), (3) When to use B (3 signals), (4) How to migrate later if you choose wrong. Don't hedge.7. 最佳实践文章
Best practices for `{task}`. Output 5 practices. Each: (a) Practice in 6-10 words, (b) Why it matters, (c) Anti-pattern to avoid. Don't restate the UI — talk about the decision.可替换变量： task
8. 行为变更说明
We just changed `{behaviourChange}`. Write a user-facing article: (1) What changed, (2) Why (1 sentence), (3) What users need to do (if anything), (4) When the change is effective, (5) Where to opt out / get help.可替换变量： behaviourChange
9. 视频脚本
Turn this help article into a 90-second walkthrough video script: (1) Cold open (5s) — outcome, (2) Steps with screen-action notes, (3) Outro (5s) — "next" link. Each section ≤ 20s of screen time.10. 批量语气统一
Audit these 20 help articles: {articleList}. Flag articles with inconsistent tone (some friendly, some terse). Pick one target tone, suggest 5 fixes per inconsistent article.可替换变量： articleList
11. 工单驱动的文章选题
Top support tickets this month: {tickets}. For each cluster, design a help article angle that would let users self-solve. Output: 3 article titles + their core promise. Don't propose articles for one-off tickets.可替换变量： tickets
12. 帮助文章卫生
Audit this help article: (1) Title matches search intent? (2) Lede answers in one sentence? (3) Steps have success checks? (4) Outdated screenshots? (5) Links to neighbours? Output: a 5-item fix list.容易踩的坑
- 受众模糊——输出泛泛。
- 没语气锚——所有版本一个味。
- 没限制——字数、禁用、长度。
- 不给示例——语气最强信号。
- 相信初稿——AI 落安全中间值。
- AI 口头禅不删。
- 事实不二审——AI 偶尔自信地错。
优化技巧
- 一定给 1-2 条语气示例。
- 狠下限制。
- 发布前念出来。
- 砍不承重的副词形容词。
- AI 出前两稿，人改第三稿。
- 锚定真实读者中的一个人。
- 标题单看能否传递信息。
实操加深
使用这些 prompt 时，不要只替换一个主题词就直接交付。围绕「客户教育文章 Prompt：帮助文章模板」先补齐受众、渠道、长度、语气、参考样例、禁止样式和成功标准，再让模型输出 2 个不同版本做横向比较。好的结果应该能被另一个人直接复用，而不是只有顺滑但空泛的表达。
如果输出看起来像通用模板，下一轮要增加一个真实场景、一个反例和一个可检查指标，例如点击率、转化动作、字数、平台限制或品牌禁区。这样改出来的内容才更像可用资产，而不是一次性的灵感草稿。
FAQ
- 文章多长？: 按渠道——注意力短的地方就短。
- AI 写全稿？: 前两稿 AI，第三稿人。
- 多久刷新？: 受众或事实变了，或季度重看常青内容。
- 不审就发？: 别——AI 自信但不一定对。
- 单一 voice 还是分渠道？: 品牌 voice 一个，渠道在轴内漂移。
- 这套 Prompt 能复用吗？: 能——换受众 / 目标 / voice 即可。