第 05 模块 · 3 节

项目复盘与经验沉淀

《Codex 生产级工程》05 生产级实战 · 本节时长 24 分钟

让这套体系,能复制到下一个业务

做完了第一套生产级自动化体系,最大的收获不是「跑起来了」,而是从中提炼出能复用的经验。否则下一个业务,又得从零趟一遍坑。

这一节把复盘做成习惯,把经验沉淀成可复制的方法。

贯穿项目deploy-bot 交付完了,最大的产出不是「它能部署了」,而是「我从它身上提炼出的经验能复制到下一个机器人 / 下一个业务」。这一节把 deploy-bot 的教训沉淀成模板和清单,让下一套体系不用再踩一遍坑。

复盘:诚实面对「痛」

别只报喜。认真问自己:

  • 哪一步最慢、最纠结?
  • 哪个环节返工最多?
  • 哪里有「差点出大事」的风险?

痛的地方,才是改进的宝藏。

对 deploy-bot 复盘,诚实问这几句:

  • 哪次部署最慢、最折腾?(可能是门禁配置反复调)
  • 哪个环节返工最多?(可能是 staging 验收靠手工)
  • 哪里有「差点出大事」?(可能是某次差点把 staging 当 production 部署)

别把「都顺利」当答案——那些「差点出事」的瞬间,才是最该沉淀的。


沉淀:把经验变成「可复用」

复盘的核心产出,是把经验沉淀成资产:

经验 沉淀成
某接入流程反复手撸 模板 / 技能
某规范总靠提醒 写进 CLAUDE.md / 团队配置
某坑踩了两次 写进检查清单
某 Agent 常误判 更新它的规则 / 迭代记录

每个痛,对应一个「下次不用再痛」的资产。

对 deploy-bot 的痛 → 沉淀:

deploy-bot 的痛 沉淀成
每个新项目接入要重配部署 部署接入模板
「别把 staging 当 production」总靠提醒 写进部署规范 / 脚本环境白名单
某次差点回滚错版本 写进回滚检查清单
deploy-bot 常误判门禁 更新它的门禁判断规则 / 迭代记录

让体系可复制:模板化

生产级的终极目标,是把这套体系模板化,让下一个业务直接套:

模板:自动化体系骨架
  ├─ 业务 Agent 模板
  ├─ 流水线模板
  ├─ 质量门禁模板
  └─ 治理规范模板
   → 新业务:套模板 + 填自己的业务规则

模板化,是「一次搭建、处处复用」的关键。

对 deploy-bot 的模板化:

deploy-bot 模板化沉淀
  ├─ 部署脚本模板(通用骨架,项目填差异)
  ├─ CI/CD 流水线模板(测试 → 构建 → staging → production)
  ├─ 质量门禁模板(测试 + 覆盖率 + 验收)
  └─ 部署规范模板(门禁、回滚、owner、权限分级)
   → 下一个部署机器人:套模板 + 填自己的构建命令和部署目标

下一套体系,不用从零搭。


一个复盘 → 沉淀的闭环

1. 项目结束,复盘:做得好 / 做得痛 / 有风险
2. 对每个痛/风险,定一个改进动作
3. 把改进沉淀成模板/技能/清单
4. 下一个项目直接套用
5. 定期回顾,更新沉淀

让复盘产出「看得见、真被用」的东西,而不是一句「大家辛苦了」。

对 deploy-bot 走一遍这个闭环:

deploy-bot 复盘 → 沉淀闭环
1. 复盘:staging 验收靠手工最痛,有回滚风险
2. 改进动作:把 staging 验收也自动化 + 回滚加白名单校验
3. 沉淀:更新流水线模板 + 回滚清单
4. 下一个项目接入 deploy-bot,直接享受这两处改进
5. 定期回顾模板,把新踩的坑再补进去

复盘不是走形式,是产出「能被下一个项目用」的东西。


沉淀不被用 = 没沉淀

  • 沉淀进仓库,别躺在个人电脑
  • 下一个项目开跑前,先看上次沉淀
  • 定期体检:过时资产删掉,补上新经验

让沉淀「流动」起来,才能真正复用到下一个业务。

对 deploy-bot 的沉淀,也要防「沉淀完就吃灰」:

deploy-bot 沉淀落地
- 模板/清单进仓库,随代码一起维护,别躺个人电脑
- 下一个项目接入 deploy-bot 前,先看上次沉淀
- 定期体检:过时的部署规则删掉,补上新踩的坑

沉淀要「被下一个项目翻出来用」,才算真沉淀。


常见坑:复盘只报喜,痛和经验都藏在心里

复盘最常见的坑,是变成「表扬大会」——只讲做得好,痛、返工、差点出事的风险全藏起来,结果什么经验都没沉淀。

真实场景:deploy-bot 交付后做复盘。大家只说「部署挺顺的」「门禁挺好」。但你心里清楚:staging 验收靠手工、某次差点把 staging 当 production、门禁配置返工了三次。这些痛都没讲,自然也没沉淀成模板,下一个机器人还会再踩一遍。

为什么:复盘不诚实面对「痛」,就抓不到改进点;不抓改进点,就没有产出;没产出,就等于白复盘。报喜不报忧,是沉淀的最大障碍。

怎么破:复盘强制问「哪步最痛 / 哪返工 / 有风险」,把「差点出事」也讲出来;每个痛定一个改进动作,并沉淀成模板或清单;沉淀进仓库、下个项目开跑前先看。让复盘「有产出、被使用」,而不是一句「大家辛苦了」。


小结

  1. 复盘三问:哪步最痛?哪返工?有风险?
  2. 每个痛,沉淀成「下次不用再痛」的资产
  3. 模板化,让体系能复制到下一个业务
  4. 沉淀要进仓库、要被用、要定期更新
练习给 deploy-bot 做一次「复盘 → 沉淀」闭环。①三步走:a. 诚实列出 deploy-bot 交付中的 3 个痛点(最痛 / 返工 / 有风险);b. 给每个痛定一个改进动作;c. 把改进沉淀成模板或检查清单,放进仓库。②怎么判断做对了:每个痛都对应一个「下次不用再痛」的沉淀物;沉淀进了仓库,下一个项目开跑前能翻到;模板里没有已经过时的规则。③卡住了怎么办:想不出痛,就回忆「哪次部署最折腾 / 哪次差点出事」;改进动作不好定,就先挑一个痛点,给一个最小改进;沉淀没地方放,就先建一个 `docs/` 下的检查清单,跑通再完善。

到这里,Codex 生产级课程结束。你已掌握从自定义 Agent、CLI 自动化、CI/CD 到规模化治理的完整生产级能力,可以支撑真实业务了。