做完不是结束,是下一次的开始
上一节跑通了整套工作流。这一节讲复盘:做完之后,怎么从这次经历里提炼出「下次能更快、更稳」的东西。
工作流的价值在「不断变好」,而变好的来源就是复盘。
对 codex-review 来说,复盘尤其重要:评审技能是「全组共用、需要持续迭代」的资产,不复盘,它就一直停留在第一次的水平,甚至越用越过时。复盘 → 沉淀 → 技能升级,是 codex-review 持续变好的发动机。
复盘的三个问题
做完一个任务,停下来问自己:
- 哪一步最慢/最痛?
- 哪些子任务可以合并或拆分得更顺?
- 有什么可以沉淀成技能/规范?
这三个问题,就是复盘的骨架。
对 codex-review,把三个问题翻到评审语境:
- 哪一步最慢/最痛? 是出计划太啰嗦?某路子 Agent 审得太慢?对账阶段最费劲?
- 评审子任务怎么拆更顺? 三路是不是有的太薄、有的太厚?要不要加「性能」路,或合并某两路?
- 有什么能沉淀进评审技能? 这次发现的评审盲区,要不要写成一条新检查点?
怎么记复盘
别靠脑子记。用结构化的方式记下来,最好放进项目:
# 复盘:codex-review 评审 src/ 改动(2026-08-12)
## 最痛的地方
- 安全子 Agent 审得很慢,因为它把整个 node_modules 相关都扫了
→ 下次在 SKILL.md 里明确「只扫业务代码,不扫依赖目录」
## 可改进
- 三路并行里,风格路结论太薄,都是「可不改」
→ 已给风格路加了「重复代码」检查点
## 沉淀
- 新增一条安全检查点:「确认日志不打印敏感字段」
→ 已写进 SKILL.md
记下来,这些经验才不会随会话消失。
复盘 → 沉淀:闭环
复盘的终点不是「记下来」,而是沉淀成资产:
| 发现 | 沉淀为 |
|---|---|
| 某流程反复手撸 | 技能 / 斜杠命令 |
| 某规范总靠提醒 | 写进 CLAUDE.md |
| 某子任务总拆不顺 | 更新拆解清单 |
每次复盘,都应该让某个「资产」变好一点。 这样你的工作流会越用越顺。
对 codex-review,复盘到的每一条经验,都要落到一个「能改 codex-review」的地方:
- 评审流程反复手撸 → 写进 SKILL.md 的步骤
- 某个检查点总漏 → 加进对应子 Agent 的检查点列表
- 某路权限放太宽/太窄 → 调 SKILL.md 的「权限边界」
- 某类风险总没审到 → 新增一个「必审项」
每次复盘,codex-review 的某个资产都应该变好一点。 这样它会越审越准。
一个「复盘 → 沉淀 → 升级」的闭环示例:
复盘发现:这次安全路又漏了「日志打印敏感字段」。
→ 沉淀:在 SKILL.md 安全子 Agent 的检查点里加一条
「确认日志/输出不打印 token、密钥、身份证等敏感字段」。
→ 升级:下次再评审,安全路自动带上这条检查点,同类漏审不再发生。
闭环的每一步都落到技能上,codex-review 才会一次比一次准。
持续优化的节奏
- 每做一个任务:快速复盘一下(几分钟)
- 每周:回看本周复盘,把高频问题固化成资产
- 每月:检查技能库,删掉废弃的、补上新的
优化是常态,不是一次性的「做完」。
对 codex-review,落实成一个可执行的节奏:
- 每次评审完:花几分钟,问复盘三问,把最痛的一处记下来
- 每周:回看本周评审复盘,把高频问题(比如「安全路总漏某某检查」)固化成 SKILL.md 的新检查点
- 每月:检查评审技能,删掉过时的检查点、补上项目新规范对应的检查点,同时复盘权限边界是否仍合适
优化是常态,codex-review 也在这种节奏里持续变好。
一个反例:不复盘的团队
不复盘会怎样?同样的坑反复踩,同样的操作反复手动,技能库慢慢腐坏,新人继续踩旧坑。不复盘的后果,是工作流永远停留在第一次的水平。
对 codex-review 的不复盘反例更具体:同样的评审盲区反复漏审(因为没沉淀检查点)、技能里的检查点越来越过时(因为没跟进项目新规范)、权限边界越放越宽(因为从没复盘收紧)。不复盘,codex-review 会从「评审助手」慢慢退化成「一个过时又危险的脚本」。
落地练习
② 怎么判断做对了:你有一套固定的复盘记录格式,且每条「沉淀」都对应一次对 SKILL.md 或权限边界的真实改动;重审后验证了改动生效。
③ 卡住了怎么办:如果不知道从哪复盘,就盯着上一份报告里「最薄的那一路」问「为什么它薄、怎么让它更厚」;如果改完没生效,回到模块 03-4 的调试方法,一次改一处、真实验证。
常见坑:复盘「记了」,但从不沉淀进技能
很多人复盘做得像模像样,问题、经验记了一堆,但记完就完了,从来没改到 SKILL.md 上。结果复盘变成「写日记」,下一场评审该漏的照样漏,codex-review 一点没进步。复盘和沉淀脱节,是最常见的浪费。
对策:每一条复盘「沉淀」,都必须对应一次对技能 / 权限 / 配置的真实改动。 「记下来了」不算沉淀,「改到 SKILL.md 并验证生效了」才算。复盘的价值不在记录,在于让资产变好。
小结
- 复盘三问:哪步最痛?怎么拆更顺?能沉淀什么?
- 复盘要结构化记下来,别靠脑子
- 复盘终点是「沉淀成资产」:技能 / CLAUDE.md / 规范
- 持续优化:每任务小复盘,每周固化,每月体检
- codex-review 在「复盘 → 沉淀 → 升级」的循环里持续变好
到这里,Claude Code 进阶课结束。你从「单次对话」升级到了「多 Agent 协作的评审工作台」。下一门课进入生产级工程:插件、MCP、性能成本、团队协作。