项目复盘

复盘不是「总结成功」，而是提取可复用的决策模式：这个项目里哪些决策对了、哪些错了、下次遇到同类情况怎么选。一次诚实复盘的价值，大于十次顺利交付。

何时复盘

时机	触发条件	复盘重点
里程碑结束	完成一个阶段（如路线的里程碑项目交付）	阶段目标达成度、方法是否可复制
项目收尾	上线 / 交付 / 结题	全流程、数据、团队协作
失败之后	项目失败 / 明显低于预期	止损点是否及时、根本原因
周期结束	月末 / 季度末	多条日志的汇总提炼

复盘距离事件越近越好，趁细节还在；但情绪消退一点再写结论（避免成功膨胀 / 失败归咎）。

复盘框架（直接复制）

---
title: 复盘：项目名称（时间区间）
description: 一句话结论：这个项目给我留下什么可复用决策
tags:
  - 复盘
  - <技术栈 / 领域标签>
---

# 复盘：项目名称

## 一、目标回顾

- 当初定的目标是什么？（写清楚验收标准，不写「尽力做好」）
- 目标本身是否合理？依据当时信息，是否该调整？

## 二、结果核对

| 维度 | 预期 | 实际 | 差距 |
| --- | --- | --- | --- |
| 功能 / 交付物 | | | |
| 质量 / 性能 | | | |
| 时间 / 成本 | | | |
| 个人成长 | | | |

- 数据说话：贴关键数字（时间、性能、错误率、代码量、学习投入）。

## 三、原因分析

- **做对了什么**：哪些决策 / 习惯 / 方法直接带来了好结果？可复用到哪里？
- **做得不好的**：哪些环节低于预期？是目标问题、方法问题还是执行问题？
- **外因 vs 内因**：客观限制（环境、依赖、时间）与主观失误分开列，避免两种极端（全怪自己 / 全怪外界）。

## 四、行动项

- [ ] 下一个项目 / 阶段要**继续保持**的做法（1-2 条）
- [ ] 要**改变**的做法（具体到行为，不写「更努力」）
- [ ] 要**补学**的知识 / 工具（链接到[对应领域笔记](../frontend/)或[踩坑记录](./pitfalls)）
- [ ] 设定复查时间：一个月后回看本条是否真的改进了

> 相关链接：[学习日志](./template) · [踩坑记录](./pitfalls) · 学习路径 [前端](../paths/frontend) / [后端](../paths/backend) / [AI](../paths/ai)

怎么填才有效

环节	要求	反例
目标回顾	写当初写的验收标准，不事后美化	「目标就是做完这个项目」
结果核对	用数据与产物对照，尽量引用日志	「整体还算顺利」
原因分析	拆到决策层：当时为什么这么选、现在看哪个假设错了	只列「时间不够」「xx 框架难用」
行动项	具体到可执行的行为 + 复查时间	「下次注意」「继续努力」

诚实记录的三条纪律

1. 不写给自己邀功：成功要归因到具体做法（否则无法复制），而不是归因到「我很行」；
2. 失败不找替罪羊：先列自己能改变的部分（目标、方法、投入、沟通），外因只作背景；
3. 敢于记「没发生的」：当初担心过、后来靠运气躲过的问题也值得写——那是下一次的真正风险。

示例对比

空泛（差）：

项目基本完成，学到很多。做得好的：技术选型对。不足：时间有点紧。改进：下次提前规划。

可执行（好）：

• 目标回顾：目标 2 周做一个 CRUD 记账应用，含鉴权与部署。当时判断「鉴权用现成方案 1 天搞定」。
• 结果核对：功能按时交付；但部署踩了 2 天（见踩坑：容器优雅退出），整体 16 天；鉴权部分实际 3 天。
• 原因分析：对的部分——先用 Node.js 路线 的骨架起步，减少重复造轮子；错的假设——「现成方案 = 快」，没算上文档与版本适配成本；外因——周末被打断导致上下文切换损耗约 1.5 天。
• 行动项：继续保持「先跑通最小闭环再扩展」；下次涉及第三方方案先花 30 分钟查版本兼容再排期；补学数据库索引失效后把分页慢查询重写一遍；复查时间定在 10 月 1 日。

复盘如何落地

复盘最大的失败是「写完就完」。三道落地闸：

闸口	动作	验收
立即	把「行动项」拆进下周的计划或学习日志的明日计划	一周内至少启动 1 条改变
定期	设复查提醒（1 个月后回看）	对照行动项逐条打勾或改写
沉淀	有复用价值的结论写成方法/清单补进对应领域文档	该结论在别的文档里被引用

写作规范速记

• 命名 retrospective-<项目/阶段>-<YYYY-MM>.md；
• 结果核对必须有数据或产物对照，空泛形容词不算；
• 原因分析写到「决策 + 假设」层，避免停留在结果层；
• 行动项必须含复查机制，否则复盘只完成一半；
• 复盘引用的排错细节链到踩坑记录，过程数据引到当时的学习日志。

写作规范请参阅过程记录。