# 为什么“一切正常”是最糟的部署收尾

> 遗留问题只分三类：经验教训、剩余债务和产品问题，FDE 离场前每一项都要有负责人。

原文: https://fdetimes.net/zh/guides/fde-project-closeout-review-three-buckets/

部署的最后一周总是很挤：移交账号、收回权限、发送文档。收尾复盘通常被挤到最后半小时，最后以一句“一切正常”结束。几个月后，下一个客户踩进同一个坑，却没人记得上次是怎么处理的。

PostHog 的员工手册把前线部署工程师（FDE）描述为最先在真实客户负载下碰到产品粗糙之处的人。手册还明确写道，在一线收集的上下文能帮助后来的客户更快解决问题。

所以最后这次会议不是走过场。只有这一次，你能确保该到场的人都在，把这些摩擦变成有人负责的工作。等你转去下一个项目，这些知识就跟着你走了。

## 每一项都归入三类之一

项目收尾时仍未关闭的事项，都只属于三类中的一类。**经验教训**会改变你下次的工作方式。**剩余债务**是客户或你的团队仍需完成的工作，要有负责人和截止日期。**产品问题**是只有产品团队才能修复的问题。

分类之前，先剔除一类不属于这场技术会议的事项：商务需求，比如客户想追加范围。在 PostHog，与客户的商务关系归该客户的技术客户主管（TAE）、技术客户经理（TAM）或客户成功经理（CSM）负责，而不是 FDE。会议一开始就把这一点说清楚，记下这些需求，直接转交出去。

其余事项的分类问题是：如果下一个客户遇到这个问题，谁得去修？如果答案是负责该功能的团队，PostHog 有一条明确规则：当项目被只有产品团队才能修复的问题阻塞时，FDE 应把工作移交给该团队，而不是绕过去打补丁。

这条规则防范的是一种具体风险。Tandem 总结了 Marty Cagan 对 FDE 模式的批评：危险在于逐渐滑向为每个客户定制软件。只有当一线学到的东西回流到共享产品，而不是沉淀为定制代码时，这种模式才行得通。

无论事项归入哪一类，整场会议都需要一个共同前提：不追责。Google SRE 一书中关于事后复盘文化的章节写道，你无法“修复”人，但可以修复系统和流程。

客户也必须在场：一份关于项目收尾的指南强调，经验教训会议要与客户一起开，而不是你们团队内部的私下复盘。

## 设想一次分析平台部署

假设你刚为一个电商 App 完成事件追踪部署。会前，你把工单、消息和笔记整理成一份包含六项的原始清单。下表展示了分类结果，其中一项在分类前就被剔除。

| 事项 | 类别 | 负责人 | 下一步 |
|---|---|---|---|
| 同步到数据仓库的任务很慢，因为它在客户的高峰时段运行 | 剩余债务 | 客户的数据工程师 | 调整任务时间，设定截止日期 |
| 用户长时间离线时，SDK 会丢失事件 | 产品问题 | 负责 SDK 的团队 | 提交一个涵盖四点的 issue |
| 绕过上述 SDK 缺陷的临时代码 | 剩余债务 | FDE | 在 issue 中附上链接，记录移除日期 |
| 把旧事件重命名为新名称的脚本 | 经验教训，转化为工具 | FDE | 作为可复用模板加入内部仓库 |
| 等待权限开通耽误了好几天 | 经验教训 | FDE 团队 | 在启动会上就申请权限 |
| 客户想要一个额外的定制看板 | 预先剔除：商务需求 | CSM 或 TAM | 转交负责商务关系的人 |

仔细看其中三行。绕行代码没有藏起来：它被记为债务，并链接到产品问题上，这样 SDK 团队发布修复后，就有人记得把它删掉。

事件重命名脚本成了一项资产。PostHog 把构建参考实现、示例和能加快后续项目的内部工具，视为 FDE 工作的一部分。

最后一行是会议开始时就剔除的事项。客户在复盘中提出新范围时，正确做法是记下来，转交给负责商务关系的人，而不是当场许诺。

对于产品问题，PostHog 要求 FDE 通知负责该领域的团队，并提交一个 issue，写明哪里坏了、谁会遇到、阻塞了什么、如何复现。下面是一个可以直接复制的模板：

```markdown
标题：设备长时间离线时 SDK 丢失事件

哪里坏了：离线期间记录的事件在恢复连接后没有发送
谁会遇到：电商客户，移动 App，信号较弱地区的用户
阻塞了什么：结账漏斗报表缺少数据，客户暂时还不信任这些数字
如何复现：打开飞行模式，浏览几个页面，等待较长时间，恢复连接，检查事件
当前绕行方案：客户仓库中的绕行代码（链接），修复后移除
```

