第 05 模块 · 3 节

项目复盘与经验沉淀

《Claude Code 生产级工程》05 生产级项目实战 · 本节时长 28 分钟

让这套方法,能复制到下一个项目

做完了第一个生产级项目,最大的收获不是「上线了」,而是从中提炼出能复用的经验。否则下一个项目,又得从头趟一遍坑。

这一节,把复盘做成习惯,把经验沉淀成可复制的方法。mcp-hub 交付了,但真正有价值的,是它身上提炼出的「怎么做一个生产级插件」的方法。

贯穿项目mcp-hub 走完了从骨架到交付的全程。这一节,你给 mcp-hub 做**最终复盘**,把它沉淀成「下次做插件/MCP/团队工具都能复用」的资产。**mcp-hub 最大的产出,不是它本身,而是它教给你的那套可复制方法。**

复盘的三个层次

复盘不是「总结一下就完了」,分三个层次:

层次 问的是
具体问题 这次哪里最痛?
改进做法 下次怎么避免?
沉淀资产 能固化成技能/规范/模板吗?

从「这次」到「通用」,才是有效的复盘。

对 mcp-hub 的复盘,三层分别是:哪里最痛(比如接入服务最耗时)、下次怎么避免(先找现成 Server)、沉淀成什么(一个「接入 MCP 服务」的 checklist / 模板)。


复盘:先诚实面对「痛」

别只报喜不报忧。认真问:

  • 哪一步最慢、最纠结?
  • 哪个环节返工最多?
  • 哪里有「差点出大事」的风险?

痛的地方,才是改进的宝藏。 藏着掖着,下次还痛。

对 mcp-hub,诚实地想:**是不是在「自建 Server」上花的时间最多?是不是「安全基线」差点没守住?**把这些痛记下来,它们就是下次的改进方向。


沉淀:把经验变成「可复用」

复盘的核心产出,是把经验沉淀成资产:

经验 沉淀成
某接入流程反复手撸 MCP 接入模板 / 插件
某规范总靠提醒 写进 CLAUDE.md / 团队配置
某查询模式常用 封装成插件能力
某坑踩了两次 写进运维 check-list

每个痛,对应一个「下次不用再痛」的资产。

对 mcp-hub,你可以沉淀成:

  • 「接入一个 MCP 服务」的 checklist:四步 + 安全基线,下次照着走
  • 「插件打包发布」的模板:清单 + 安装脚本 + 版本规范
  • 「生产级交付」的 checklist:四层架构 + 运维预案

一套可落地的复盘流程

1. 项目结束,开个复盘
2. 列出:做得好 / 做得痛 / 有风险
3. 对每项「痛/风险」,定一个改进动作
4. 把改进沉淀成技能/规范/模板
5. 写进团队知识库,下一个项目直接复用

让复盘产出「看得见的东西」,而不是一句「大家辛苦了」。


一个可复制的复盘模板

给 mcp-hub 团队定一个简单复盘模板,项目结束照填:

## mcp-hub 项目复盘

### 做得好
- (例)先找现成 MCP Server,省了大量自建时间

### 做得痛
- (例)自建 Server 时 SDK 用法反复查文档
  → 改进:写一份团队内的「Server 骨架」模板

### 有风险
- (例)生产凭据差点硬编码
  → 改进:接入门槛强制检查「凭据走环境变量」

### 沉淀
- 接入 MCP checklist / 打包发布模板 / 交付预案

填完,改进动作和沉淀资产一目了然。


复盘成果怎么用起来

  • 下一个项目:开跑前先看上次复盘的沉淀
  • 团队共享:沉淀进仓库,全组复用
  • 定期回顾:复盘成果要真被用,别躺在文档里

沉淀不被用,等于没沉淀。

对 mcp-hub:把你的复盘模板和 checklist 放进团队仓库,下一个做插件/MCP 的项目开跑前,先看这份沉淀——这才是 mcp-hub 经验真正的价值。


落地练习:给 mcp-hub 做最终复盘

这一节,给整个 mcp-hub 项目收尾。

跟着这三步走:

  1. 用复盘模板,诚实列出 mcp-hub 的「做得好 / 做得痛 / 有风险」
  2. 对每项「痛 / 风险」定一个改进动作,并把它沉淀成一个资产(checklist / 模板 / 规范)
  3. 把这些沉淀放进团队仓库,并写下「下一个项目开跑前怎么用它」

你会怎么判断做对了?——你有一份可复用的 mcp-hub 复盘成果(含 checklist / 模板),并且每个「痛」都有对应的「下次不用再痛」的资产,就算过关。

卡住了怎么办? 想不出「痛」?就回忆哪一步你卡得最久、查文档最多。不会写模板?直接用上面的复盘模板填。不知道怎么沉淀?先从「一个 checklist」做起,别贪多。


常见坑:复盘只写「做得好」,或者写完就不管

两个常见坑:一是复盘只报喜,把「痛」都藏起来,结果下次还痛;二是复盘写得很认真,却躺在文档里没人用,等于没沉淀。

有效的复盘,一要诚实面对「痛」,二要让成果真正被用。 mcp-hub 的经验要能进仓库、能指导下一个项目,而不是写给自己看的总结。复盘的价值在「沉淀被用」,不在「写了多少」。


小结

  1. 复盘三层次:具体问题 → 改进做法 → 沉淀资产
  2. 诚实面对「痛」,那是改进的宝藏
  3. 每个痛,沉淀成「下次不用再痛」的资产
  4. 让复盘产出看得见、真被用的东西
  5. mcp-hub 的最终产出,是那套可复制的生产级方法

到这里,Claude Code 生产级课程结束。你已完整做出一个可交付的 mcp-hub 插件,并掌握了从插件、MCP 到交付运维的整套生产级能力——这套方法,能复制到你下一个任何项目。