帮助文章失败在复述 UI；教育文章成功在教会底层心智，让读者不开工单就能解决下一个相邻问题。Prompt 必须强制这种区分，还要让模型把答案放进前两句。在 2026 年，一篇好的帮助文章和一个能排名的页面已经是同一件事：先给答案，再给背景。
太长不看
- 直接用下面 12 个模板。每个都内置了受众、单一目标、结构，以及「先答后述」的开头。
- 选对模型起草：要准确、要最不像 AI 腔，用 Claude Opus 4.7；要最自然的文笔和更快的输出，用 GPT-5.5。两者都够用，差距不大。
- 决定工单消解的是覆盖面。知识库有 50-200 篇文章时,大约能消解 20-35% 的一线工单;持续维护的 200+ 篇可达 40-60%(2026 年 6 月 B2B SaaS 最优水平)。
- AI 写第一、二稿,人改第三稿才发布。第一稿绝不直接上线。
适合哪些人
客服负责人、客户教育写手、写第一版帮助中心的创业者,以及写概念文档的 DevRel 团队。
什么时候不建议这样写
别用来写营销文案。底层产品坏了别先写文档,先修产品再记录。也别为一次性工单单独写文章,要记录的是「成簇的问题」,不是离群点。
为什么覆盖面比打磨更重要
对工单影响最大的杠杆,不是文章质量,而是文章数量。消解率取决于知识库真正覆盖了多少实际工单量。
| 知识库成熟度 | 文章数 | 一线工单消解率 |
|---|---|---|
| 起步期 | 0-50 | 10-20% |
| 成长期，按季度更新 | 50-200 | 20-35% |
| 最优水平，持续更新 | 200+ | 40-60% |
数据为 2026 年 6 月 B2B SaaS 的现实区间;超过 80% 通常意味着机器人在「自信地答错」,所以消解率一定要配 CSAT 或解决准确率一起看。这正是 AI 起草的意义:让小团队从 30 篇做到 200 篇,而质量不塌。
帮助文档该选哪个模型
截至 2026 年 6 月,起草面向客户的帮助内容:
- Claude Opus 4.7(Pro 每月 20 美元,或 API 每百万 token 输入/输出 5/25 美元):最不像 AI 腔,也最稳地遵守详细 brief。当一句错话会带来真实成本时最合适,而帮助文档大多如此。
- GPT-5.5(ChatGPT Plus 每月 20 美元,或 API 每百万 token 5/30 美元):文笔最自然,调语气最快。写友好的入门文案很强。
- Gemini 3.1 Pro(Google AI Pro 每月 19.99 美元):1M token 上下文,粘贴 20 篇旧文章做语气审计(模板 10)时很顺手。
不管用哪个,出力的是 Prompt。模型选择是第二位的决定。
Prompt 结构公式
每个教育 Prompt 都要带这六个要素:
- 受众:一个具体的读者,不是「用户」。
- 目标:读者要达到的一个结果。
- 语气:2-3 个锚定形容词。
- 限制:字数、禁用短语、必含事实。
- 格式:段落、列表、小标题或表格。
- 示例:1-2 条语气示例。这是匹配 voice 的最强杠杆。
下面每个模板里,运行前先把反引号里的 [占位符] 换成你的真实内容。
12 个可直接复制的 Prompt 模板
1. 任务文章骨架
Task: [task]. Audience: [userPersona]. Write a help article: (1) one-sentence answer-first opening (what the reader will achieve), (2) When you'd do this, (3) Prerequisites, (4) Numbered steps, each naming where the relevant button or screenshot lives, (5) Success check, (6) Troubleshooting (3 common issues), (7) Related links.替换: task、userPersona
2. 概念文章
Concept: [concept]. Write a 600-word article: (1) plain definition in the first 2 sentences, (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. No "in today's world" openers.替换: concept
3. 排错文章
Problem: [problem]. Write a troubleshooting article: (1) Symptoms (exact error text if any), (2) Most likely cause and how to check it, (3) Less common causes, (4) When to contact support, (5) What info to gather before contacting (logs, IDs, screenshots).替换: problem
4. 入职第一周文章
New users get stuck on [feature] in the first week. Write a "your first [feature]" article: (1) Outcome promised in the opening line, (2) 5-step walkthrough with a success check per step, (3) What changes once they 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 in 1 sentence, (3) Where the user encounters it, (4) Link to a deeper article. Be plain; skip "in plain English" wrapper sentences.替换: term
6. 帮助中心对比文章
Help-center article: "Should I use A or B?" Output: (1) Quick verdict in one line, (2) When to use A (3 specific signals), (3) When to use B (3 signals), (4) How to switch later if you chose wrong. Don't hedge.7. 最佳实践文章
Best practices for [task]. Output 5 practices. Each: (a) the practice in 6-10 words, (b) why it matters, (c) the anti-pattern to avoid. Don't restate the UI; talk about the decision behind it.替换: task
8. 行为变更说明
We just changed [behaviourChange]. Write a user-facing article: (1) What changed, (2) Why in 1 sentence, (3) What users need to do, if anything, (4) When the change is effective, (5) Where to opt out or get help.替换: behaviourChange
9. 视频脚本
Turn this help article into a 90-second walkthrough script: (1) Cold open (5s): the outcome, (2) Steps with on-screen action notes, (3) Outro (5s) with the "next" link. Keep each section under 20s of screen time. [paste article]10. 批量语气统一
Audit these help articles for tone: [articleList]. Flag articles whose tone clashes (some friendly, some terse). Pick one target tone, then suggest 5 concrete fixes per inconsistent article.替换: articleList(把文章粘进去;Gemini 3.1 Pro 的 1M 上下文能一次吃下 20+ 篇)
11. 工单驱动的选题
Top support ticket clusters this month: [tickets]. For each cluster, design a help-article angle that lets users self-solve. Output: 3 article titles plus the core promise of each. Skip one-off tickets.替换: tickets
12. 帮助文章卫生审计
Audit this help article: (1) Does the title match search intent? (2) Does the opening answer the question in one sentence? (3) Do steps have success checks? (4) Outdated screenshots? (5) Does it link to neighbour articles? Output a 5-item fix list. [paste article]容易踩的坑
- 受众模糊,输出泛泛。
- 没有语气锚,所有版本一个味。
- 没有字数、禁用短语、长度上限等限制。
- 不给示例。示例是 voice 的最强信号。
- 相信初稿。AI 会落在安全的中间值。
- 把答案埋起来。2026 年,「先答后述」的开头才会被 AI 搜索引用,所以前 100-150 字就要给出答案。
- 不做事实二审。AI「自信地答错」的频率足够高,值得专门检查。
优化技巧
- 给 1-2 条真实语气示例。「友好一点」是噪音。
- 狠下限制:字数、禁用短语、必含事实。
- 发布前把稿子念出来。
- 砍掉不承重的副词和形容词。
- 让 AI 写第一、二稿,人改第三稿,第三稿才发布。
- 每个 Prompt 都锚定一个真实读者。
- 把标题单独拿出来,对着它该排名的搜索词检验。
FAQ
- 帮助文章该用哪个模型起草?:截至 2026 年 6 月,Claude Opus 4.7 最不像 AI 腔,一句错话有成本时最稳;GPT-5.5 文笔最自然。两者都在每月 20 美元的套餐内。
- 要写多少篇,工单才会下降?:消解率大约从 50 篇起明显起效(20-35%),持续维护的 200+ 篇可达 40-60%。覆盖真实工单簇比单纯篇数更重要。
- AI 能写全稿吗?:前两稿交给 AI,第三稿交给人。第一稿绝不直接发布。
- 帮助文章该写多长?:把问题答透即可,不要更长。无论多长,答案都放进前两句。
- 多久刷新一次?:产品、受众或截图变了就更新,常青页面按季度复检。把模板 12 当检查清单跑一遍。
- 这些 Prompt 能复用到别的内容吗?:能。换受众、目标、语气即可,结构可沿用。