语雀 AI 写周报、沉淀团队知识库、生成新人文档,三处各用不同提示

文章导读
语雀里写周报、沉淀知识库、生成新人文档,共用的是同一套模型能力,但三处的输入材料、输出结构和复核强度并不一样。周报是给上级快速扫读的短期记录,只要把本周真实发生的事对上号就行;知识库条目要能被搜索命中、半年后还能读懂;新人文档则要顺着读者的上手顺序讲清上下文。把同一个提示词套到三处,常见结果是周报写成流水账式的文档、知识库条目写完搜不到、新人文档全是大道理。更稳的做法是先固定三套提示词骨架,再按场
📋 目录
  1. A 周报场景:拿本周文档改动记录当输入材料
  2. B 知识库沉淀:把散落的讨论整理成一篇可检索文档
  3. C 新人文档:以已有老文档为底稿生成上手路径
  4. D 把三套提示词的差异点并排列出来
A A

语雀里写周报、沉淀知识库、生成新人文档,共用的是同一套模型能力,但三处的输入材料、输出结构和复核强度并不一样。周报是给上级快速扫读的短期记录,只要把本周真实发生的事对上号就行;知识库条目要能被搜索命中、半年后还能读懂;新人文档则要顺着读者的上手顺序讲清上下文。把同一个提示词套到三处,常见结果是周报写成流水账式的文档、知识库条目写完搜不到、新人文档全是大道理。更稳的做法是先固定三套提示词骨架,再按场景分别规定“喂什么材料、出什么结构、谁来复核”。

三套提示词可以共用同一份填空结构,但必须换掉输入材料、输出结构和复核人。周报只喂本周文档更新记录与待办清单,输出条目必须带文档链接,复核人是你自己;知识库沉淀要给标题命名规则和已有标签列表,复核人是团队里检索这个主题的人;新人文档以已有老文档为底稿,只做串联和留白,术语、权限入口、变动中的设计这几类前置知识必须人工补写。判断标准是可核验的:搜一下标题关键词能不能命中、把文档给一个没参与的人读一遍能否看懂。

周报场景:拿本周文档改动记录当输入材料

周报最怕写成“持续推进、积极配合”这种句子,原因通常不是模型不行,而是输入只有你脑子里的印象。把材料换成语雀里可查的东西:知识库文档的最近更新记录、本周新建的文档、待办清单的完成与未完成项、以及群里讨论后落到文档上的结论。模型的任务不是替你想做了什么,而是把这些材料压成条目。

可用的输入材料清单建议这样收集:本周修改过的文档标题加链接加关键改动片段(从文档的更新记录里逐条复制)、待办清单里状态变化过的条目、本周定下来但还没写进文档的结论(手动补一句)。输出条目按“进展 / 影响 / 待确认 / 下周”四段走,每条进展后面挂文档链接,材料里没写的影响就直接写“材料未说明”,不要让它编。

你是我的周报整理助手,只根据我提供的材料写,不补充材料里没有的工作。

【输入材料】
1. 本周修改过的文档:<逐条粘贴 标题 + 链接 + 关键改动片段>
2. 待办清单:<粘贴已完成 / 未完成条目>
3. 需要同步的讨论结论:<粘贴>

【输出】按下面四类,每类不超过 4 条:
- 进展:做了什么 + 对应文档链接
- 影响:对谁有用、解决了什么问题;材料未说明就写“材料未说明”
- 待确认:需要谁拍板、卡在哪里
- 下周:从待办清单里挑,不超过 3 条

【限制】不用“持续推进”“赋能”“积极配合”这类词;没有对应文档链接的事项标注“无文档”。

验证方式很直接:周报发出去后,随便挑一条进展点开链接,能不能看到对应改动。点不开的条目,就是材料没喂够。

知识库沉淀:把散落的讨论整理成一篇可检索文档

内容写出来了却搜不到,多半是三个地方没定:标题用词和读者搜索用词不一致、标签要么不写要么随手新造、目录树归属靠感觉。这三件事都可以在提示词里写成硬约束。

语雀 AI 写周报、沉淀团队知识库、生成新人文档,三处各用不同提示

标题命名规则

建议统一成“主体 + 动作或问题 + 限定范围”,例如“语雀知识库 标签命名 规则”“订单服务 本地启动 步骤”“导出接口 超时 排查”。避免用“关于……的说明”“一些记录”这类开头,因为搜索时没人这么输。同一主题的系列文档,把主体词放在标题最前面,方便在搜索结果里聚成一组。