## 一步步开好这场会

会前，把表格草稿发给客户，让对方补充。没人愿意在会议中途第一次听到一串问题。会上逐项过一遍，先就类别达成一致，再确定负责人，要点名到具体的人，而不是“另一个团队”。

最难的一步是排优先级。Google SRE 一书为每次复盘提出一个问题：行动计划是否合理，修复项的优先级是否恰当？如果一个阻塞客户主要报表的产品问题被标为“低”，这场会就失败了一半。

**要点:** 没人再看的经验教训，和从没学到没有区别。

会后，把结果存入共享仓库。Google 建议把事后复盘集中存放，方便他人查找和学习，并直言未经审阅的复盘等于从未存在。那份项目收尾指南也有类似说法：存到团队下次能找到的地方。

还有最后一项任务：同一份指南指出，结束项目不只是寄出发票，即使合作结束，也应有意识地移交客户关系。就在收尾邮件里，把客户介绍给今后负责对接的人。

## 让会议失去意义的错误

最常见的错误是把会开成审判，比如追问“是谁拖了权限申请？”。客户随即沉默，你恰恰失去了最值得学习的那些经历。第二个错误是只开内部会、不邀请客户，结果剩余债务里的事项在客户那边没人接。

第三个错误更难察觉：因为比提 issue 更快，就悄悄绕过产品缺陷。每一个这样的补丁，都正是 Cagan 所警告的那种定制代码。

PostHog 写道，把客户问题带回来的意义在于更好的路线图。一个只存在于客户仓库里的补丁，改善不了任何路线图。

最后一个错误是含糊的 issue，只写一行“SDK 有离线 bug”。产品团队无法复现，就不会排期修复。上面模板中的四点，正是把你在一线目睹的情况变成另一个团队能够执行的工作的关键。

这项技能也值得写进简历。PostHog 把向产品反馈经验教训、构建可复用工具描述为 FDE 岗位的一部分，所以值得具体展示，而不只写“为客户 X 完成部署”。

写明你为产品团队提交了多少个 issue、其中哪些已修复，以及你构建的哪些工具被后续项目复用。阅读岗位描述时，留意是否提到与产品团队的反馈闭环：这是公司认真对待这项工作的一个信号。

## 练习：这六项你会怎么分？

假设你刚结束一个客服 Agent 的部署。原始清单有六项。一：导入大文档时，产品 API 超时。二：为绕过该缺陷而把文件切块的代码。三：客户 IT 团队还没停用测试账号。

四：你编写的用于给 Agent 回答打分的评测套件。五：项目耽误了两周，因为没人知道客户那边由谁审批数据。六：客户询问扩展到更多部门的价格。先自己分一遍，再看下面的答案。

答案：第六项最先剔除，转交 CSM 或 TAM。第一项交给产品团队，提交一个涵盖四点的 issue。第二项是 FDE 的债务，在该 issue 中附上链接。第三项是债务，由客户那边一位指定的人负责，并设定截止日期。

第四项是转化为工具的经验教训，加入内部仓库。第五项是经验教训：下次在启动会上就问清数据审批人的名字。如果第二项分错了，请重读为什么补丁不能藏起来。

只有当下一个客户不必再付出这个客户已经付出的代价时，项目才算真正结束。

**本周动手试试:**

- 重新打开你最近的项目，列出所有绕行方案和未关闭的工单，把每一项归入三类之一。
- 挑一个你曾不得不绕过的产品缺陷，按模板中的四点重写成 issue，发给负责该领域的团队。
- 在简历中加一行，具体说明你如何把客户经验反馈给产品团队，或把它们变成可复用的工具。

## 信源

- [Working with product engineering - Handbook](https://posthog.com/handbook/forward-deployed-engineering/working-with-product-engineering)

- [Forward deployed engineering overview - Handbook](https://posthog.com/handbook/forward-deployed-engineering/overview)

- [How FDE teams work with product and engineering (without broken telephone) | Tandem](https://usetandem.ai/blog/fde-product-engineering-feedback-loop)

- [Chapter 15 - Postmortem Culture: Learning from Failure](https://sre.google/sre-book/postmortem-culture/)

- [Engagement Closeout & Post-Implementation Review](https://ferdinebi.github.io/software-engineering-with-ai/maintenance-retainer/engagement-closeout/)
