05 最佳实践与反模式
给下周就要进现场、或者已经在现场卡住的人。04 方法论 讲「按什么顺序做」，这一章讲「具体怎么做、什么时候该停、别人是怎么栽的」。全章的形式是清单、步骤、判断标准，尽量不讲道理。
这一章解决什么
FDE（Forward Deployed Engineer，前线部署工程师）这份工作的公开材料有一个共同的缺口：方法论写到「去现场理解业务」就停了，而现场真正难的是那之后的事——数据要不到、安全审查过不去、demo 惊艳但上线没人用、项目没死却也活不了。
这一章的六页各管一段：
本章页面
| 页面 | 讲什么 | 什么时候读 | 核心产出物 |
|---|---|---|---|
| 进场前与前 30 天清单 | 进场前两周要拿到的三样东西、第一周怎么建立信任、怎么找第一个带头用的人；按周给动作、产出和判断点 | 项目开始前一到两周 | 例外清单、判断卡、干系人地图、数据地图、真问题陈述、交付病历 |
| 干系人与数据获取 | 干系人地图怎么画、四类人各自的激励结构、拿数据的五个筹码、12 项数据体检、权限与脱敏设计 | 第一周，以及每次数据卡住的时候 | 干系人地图、数据地图（含就绪度分级）、口径文档 |
| 安全、采购与法务 | 企业安全审查的三层结构、POC 合同与定价模式、中国的招投标与信创、模型备案与数据出境、保密与知识产权；附 36 题审查问题清单 | 方案定稿之前，不是上线前 | 36 题自查结果、合规边界结论 |
| 从 demo 到生产 | POC 陷阱、pilot purgatory、生产化六组清单（监控 / 回退 / 权限 / 成本上限 / 风险分级 / 变更管理）、AI 系统的 SLA 怎么写、与客户 IT 的交接包 | demo 做出来的当天 | 生产化检查表、交接包十二项、值班与升级路径 |
| 反模式清单：26 种失败模式 | 26 条失败模式，每条给现象、根因、早期信号、解法、出处；另附三条属于这一行而不属于单个项目的反模式 | 每周五拿早期信号那一栏对照本周 | 命中项清单 |
| 中国现场特有的约束 | 甲乙方关系、拍板文化、数据不给、信创与私有化、国产模型选型、驻场与差旅、回款、外包化风险、政府与高校项目、内部 FDE 的组织安排 | 在中国大陆做任何一个项目之前 | 十条现场自查 |
一页纸：最常被违反的十条
每条后面是展开的位置。
- 数据切片没实际到你手上之前，一行代码都不要写。 「数据没问题，你先开始」是危险信号，不是配合。→ 反模式 2
- POC 用真实数据切片，不用样例集。 样例数据跑通只证明模型会做这道题。→ 反模式 1
- 三类决策的 D 分别是谁（技术方案、流程变更、上线授权），三个格子填不满别往下走。→ 干系人与数据获取
- 进场前先做尸体考古。 上一个失败系统的死因就是你的雷区图。→ 进场前与前 30 天
- 5 Whys 的每一层都要附一个带人名或时间的现场事实，附不上就回现场。→ 反模式 6
- 系统可以新，入口必须旧。 用户为了用它需要新增几个动作？0 最好，1 可接受，2 以上会死。→ 反模式 19
- 埋点第一天就有，日报能点到人名。 「谁一次都没登录」那一行就是第二天的工作清单。→ 反模式 21
- 极度配合、零抱怨、零使用 = 你动了他的奶酪。 这一类不能用考核解，agent 也诊断不出来。→ 反模式 20
- 正确率不要写进 SLA，写进月度评审机制。→ 从 demo 到生产
- 立项那天就画巴士图。 「这个人明天调走，项目靠什么活？」答不上来就从当天开始做制度化。→ 反模式 24
这一章的三条阅读提醒
- 清单是起点不是终点。 本章所有清单都是从公开材料和公开复盘里归纳的通用版，进到具体行业（医疗、金融、电力、化工）要按该行业的监管和安全要求重写。涉及人身安全的场景，见 反模式清单 第 9 到 11 条的专业边界判别。
- 证据强度是分级的。 本章标【一手】的是官方发布、原作者文章或平台可查数据；标【转述】的是中文行业公众号或社区流传的叙述，未经独立核实，其中的具体数字不能当事实引用；标【复合案例】的是多个公开报道中反复出现的模式的合成叙述，公司与人物非实指。这三档与 07 案例库 的 A/B/C 一一对应：【一手】≈ A，【转述】≈ C，一方自述但来源可点开的材料在案例库标 B；【复合案例】没有对应等级，不进案例索引。
- 不替读者选路线。 「企业自己培养 FDE」和「买外部交付」这两条路在中文公开讨论里有明确对立的意见，本章两边都记录，写清各自的主张、适用边界和证据强度，不做裁决。见 中国现场特有的约束 第十一节。
延伸阅读
- 本库：../04-methodology/README.md —— 方法论本体，本章是它的现场版
- 本库：../03-role/what-is-an-fde.md —— 先确认你说的 FDE 是哪一种，本章的清单按外部 / 内部两种身份分了岔
- 本库：../07-cases/README.md —— 完整的成败案例，本章的反模式多数能在那里找到长版本
- 本库：../06-toolbox/README.md —— 清单里提到的工具面（评估、监控、私有化部署）
- 本库：../00-start/glossary.md —— MVD、Eval、Context、就绪度分级等术语
- 库外：Palantir《Deploying Full Spectrum AI in Days: How AIP Bootcamps Work》 —— 「客户准备三样东西」的一手出处
- 库外：Google SRE Book《Postmortem Culture》 —— 无责复盘的定义，本章所有「解法」的写法都受它影响
来源
本章各页的完整来源列在各自页面的「来源」一节。以下是全章反复引用的六份基础材料：
- Nabeel Qureshi，《Reflections on Palantir》，2024。https://nabeelqu.co/reflections-on-palantir
- Palantir，《Deploying Full Spectrum AI in Days: How AIP Bootcamps Work》。https://blog.palantir.com/deploying-full-spectrum-ai-in-days-how-aip-bootcamps-work-21829ec8d560
- MIT NANDA，《The GenAI Divide: State of AI in Business 2025》。https://mlq.ai/media/quarterly_decks/v0.1_State_of_AI_in_Business_2025_Report.pdf
- Gartner，《Gartner Predicts 30% of Generative AI Projects Will Be Abandoned After Proof of Concept By End of 2025》，2024-07-29。https://www.gartner.com/en/newsroom/press-releases/2024-07-29-gartner-predicts-30-percent-of-generative-ai-projects-will-be-abandoned-after-proof-of-concept-by-end-of-2025
- RAND Corporation，《The Root Causes of Failure for Artificial Intelligence Projects and How They Can Succeed》，2024。https://www.rand.org/pubs/research_reports/RRA2680-1.html
- 任鑫（Mars），《中国 FDE 手册》（fde-arsenal）——第一人称手册，主张企业内部培养。本章引用其模板与案例的结构，并按本库的中立口径重写。公开发布地址【待核实】。