| 语言 | 祈使句、主动语态、一步一动作 |
|---|---|
| 要素 | 动作 + 预期结果 + 异常分支 + 记录要求 |
| 验证 | 由未参与编写者按文档试跑一次 |
对比示例
对比示例
不推荐：备份数据库，注意安全
推荐：执行 pg_dump -Fc 导出至 /backup/db/
预期：生成文件名含日期、大小 >1GB
异常：磁盘不足 → 清理 7 天前备份后重试SOP 编写规范
SOP 编写强调可执行性：用祈使句、一步一动作、标注预期结果与失败分支；涉及路径与命令要可直接复制，变量用占位符标注；发布前经非作者试跑验证。
易错点
- 作者是专家自测：跳步与前置知识被默认，新手执行卡壳
- 只写正常路径：异常与回退缺失，现场处置靠发挥
数据来源与参考
- 技术写作与 SOP 编写公开实践（如《Docs for Developers》）