多数人用 AI 写知识库文章,做法是打开对话框说一句「帮我写一篇关于 X 的文章」,然后把生成结果稍作润色就贴进知识库。问题在于:知识库文章的目标不是「读起来像文章」,而是让遇到具体问题的人能照着做完。没有模板约束,AI 会写出结构松散、步骤含糊、缺少前置条件的说明文,读者看完仍不知道下一步该点哪里。模板的作用是把「写得好」换成「写得可用」。

先判断:这篇文章是给人查的,还是给人读的

知识库文章分两类:查询型(读者带着具体问题来,要快速找到答案)和背景型(读者要理解一个概念或流程)。判断方法很简单——看读者打开它时脑子里有没有一个具体问句。有问句的,按查询型写:标题即问题,正文先给答案,再补步骤。没有问句的,按背景型写:先给定义和边界,再给例子。两类混写是知识库最常见的失败,AI 尤其容易把查询型写成背景型,因为它倾向于「完整介绍」。

适用场景:哪些内容适合用模板交给 AI

适合的场景有三个共同点:结构稳定、事实来源在你手里、读者反馈可验证。具体包括:操作步骤类(如何配置、如何提交、如何排查)、常见问题类(同一问题被反复问)、术语与规则解释类(内部名词、字段含义、审批口径)。不适合直接交给 AI 的是:涉及未公开决策背景的内容、需要引用具体数据且你无法核对的内容、以及责任归属敏感的流程说明。后一类可以让 AI 起草结构,但事实部分必须由知情人逐条填。

步骤:先定骨架,再让 AI 填肉

不要让 AI 从零想结构,结构由你给。做法是先在文档里写四块骨架:读者是谁、他遇到什么情况、他要完成什么、完成后如何确认成功。然后把这四块连同写作约束一起交给 AI。

  • 第一步,写一句读者画像,越具体越好,例如「第一次使用后台的新同事」。
  • 第二步,列出必须出现的要素:前置条件、操作步骤、每步的预期结果、失败时的排查方向。
  • 第三步,用下面的提示词让 AI 产出初稿,一次只写一节,避免长文失控。
  • 第四步,人工替换所有占位内容,删除 AI 自行补充但你无法核实的信息。
你是知识库编辑。请按以下约束写一节操作说明。
读者:{填写读者画像,例如“第一次使用审批后台的新同事”}
他要解决的问题:{一句话}
前置条件:{逐条列出}
已知步骤:{按顺序列出你掌握的操作,不确定的写“待确认”}
输出要求:
1. 标题写成读者会搜索的问句;
2. 开头两句内给出结论或最短路径;
3. 步骤用编号,每步写“做什么”和“做完会看到什么”;
4. 不确定的内容标注“待确认”,不要自行补全;
5. 不使用形容词和评价性语言,不写“非常简单”“轻松搞定”;
6. 全文不超过 400 字。

拿到初稿后,重点检查三处:步骤之间有没有跳跃、每步的结果是否可观察、前置条件是否漏掉权限或环境要求。这三处是 AI 最容易含糊过去的地方。

验证:用三个动作检验文章是否可用

判断一篇文章能不能进知识库,不看它读起来顺不顺,看它能不能被照着执行。做三个动作:其一,找一个没做过这件事的同事,只给他这篇文章,看他在哪一步停下来提问,停下的位置就是缺步骤的位置;其二,把文章里的每个链接、每个按钮名称、每个字段名对照实际界面核一遍,AI 生成的界面描述经常是「合理但不存在的」;其三,隔一周自己再读一遍,看是否还能独立完成,记忆衰减后仍能读懂,说明前置条件写全了。

什么情况下不要用这个模板

三种情况应放弃 AI 起草:一是内容涉及合规、安全或对外承诺,措辞需要逐字审定,AI 初稿反而增加校对成本;二是流程本身尚未稳定,每周都在变,此时写知识库是在固化错误,应先梳理流程;三是读者群体差异极大,同一篇文章要同时服务新人和专家,模板会迫使你折中,正确做法是拆成两篇。另外,如果团队没有维护知识库的习惯,AI 只会更快地生产过时文档,这种情况下先解决维护责任,再谈写作效率。