案例卡模板与写作要求
给要往本库投稿案例、或者要在公司内部写交付复盘的人。照这个模板写,别人才判断得了你的案例能不能信、能不能抄。
为什么要有统一格式
看别人的 AI 落地案例,最常见的两种失望是:读完不知道对方到底做了什么(只有形容词),以及读完不知道这个结果该信到什么程度(只有百分比)。统一格式解决的就是这两件事——把「做了什么」和「结果值多少」分开写,把「数字」和「数字的口径」绑在一起写。
六段结构
一张合格的案例卡是六段,缺一不可。
1. 背景
写清三件事:甲方是谁(行业、规模、可以匿名但要给量级)、交付方是谁(内部团队 / 外部服务商 / 厂商 FDE)、时间窗口。
不要写「某大型企业」就完事。「一家年营收 200 亿量级、员工四千人的消费硬件公司」和「某大型企业」的信息量差一个数量级。
2. 问题
用甲方老板当时的原话来写题目,不要用你自己翻译过的 IT 版本。
分辨方法:如果题目是「把 A350 的月产量从 4 架爬到 8 架」,这是业务题目;如果题目是「升级生产数据基础设施」,这是被降级过的 IT 采购题目。同一件事,写法不同,后面所有的验收标准都会不同。
这一段还要写清「为什么当时难」。没有难处的案例不是案例,是通稿。
3. FDE 做了什么
按时间顺序写动作,写清每个动作放弃了什么。
最值钱的部分是顺序和代价:先做翻译层还是先出报表,先重构流程还是先上模型,跟班十天还是两周内改模型。这些选择在事后看都显然,在当时都不显然,而案例的教学价值全在这里。
三条硬要求:
- 写具体动作,不写「深入沟通」「紧密配合」。
- 写清放弃了什么。「先花几周建概念映射层」的代价是「前期几乎没有可演示的东西」,这句必须写。
- 如果有决策点,把当时的 2 到 3 个真实选项都列出来,每个选项都要有真实的代价。事后看毫无悬念的选择不构成决策点。
4. 结果
每个数字必须带三样东西:口径、时点、来源方。
| 写法 | 判断 |
|---|---|
| 「效率提升 300%」 | ❌ 没有起点和终点,等于没说 |
| 「数据准确性提升 100%」 | ❌ 语法上就不成立,说明是市场部写的 |
| 「准确率 100%」 | ❌ 分母是什么?退回人工的算不算? |
| 「AI 代码采纳率:2023 年 30%,2024 年 37%,2025 年突破 50%(口径连续三年一致,CIO 本人公开表述)」 | ✅ |
| 「客户每年节省超过 2300 万美元(公司自述口径,客户名未公开,无第三方审计)」 | ✅ 数字弱,但口径诚实 |
| 「保函审核平均时间缩短至 2 小时以内,风险点识别准确率超过 95%(截至 2025 年,企业选送评奖材料口径)」 | ✅ |
补充规则:
- 优先给绝对值和有分母的比率,其次才是百分比变化。
- 百分比必须给基准:从多少到多少。
- 时点要写死:「截至 2025 年 9 月底」。市场、薪酬、模型能力相关的内容尤其如此。
- 区分「目标」和「已实现」。「目标在 2025 年实现内勤覆盖率超 80%」和「截至 2025 年 9 月底覆盖率 88%」是两句话,不要合成一句。
- 互相冲突的数字宁可都不用。同一个案例里客服自动回复率一处写 70%、一处写 40%,口径不明,那就一个都不引。
5. 教训
写成「下次遇到 X 信号,就该做 Y」的格式。
- ✅ 「下次上线后没人用,第一反应别改模型。先看一组数:准确率不低而日活极低,问题几乎必然出在交互、速度或信任上,这三样在测试集里都测不出来。」
- ❌ 「要以客户为中心。」「AI 落地要重视数据治理。」
一条教训对应一个可观察的信号和一个可执行的动作。写不出信号,说明这条教训还没想清楚。
6. 来源
逐条列出,每条含:标题、作者或机构、日期、URL、以及这条来源支撑的是哪个具体事实。
然后单独写一段「保留意见」,列出你查不到的部分。这一段是案例可信度的核心,不是可选项。
保留意见的写法示例(摘自本库已收录案例的做法):
需要标出的保留有三处。其一,保险案例的甲方是谁、项目做了多久、合同金额多少,公开资料完全查不到,因此「成本主要落在乙方」这个判断是从商业结构推出的,不是从这一单的财务数据推出的。其二,10 万余条专家知识与 90% 满意度均为公司自述口径,无第三方核实。其三,公司经营困难中融资环境与交付结构各自的权重,公开材料无法拆分。
证据等级怎么定
| 等级 | 判定条件 | 例子 |
|---|---|---|
| A | 当事人署名自述、上市公司披露、议会/审计/法院文件、政府合同公告,且数字口径写明 | 当事工程师的署名长文;国防部合同公告;界面新闻对欠薪事件的报道 |
| B | 一方自述,来源可点开但无第三方核实 | 厂商官网客户案例页;公司通稿;行业协会评奖收录的企业自选送材料 |
| C | 二手转述、行业流传、匿名信源、聚合站数据 | 未署名公众号叙述;社群转述的日活数字;求职聚合站的岗位统计 |
宁可标低一档,不可标高。 一个案例里不同事实可以是不同等级,这时按最弱的那条事实标注整卡,并在正文里逐条注明。
脱敏规则
- 可以隐去甲方名字,不可以隐去量级和场景。 「一家财富 20 强医保公司,养着 2000 多名分析师」是合格的匿名;「某知名企业」不是。
- 涉密的金额、人名、系统名可以替换或省略,但必须在来源节声明脱敏范围。 例:「合同金额按客户要求隐去,节省金额为客户财务部门认可的口径。」
- 不要为了脱敏而改动数字。 改了数字的案例是虚构案例,必须在文首标注为虚构或复合案例,并且不能进本库的案例索引(例:fde-arsenal 案例库里的「POC 陷阱」「冠军离职」两篇,公司与人物非实指,情节综合自公开调研中的典型模式,文中引用的第三方统计数字则真实可查——这是复合案例的正确标注方式)。
- 作者与案例的关系必须写明:亲历、二手、公开材料整理,三选一。
- 涉及在世公司与个人的负面内容,只用已公开报道的事实,不加评价性措辞。 写「2025 年 2 月,公司欠薪超过 800 万元,裁员比例 66%(界面新闻报道)」,不写对当事人能力或人品的判断。上市公司还需注意静默期与内幕信息的边界,未公开的经营数据不要写。
一页空白模板
复制下面这段开始写。文件名用英文 slug,中文案例可用拼音,例如 anker-internal-fde.md。
---
title: 案例标题(一句话说清主体和结果)
updated: YYYY-MM-DD
---
# 案例标题
> 证据等级:A / B / C。作者与案例的关系:亲历 / 二手 / 公开材料整理。
> 脱敏范围:(写明哪些信息被隐去、为什么)
## 背景
甲方(行业、规模、处境)|交付方(内部团队 / 外部服务商 / 厂商 FDE)|时间窗口
## 问题
用甲方原话写题目。为什么当时难。
## FDE 做了什么
按时间顺序写动作,写清每个动作放弃了什么。
(如果有决策点,列出当时的 2 到 3 个真实选项和各自的代价。)
## 结果
| 指标 | 起点 | 终点 | 口径与时点 | 来源方 |
|---|---|---|---|---|
| | | | | |
(无法量化的结果写成定性结论,并说明为什么量化不了。)
## 教训
1. 下次遇到 X 信号,就该 Y。
2. ……
## 来源
1. 标题|作者或机构|日期|URL|支撑的具体事实
2. ……
**保留意见**:(列出你查不到的部分,以及哪些判断是推论而非事实)投稿检查清单
提交前逐条打勾。
- [ ] 六段齐全,没有把「FDE 做了什么」和「结果」混在一起写。
- [ ] 每个数字都有口径、时点、来源方,没有出现无基准的百分比。
- [ ] 「准确率 100%」「效率提升 300%」这类表述已经删掉或改写成有分母的说法。
- [ ] 教训写成了「下次遇到 X 就 Y」,没有出现「要以客户为中心」。
- [ ] 来源逐条可点开,每条对应到具体事实。
- [ ] 有独立的「保留意见」段,写清楚查不到什么。
- [ ] 证据等级已标注,且按最弱的那条事实定级。
- [ ] 脱敏范围与作者关系已声明。
- [ ] 涉及在世公司与个人的负面信息,全部有公开报道支撑,没有加评价。
- [ ] 篇幅 1200 到 2000 字。数字能精确就不用「大幅」「显著」。
- [ ] 至少链到本库两个其他页面。
失败案例尤其欢迎。 本库最缺的是败例,尤其是中国的、由当事人自己写的败例。
延伸阅读
- README.md — 案例库索引与证据等级约定。
- global-cases.md、china-cases.md — 已收录案例,可以直接当写法参照。
- ../05-practice/README.md — 失败模式清单,写败例前值得先看一遍,避免重复描述已知模式。
- ../04-methodology/README.md — 结果一节要用的口径与算账方法。
来源
- 本模板的六段结构与「投稿标准」参考了 fde-arsenal 案例库 README中的投稿规范(任鑫整理,2026 年 8 月)。本库在其基础上增加了证据等级判定表与数字口径规则。
- 「找绝对值和有分母的数字,跳过百分比」这条判断规则,来自对国内多家 AI 交付商公开案例页的对照阅读,反例见 china-cases.md#c7。