如何向ChatGPT精确输出一份SaaS产品发布步骤文档
本文基于一位拥有4年SaaS产品发布经验的运维负责人视角，阐述如何通过精准的提示词设计，让ChatGPT生成一份可直接用于团队同步的、具备可操作性的发布步骤文档。该文档的目标受众为研发、测试、DBA三组成员，执行场景为每周三18:00灰度发布前3小时的同步执行。文档内容不包含环境搭建、权限申请等前置准备，仅覆盖从代码合并到服务上线的60分钟内动作。
第一步：明确角色与交付对象
- 锁定身份：在提示词开头使用“你是一位有4年SaaS产品发布经验的运维负责人”，不采用“假设你是”这类虚拟语气，避免ChatGPT跳过角色约束，输出笼统的理论流程。
- 明确交付对象和使用场景：例如：“该文档将发给研发、测试、DBA三组成员，在每周三18:00灰度发布前3小时同步执行”。这一步缺位会导致输出变成不带时间锚点的理论流程图。
- 声明文档用途边界：例如：“本步骤文档不包含环境搭建、权限申请等前置准备，仅覆盖从代码合并到服务上线的60分钟内动作”。否则ChatGPT会自动补全CI/CD配置等无关内容，挤占关键步骤空间。
第二步：强制结构化字段与顺序
- 方法一：使用数字序号硬性规定字段层级，例如：
- 发布窗口期（精确到分钟，如 17:55–18:55）
- 责任人（姓名+岗位，如 张伟｜后端工程师）
- 执行动作（动词开头，如 执行git tag v2.3.1）
- 校验方式（必须含具体命令或页面路径，如 curl -I http://api.example.com/health | grep "200 OK"）
- 异常信号（列出3个具体错误日志关键词，如 "Connection refused"、"timeout after 30s"、"schema migration failed"）
- 回滚指令（完整shell命令，如 sh rollback_v2.2.sh）
- 方法二：使用分隔符框定字段逻辑关系，例如：“【窗口】17:55–18:55｜【动作】kubectl rollout restart deployment/frontend｜【校验】访问/admin/status，状态码=200且response_time<200ms｜【阻塞】若DB连接池占用率>95%，立即中止并通知DBA”。注意此处使用中文顿号“｜”而非逗号，避免ChatGPT误判为多任务并列。
- 重要：字段命名必须全部小写加下划线，例如 window_start、rollback_cmd。违反此规则会导致运维脚本无法读取变量名。
第三步：封堵幻觉与自由发挥
在提示词末尾添加以下三重约束，防止ChatGPT生成不可控内容：
- 时间约束：所有时间节点必须落在工作日9:00–19:00区间，禁止出现凌晨、周末时段。
- 未知处理：若某环节无明确校验方式，写“待DBA提供SQL检查语句”并标红，不自行编造如“SELECT COUNT(*) FROM…”等内容。
- 语气约束：不出现“建议”“可选”“推荐”等模糊表述，每个动作必须是强制执行项。
这些约束直接粘贴在提示词末尾即可。遗漏任何一条，ChatGPT可能生成“建议观察5分钟再继续”这类无效缓冲动作，从而延误故障响应。
第四步：绑定输出格式与长度
- 格式规范：指定输出为纯文本，禁用Markdown、表格、编号列表。理由是运维同学需要复制进飞书文档后直接粘贴到钉钉群，带格式符号会触发消息折叠。
- 长度限制：每行≤65字符，超长自动截断不换行。防止生成的长命令被手机端截断，导致kubectl命令缺少参数。
- 格式校验：加入指令：“若输出中间出现星号*、井号#、横线-、数字编号1. 2.，或任意空行，请重写”。这些符号在终端里会被误解析为命令或注释。
常见问题与注意事项
- Q: 为什么不能使用“假设你是”？
A: ChatGPT并不识别虚拟语气，如果使用“假设你是”，它会视为一种假设性描述，从而直接跳过身份约束，输出通用的流程说明。 - Q: 为什么要明确文档边界？
A: 缺少边界声明时，ChatGPT可能会自动补全CI/CD配置、服务器环境搭建等前置内容，以填补空白。这会导致核心发布步骤被无关联内容挤占，降低文档的有效性。 - Q: 如果出现“待DBA提供”这类未知校验，该怎么处理？
A: 这是处理未知校验的最佳实践。直接标红提示，而不是AI自行编造不存在的校验命令，以保证文档的准确性和可追溯性。