项目复盘 · 发布 2026年5月10日
团队交接复盘:文档缺失的一个月
核心开发离职,接手的人花了一个月才敢改第一行代码。
项目已经稳定运行两年,核心开发提出离职。交接期只有两周,接手同事在第一个月里几乎都在读代码和猜测设计意图,客户的一个小需求改了十天才上线。
缺失的信息
为什么这么设计。很多看似奇怪的逻辑,是因为当年某个客户的特殊要求。
哪些数据不能动。有些表由外部系统写入,手动修改会造成同步失败。
部署流程只在一个人脑子里,包括几台服务器、几个定时任务和几个隐藏的环境变量。
现在的交接清单
每位核心成员维护一份系统说明,包含架构图、关键决策记录和常见故障处理。
部署与回滚流程写成可执行脚本,任何人按文档都能完成一次发布。
离职交接至少提前一个月启动,并安排接手人独立完成一次发布。
人员流动是常态。系统能不能在任何人离开后继续运行,是团队成熟度的真实指标。