适合经常执行发版、数据校验、环境初始化或运维检查的团队。核心结论是:不要一上来就把流程写成无人值守脚本,先让 Codex 把目标、命令、输出、决策和验收记录在同一份可审阅运行手册里。这样既能提速,又不会把高风险决策交给黑盒。

为什么普通聊天记录不够

重复任务的难点通常不在某条命令,而在命令之间的判断:用新环境还是复用旧环境?结果偏差是业务变化还是配置错误?某步失败后能否安全重试?

如果这些信息只留在聊天里,下次执行仍要从头猜。更稳妥的做法是让每次运行产生一份可版本化的产物,至少包含意图、前置条件、执行记录、异常、决策和最终结论。它不是一份执行完才补写的文档,而是任务进行时同步生长的工作界面。

第一步:先写目标合同

运行手册顶部只需一段简短的目标合同,但要把边界写清楚:

  • 本次要得到什么可验证结果;
  • 先参考哪次成功运行;
  • 哪些步骤只读,哪些步骤会改变外部状态;
  • 哪个节点必须停下来等待人工审阅;
  • 要保留哪些命令、输出和解释。

一个可复用的提示词可以是:“先阅读上次运行记录,在本文档中写出计划,等待审批后再执行。记录每条命令的目的、关键输出和你的判断。”它比“帮我跑一遍发版”更容易验收,也更容易在中断后恢复。

第二步:把执行分成四种单元

一份好的运行手册不是大段日志,而是四种清晰单元的组合:

  • **指令**:要做什么,为什么做;
  • **操作**:可重放的命令或有界面的工具调用;
  • **证据**:关键输出、表格、图表或校验结果;
  • **决策**:选了什么、放弃了什么,以及理由。

需要特别区分“原始输出”和“结论”。比如接口返回 HTTP 200 只是证据,不等于业务数据已正确生效。结论应同时指向状态、核心内容与下游可见结果。

第三步:把审批放在决策点

人工不需要审核每一条只读命令,但应在后果显著的决策点介入。常见节点包括:新建或复用环境、扩容资源、修改生产配置、发布、删除、向外部系统发送数据。

审批前,Codex 应给出具体可比较的选项:预期影响、成本、回滚方式、已知风险和推荐理由。审批后则要记录选择及其原因。这个结构既保留了自动化的速度,也避免了“每步都问”和“一路自动到底”两种极端。

第四步:让下一次运行真正受益

任务结束前,不要只写“成功”。请把以下内容压缩成结尾摘要:

  • 最终采用的路径和验收结果;
  • 无效尝试及失败原因;
  • 环境或工具已发生的变化;
  • 下次可以直接复用的入口;
  • 仍需人工判断的问题。

可以再生成一份简短索引,让后续任务能按系统、环境、日期和结果找到历史运行。但不要把密钥、完整令牌、客户数据或内网信息写进文档;记录凭据名称与获取方式即可。

一个最小可行模板

新建流程时,可以从五个区块开始:“目标与边界”、“审批后的计划”、“执行与证据”、“决策记录”、“结果与下次入口”。先用它完成三次真实任务,再考虑哪些步骤适合脚本化、哪些适合做成 Skill 或工具。

判断是否值得进一步自动化的标准很简单:输入边界是否稳定,成功标准是否可机器验证,失败是否可恢复。如果三者仍不清楚,先继续积累可审阅运行记录,比过早追求“全自动”更可靠。

参考资料