负责服务器、发布流水线、监控告警和故障处理的运维或 SRE,日常工作里告警多、脚本杂、变更文档和故障复盘写起来费时,夜间排障时更需要快速理清思路。很多工作依赖老员工的经验,新人上手慢、出错多,一份清晰的 SOP 能显著减少反复解释。下面以运维工程师的真实场景为例,演示用 AI 写 SOP 流程文档的完整流程:口述或粘贴你的实际做法,让 AI 整理成包含目的、角色、步骤、检查点和异常处理的标准文档。

场景:运维工程师为什么需要 AI 写 SOP 流程文档

运维工程师所在的团队里,很多事情“只有某个人知道怎么做”。比如“把发布流水线的构建时间缩短约三分之一”这类工作,每次新人接手都要从头问一遍。技术负责人希望把这些流程沉淀成文档,但没人有时间从零写。现实中,运维工程师还得兼顾“把发布流水线的构建时间缩短约三分之一”等日常事务,所以更需要一套拿来就能用的方法。

用什么工具

用 ChatGPT、Kimi、通义千问等对话助手整理 SOP 即可;写好后可以放进飞书、钉钉、Notion、Confluence 等知识库,团队成员随时查阅。

案例:一次完整的使用过程(虚构)

我们用一个虚构人物把流程串起来:小吴,运维工程师,最近在忙“演练数据库主从切换”。一次故障复盘会结束后,小吴意识到需要尽快写 SOP 流程文档,可当天还要处理“把发布流水线的构建时间缩短约三分之一”。于是小吴把要求和背景一次性写进提示词,让 AI 先出一版,再花时间修改关键部分。最后交给技术负责人的版本,结构和措辞都是小吴亲自把过关的。

操作步骤

  1. 用语音或文字把你平时的做法讲一遍,不必讲究顺序
  2. 让 AI 按固定模板整理,并标注你没讲清楚的地方
  3. 补充遗漏的步骤和异常情况
  4. 请一位新人照着执行一遍,根据反馈修订

提示词模板(可直接复制)

下面的提示词可以直接复制,按运维工程师的实际情况替换细节:

【背景】最近在处理“处理 2 起磁盘告警和 1 起证书过期隐患”,同时要准备“演练数据库主从切换”。
请把下面这段口述整理成一份 SOP 文档,使用者是刚入职的同事。

口述内容:
“把发布流水线的构建时间缩短约三分之一这件事,一般是先确认需求和时间,然后准备材料,过程中要注意服务器 IP、账号口令、证书私钥和内部拓扑不能外传,做完要给技术负责人确认,有问题的话先记下来再统一处理……”

格式要求:
1. 目的和适用范围
2. 涉及的角色和职责
3. 操作步骤(编号,每步写清楚输入、动作、输出)
4. 关键检查点
5. 常见异常及处理方式
6. 口述中没有说清楚、需要补充的地方(单独列出)

示例输出(仅供示意)

以下是一段示意性的输出,内容基于虚构的工作记录,仅用于展示格式和思路,实际结果会因工具和输入不同而变化:

一、目的:规范“把发布流水线的构建时间缩短约三分之一”的处理流程,保证质量一致、信息安全。

二、角色:执行人(运维工程师)、确认人(技术负责人)

三、操作步骤

  1. 确认需求:输入为需求说明 → 与需求方确认范围和时间 → 输出确认记录
  2. 准备材料:……
  3. 执行与自查:……
  4. 提交确认:提交给技术负责人,记录确认结果

四、检查点:服务器 IP、账号口令、证书私钥和内部拓扑是否已做脱敏或权限控制

五、常见异常:需求变更时,先暂停并重新确认范围

六、待补充:“有问题先记下来”具体记在哪里、由谁统一处理?

注意示例中所有内容都是虚构的。实际使用时,AI 的输出质量取决于你提供的材料是否完整、要求是否具体。

避坑指南

  • SOP 要写给真实的使用者看,让 AI 避免使用只有老员工才懂的简称。
  • 流程变化后要及时更新,可以在文档开头写上版本和更新日期。

给运维工程师的特别提醒

让 AI 写的命令先在测试环境执行,并要求它说明每个参数的作用。同时要记住:涉及删除、重启、改权限的命令,必须先确认影响范围并做好回滚准备,不能照抄执行。

变体用法

  • 流程优化:让 AI 找出流程中重复或可以合并的步骤。
  • 多语言版本:为外籍同事生成英文版 SOP。

相关阅读