标签选择依据

标签不要现造,先把知识库现有标签列表贴给模型,要求它只能从列表里选 2 到 4 个。判断依据是:这个标签点进去,会不会落到一堆不相干文档里;同义标签(如“排障”“排查”)如果已经存在两个,先合并再让模型选,否则越标越散。

目录归属的判断方式

一篇文档只放一个主目录,其余关联靠标签和正文里的文档链接解决。判断方式是问“半年后来找这篇文档的人,会从哪个入口进”,答案就是主目录。如果答案有两个,通常说明这篇该拆成两篇,或者其中一篇只是另一篇的一节。

把下面的讨论整理成一篇能被搜到的知识库文档。

【标题】主体 + 动作或问题 + 限定范围,例如“订单服务 本地启动 步骤”
【标签】只能从下面这个已有列表里选 2-4 个:<粘贴现有标签>
【目录】放到 <目录名> 下
【正文结构】一句话结论 → 适用场景 → 操作步骤(带命令 / 配置 / 截图占位)→ 常见失败现象 → 相关文档链接
【限制】不写背景故事和心路历程;不确定的步骤标注“待确认”,不要替我补齐。

新人文档:以已有老文档为底稿生成上手路径

新人文档写空话,是因为模型手上没有真实材料,只能输出通用建议。解决办法是把它当成“导读”而不是“百科”:底稿用团队已有文档,模型负责挑选和排序,不负责重新讲一遍。

语雀 AI 写周报、沉淀团队知识库、生成新人文档,三处各用不同提示

建议引用这几类老文档:环境搭建与本地启动步骤、权限与账号申请说明、代码或提交规范、业务与架构说明、常见问题与排障记录。串联顺序按新人实际卡壳的先后走:先能跑起来(环境搭建、权限申请),再能提交代码(规范),再理解在做什么(业务架构),最后是遇到问题去哪儿查(常见问题)。每一节都写清“先读哪篇、读完能做到什么、这篇里可以跳过哪部分”。

必须人工补写的部分通常是四类:内部术语和黑话、权限申请的入口和审批人、仍在变动中的设计、以及“为什么当初这么设计”的历史包袱。这些内容要么不在文档里,要么写得很旧,交给模型生成容易变成编造。让模型把这些位置留成空位,你逐条填。

根据我给的已有文档,生成一份新人上手路径。

【底稿范围】只引用我粘贴的文档标题和链接,不要自己编文档名
【串联顺序】环境搭建 → 权限申请 → 代码规范 → 业务 / 架构说明 → 常见问题
【每节格式】先读哪篇(带链接)+ 读完能做到什么 + 本篇可跳过哪部分
【人工补写区】下面四类留空位给我填:内部术语、权限申请入口与审批人、仍在变动中的设计、历史设计原因

【限制】不要复述整篇文档的正文,只写“读这篇、看这部分、跳过这部分”。

把三套提示词的差异点并排列出来

三处不能共用一套提示词,本质是输出要给不同的人用、复核强度也不一样。周报是短期记录,写完自己核对链接即可;知识库条目要长期被检索,复核人是将来搜它的人;新人文档要被完整读一遍,复核强度最高,通常需要带过新人的同事过一遍。下面的对比可以作为拆分提示词的依据。

维度周报知识库沉淀新人文档
输出结构四类条目:进展 / 影响 / 待确认 / 下周,每条挂文档链接结论先行,再适用场景、操作步骤、失败现象、相关链接带顺序的导读:每节指向具体文档,外加补写空位
语气第一人称陈述,只写发生过的事无人称的说明文体,命令和配置照写面向陌生读者的引导语气,解释“为什么先看这篇”
长度短,按条数上限控制中到长,取决于操作步骤多少,宁详不漏关键命令短,只做串联,不搬运正文
复核强度低:自己核对链接能否点开对应改动中:搜标题关键词能否命中、标签是否复用已有标签高:找没参与过的同事读一遍,标出卡住的位置

检索友好度的判断依据可以落到两个可验证的动作上:把标题里的关键词丢进语雀搜索,看这篇是否出现在前列;点开它选的标签,看结果列表里是否混进大量无关文档。复核强度则看“错了会怎样”:周报写错一条影响一次沟通,知识库条目写错会让后来的人照着做错事,新人文档写错会让人在起步阶段耗尽耐心。按这个顺序,把三套提示词分别存成语雀模板或团队共享的提示词片段,比维护一个万能动辄几百字的提示词更好改,也更容易看出哪一处该补材料。