这是一个虚构但很典型的案例：小吴是一位负责服务器、发布流水线、监控告警和故障处理的运维或 SRE，最近手头在忙“完成两台数据库服务器的磁盘扩容”，同时还要准备“推进日志集中采集”。这次小吴需要整理一份给技术负责人的变更方案，决定试试知识库文档整理与切分。

背景

对小吴来说，告警多、脚本杂、变更文档和故障复盘写起来费时，夜间排障时更需要快速理清思路。偏偏这次还遇到一个变数：机房网络计划维护，可能影响夜间批处理任务。变更方案需要尽快交给技术负责人，时间并不宽裕。

第一次尝试：问题出在哪

小吴一开始只写了一句话：

帮我写一份关于“把发布流程迁移到容器化部署”的变更方案。

结果 AI 给出的内容四平八稳却用不上。复盘下来，主要有两个问题：

  • 直接按固定字数切分所有文档。
  • 切分后不测试。

改进后的提示词

小吴按照文档切分整理的思路重写了提示词，核心是按文档结构切分：优先按标题和章节：

请帮我把下面这份变更方案整理成适合知识库检索的片段：
规则：
1. 按原文的标题层级切分，每个片段对应一个最小的完整小节；
2. 每个片段输出格式：
   【标题路径】一级标题 > 二级标题
   【内容】正文
   【关键词】3-5 个
3. 片段过长时（超过约 500 字）按段落再拆分，并在标题路径后加“（续）”；
4. 删除与内容无关的页眉、页脚和目录。
原文：[粘贴]

结果（示意）

下面的效果为虚构演示，用来说明这类改进通常带来的变化：

示例（虚构）：一份员工手册原本被按固定字数切分，提问“年假怎么计算”时，检索到的片段一半是年假规定，一半是病假规定。改为按标题切分并保留“第三章 假期 > 年假”的标题路径后，检索结果准确多了。

拿到结果后，小吴没有直接转发，而是先删掉不符合实际情况的内容，再补上 AI 不知道的背景。

复盘：这次用到的方法

  • 控制片段长度，保证每个片段能独立表达一个完整意思。
  • 为每个片段添加元信息：文档名、章节标题、日期、页码。
  • 对表格、问答等特殊内容单独处理，保持结构完整。
  • 优先按文档结构切分，保持语义完整。

之后小吴发现，同样的方法也适用于另一类场景：资料包含大量长文档、表格和多层级标题。

复盘时小吴还想到一个问题：多语言文档怎么处理？答案是：可以按语言分别切分，并在元信息中标注语言。

给运维工程师的提醒

让 AI 写的命令先在测试环境执行，并要求它说明每个参数的作用。涉及删除、重启、改权限的命令，必须先确认影响范围并做好回滚准备，不能照抄执行。另外，对话里不要出现服务器 IP、账号口令、证书私钥和内部拓扑。

一个额外的小技巧：记录每次调整切分策略后的测试结果，便于比较。

如果你也是运维工程师

可以先从“处理 2 起磁盘告警和 1 起证书过期隐患”或“清理无主的云资源”这样的小任务开始练习文档切分整理，熟练之后再用到变更方案这类更正式的材料上。每次记录一下哪句提示词最管用，慢慢就有了自己的模板。

相关阅读