第 05 模块 · 2 节

项目复盘与持续优化

《Claude Code 进阶实战》05 综合实战 · 本节时长 36 分钟

做完不是结束,是下一次的开始

上一节跑通了整套工作流。这一节讲复盘:做完之后,怎么从这次经历里提炼出「下次能更快、更稳」的东西。

工作流的价值在「不断变好」,而变好的来源就是复盘。

对 codex-review 来说,复盘尤其重要:评审技能是「全组共用、需要持续迭代」的资产,不复盘,它就一直停留在第一次的水平,甚至越用越过时。复盘 → 沉淀 → 技能升级,是 codex-review 持续变好的发动机。

贯穿项目codex-review 做完一次评审后,复盘问三个问题:哪一步最痛、评审子任务怎么拆更顺、有什么能沉淀进评审技能。复盘产出直接喂给 SKILL.md 和权限边界,让 codex-review 一次评审比一次好用。

复盘的三个问题

做完一个任务,停下来问自己:

  1. 哪一步最慢/最痛?
  2. 哪些子任务可以合并或拆分得更顺?
  3. 有什么可以沉淀成技能/规范?

这三个问题,就是复盘的骨架。

对 codex-review,把三个问题翻到评审语境:

  1. 哪一步最慢/最痛? 是出计划太啰嗦?某路子 Agent 审得太慢?对账阶段最费劲?
  2. 评审子任务怎么拆更顺? 三路是不是有的太薄、有的太厚?要不要加「性能」路,或合并某两路?
  3. 有什么能沉淀进评审技能? 这次发现的评审盲区,要不要写成一条新检查点?

怎么记复盘

别靠脑子记。用结构化的方式记下来,最好放进项目:

# 复盘: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 会从「评审助手」慢慢退化成「一个过时又危险的脚本」。


落地练习

练习① 三步走:第 1 步,回看你上一节跑通的 codex-review 评审报告,用「复盘三问」挑出最痛的一处(比如某路审太慢、某类问题漏审);第 2 步,把这条经验用结构化格式记下来(最痛 / 可改进 / 沉淀),并真的去改 SKILL.md 对应的地方;第 3 步,重新触发一次评审,确认改动生效、且没有破坏其他路。

② 怎么判断做对了:你有一套固定的复盘记录格式,且每条「沉淀」都对应一次对 SKILL.md 或权限边界的真实改动;重审后验证了改动生效。

③ 卡住了怎么办:如果不知道从哪复盘,就盯着上一份报告里「最薄的那一路」问「为什么它薄、怎么让它更厚」;如果改完没生效,回到模块 03-4 的调试方法,一次改一处、真实验证。

常见坑:复盘「记了」,但从不沉淀进技能

很多人复盘做得像模像样,问题、经验记了一堆,但记完就完了,从来没改到 SKILL.md 上。结果复盘变成「写日记」,下一场评审该漏的照样漏,codex-review 一点没进步。复盘和沉淀脱节,是最常见的浪费。

对策:每一条复盘「沉淀」,都必须对应一次对技能 / 权限 / 配置的真实改动。 「记下来了」不算沉淀,「改到 SKILL.md 并验证生效了」才算。复盘的价值不在记录,在于让资产变好。

做法codex-review 的复盘以「这次改了什么 SKILL.md 检查点 / 权限边界」为验收。没改到资产上的复盘,不算闭环。这样每一场评审都在给下一次铺路,codex-review 越用越强。

小结

  1. 复盘三问:哪步最痛?怎么拆更顺?能沉淀什么?
  2. 复盘要结构化记下来,别靠脑子
  3. 复盘终点是「沉淀成资产」:技能 / CLAUDE.md / 规范
  4. 持续优化:每任务小复盘,每周固化,每月体检
  5. codex-review 在「复盘 → 沉淀 → 升级」的循环里持续变好

到这里,Claude Code 进阶课结束。你从「单次对话」升级到了「多 Agent 协作的评审工作台」。下一门课进入生产级工程:插件、MCP、性能成本、团队协作。