入门课程 · Level 1 · 一天入门 · 七天变现

小白 FDE 炼金术:一天入门,七天变现

把 4 个区、18 个阶段的完整交付链路,压缩成 8 天能亲手走完的一遍:第 1 天装上世界观与工具箱,第 2–8 天每天过一道门禁、交出一件拿得出手的产出。建议总投入约 22 小时(D1 全天 6 小时,D2–D8 每天约 2.25 小时),全程零 API key 可跑通。

「变现」指什么:把能力变成可展示、可检验、可对客交付的产出(作品集 + 话术 + 一条亲手跑通的链路)——不承诺就业、不承诺收入;所有客户案例均为虚构演示数据。

整门课就是这一页:25 篇文档按顺序排在下面,左侧章节栏随滚动高亮,每章末尾的文件名指向仓库里的源文件(course-level-1/)。

25
篇文档
227
个小节
207
段代码
316
项练习

小白 FDE 炼金术 · Level 1

README

course-level-1/README.md

一天入门,七天变现。 把一个"没上过客户现场"的小白,8 天锻造成能独立跑通一条交付链路、 手里握着 8 件可展示产出的准 FDE(前线部署工程师)。

⚠ "变现"指什么:本课的"变现"= 把能力变成可展示、可检验、可对客交付的产出 (作品集 + 话术 + 一条亲手跑通的链路)——不是承诺涨薪或接单收入, 见下方「诚实边界」。

  • 建议总投入:约 22 小时(D1 全天 6 小时 + D2–D8 每天约 2.25 小时),8 天完课
  • 知识底稿:00-FDE方法论历史与原理.md —— 课程的历史 / 原理 / 方法论地基,回答"FDE 从哪来、为什么是现在、到底怎么做"
  • 平台层:fde-scope —— 本仓库的主页/门户 + 自研 FDE 工具与流程平台(CLI + Web 控制台 + Python 库),零 API key 可全程跑通
  • 工具纪律:不要求换工具——你现有的编码 / 办公 Agent 照常用,课程只叠"流程与门禁层",见 01 §6.4
  • 交付形态:线上直播训练营(默认)/ 自学版 / 企业内训版 / 影子项目(加档);对外价格分 L0–L3 四档,L0 永久免费,见 04-交付实施手册.md §1.2
  • 诚实边界:本课程训练"交付能力与作品集",不承诺就业、不承诺收入;所有客户案例均为虚构演示数据

1. 一句话讲清这门课

市面上讲 FDE 的内容大多停在"概念解释":FDE 是 Palantir 发明的、薪资很高、要懂技术又懂业务。 这些话没错,但解释不等于会用。要把它们连成一条能走的链路,得先看底稿 00—— 里面讲了这三句话背后的历史因果、经济学原理和可执行方法论。 这门课不解释,只炼金——把 4 个区、18 个阶段的完整交付链路,压缩成 8 天能亲手走完的一遍:

第 1 天入门:装上世界观 + 工具箱,亲手跑通第一条迷你链路。 第 2–8 天变现(= 每天交出一件能拿出手的产出):每天过一道"门禁"(gate),交出一件老板/客户看得懂的产出。 第 8 天,你手里不是笔记,而是一套作品集 + 一套话术。


2. 适合谁 / 不适合谁

适合 不适合
刚入职或即将入职的 FDE / 交付工程师(企业内训) 想学模型训练、微调、算法竞赛的人
想转型的技术人:测试、运维、前端、数据、后端 完全不碰电脑、不愿敲命令行的人
想进 AI 交付赛道的应届生、产品经理、售前、实施 只想听概念、不做作业的人
已经在客户现场、但总在"救火"没有章法的工程师 期待"包就业 / 包涨薪"的人

先修要求(很低):能装软件、能复制粘贴命令行、能读懂表格。不需要会写 Python—— 所有命令都提供可复制版本,代码细节是 Level 2 的事。


3. 学完你能拿走什么

8 件产出(作品集):

# 产出 对应交付区
1 迷你链路跑通证据 + FDE 一页纸世界观 入门日
2 客户委托单 Engagement Charter(画像 / 干系人地图 / 成功标准) Zone A · 定边界
3 数据体检报告(字段 / 缺失 / PII / 分布) Zone B · 接数据
4 语料锻造报告 CorpusReport + 对客户的话术 Zone B · 造语料
5 可演示原型 + 评估结果 + 3 个 bad case Zone B · 验证与评估
6 Runbook + SLO 卡 + 值班交接卡 Zone C · 稳得住
7 交接包 Handoff Package + 1 条技能沉淀 Zone D · 交得出去
8 作品集(求职版 / 内部汇报版 / 接单版三套包装) 变现日

3 项能力:

  • 知道(K):用大白话讲清 FDE 交付链路、4 区 18 阶段、能认出 5 个以上反模式
  • 会做(S):独立跑通 connect → corpus → eval → handoff 全链路并解释每一步的为什么
  • 心态(A):先成功标准后代码;一切产出可验证;不演 demo,交真东西

4. 学习地图

flowchart LR
    subgraph D1["Day 1 · 入门日(一天入门)"]
        direction TB
        A1["世界观:FDE 是什么<br/>交付链路地铁图"] --> A2["三律:先标准后代码<br/>真实数据 · 可验证"]
        A2 --> A3["工具箱:fde-scope 五分钟冒烟"]
        A3 --> A4["🎯 产出 1:迷你链路证据"]
    end
    subgraph W["Day 2–8 · 变现周(七天变现)"]
        direction TB
        B["Day 2 · Zone A 定边界<br/>🎯 客户委托单"] --> C["Day 3 · 接数据<br/>🎯 数据体检报告"]
        C --> E["Day 4 · 造语料<br/>🎯 语料报告+话术"]
        E --> F["Day 5 · 原型与评估<br/>🎯 Demo+bad case"]
        F --> G["Day 6 · 运维化<br/>🎯 Runbook+SLO"]
        G --> H["Day 7 · 交接与沉淀<br/>🎯 交接包+技能卡"]
        H --> I["Day 8 · 变现日<br/>🎯 作品集三套包装"]
    end
    D1 --> W
    A4 -.->|"G1 通关"| B
    classDef out fill:#e8f4fd,stroke:#2471a3;
    class A4,B,C,E,F,G,H,I out

每个 🎯 都挂着一道课程门禁:不交产出、或产出不含"证据",就不能进下一关—— 和 fde-scope 的 Engagement.advance() 同一个哲学:门禁是工程,不是清单。

开课前:先花 20–40 分钟读 00-FDE方法论历史与原理.md §0 指定的两节, 你会带着"为什么"进 D1,而不是带着一堆要背的名词。历史与原理不占 D1 的认知额度(D1 只允许 3 个新概念),它们是课后读物与讲师备课底料。


5. 文档导航

知识底稿(先读这份)

文档 内容 主要读者
00-FDE方法论历史与原理.md 历史(从哪来)· 原理(为什么是现在)· 方法论(到底怎么做):Palantir 与 Ontology、范式转移与三道门槛、80/95/99 与前线学习机制、4 区 18 阶段与时间盒、来源清单与引用纪律 全体(学员开营前 / 讲师备课 / 面试与客户现场速查)

课程设计

文档 内容 主要读者
01-课程设计说明书.md 学员画像、学习目标、设计原则、1+7 天架构、与 18 阶段映射、课程边界 课程研发、教研
02-逐日教学大纲.md Day1–Day8 逐时段大纲:目标 / 内容 / 活动 / 产出 / 时长 / 门禁 讲师、教研
03-评估体系与通关门禁.md 三层评估、G0–G8 门禁表、评分量表、作品集与证书标准 教研、助教、学员

交付

文档 内容 主要读者
04-交付实施手册.md 四种交付形态、四档透明定价与成本算法、助教规模化、排期模板、人员配置、课前中后清单、应急预案、交付验收 项目负责人、运营
05-讲师手册.md 带教脚本、提问库、演示台词、卡点解药、控场技巧 讲师、助教
06-学员手册与作业包.md 学习契约、开营前自检、8 天任务卡、自查清单、提交规范、求助路径 学员
07-实战剧本与案例库.md 5 个虚构客户案例 + Day2–8 演练剧本 + 角色卡与评分要点 讲师、学员

逐节教案(D1–D8 逐分钟执行稿)

文档 内容 主要读者
16-D1逐节教案.md Day 1 全部 8 节课:世界观 + 工具箱 + 环境冒烟 讲师、助教
17-D2逐节教案.md Day 2 全部 6 节课:定边界(范围、假设、验收标准) 讲师、助教
18-D3逐节教案.md Day 3 全部 6 节课:接数据(先看再装) 讲师、助教
19-D4逐节教案.md Day 4 全部 6 节课:造语料(把矿石炼成金属) 讲师、助教
20-D5逐节教案.md Day 5 全部 6 节课:验证与评估(用证据说话) 讲师、助教
21-D6逐节教案.md Day 6 全部 6 节课:运维化(让东西稳得住) 讲师、助教
22-D7逐节教案.md Day 7 全部 6 节课:交接与沉淀(交得出去,带得走) 讲师、助教
23-D8逐节教案.md Day 8 全部 5 节课:变现日(把 7 件产出换成职业资产) 讲师、助教

运营

文档 内容 主要读者
08-运营手册.md 招生 → 开营 → 日常 → 结营 → 复训全流程、社群 SOP、激励、FAQ 运营、班主任
09-运营指标与复盘.md 北极星、漏斗、健康度指标、预警线、周报/期报模板 运营负责人
13-GTM页面与竞品对比.md 可直接粘贴的招生页 + 竞品横向对比(含来源与查证日期)+ 优势劣势诚实评估 + 招生 FAQ + 发布前合规自查 运营、招生、课程负责人
15-公信力与结果度量.md 证书边界与编号规则、第三方认证路径、对外五项结果指标与发布纪律、公信力资产待办 课程负责人、运营、市场

变现与支撑

文档 内容 主要读者
10-变现路径与结营包.md "变现"三层定义、作品集装配、简历/汇报/面试题库、求职包与内推池规则、结营包 学员、就业辅导
14-课后纵深与影子项目.md 结营后 90 天纵深学习路线、影子项目(形态 D)准入与数据合规、复训与进阶 学员、运营、课程负责人
11-工具与环境准备.md 环境安装、冒烟测试、无 key 降级路径、故障排查、数据合规 全体
12-附录-术语表与模板库.md 中英术语表 + 全部可复制模板 + 概念→命令映射 全体
en/README.md English quickstart(不是课文翻译):语言策略、8 天弧线、零 key 上手命令、诚实边界、L0–L3 档位 英文读者、对接人

6. 怎么用这套文档

  • 要开一期训练营:先读 00 + 01 定世界观与目标 → 04 排期与建群 → 05 备课 → 08/09 开运营看板 → 开营。
  • 企业内训(只有 3 天):读 04 的「压缩排期」一节,把 Day1+Day2+Day5 保留,其余转为自学任务;00 的 §1/§2 作为学员课前读物留作业。
  • 自己学(无教练):11 装环境 → 00 先建立世界观(§0 有 20/40 分钟两种读法)→ 06 按每日任务卡做(素材取自 07 案例库、模板复制 12)→ 用 03 的门禁表给自己判分 → 10 装配作品集。 自学版没有助教复核,请务必自己补两件事:① 每件产出找一位同学或 AI 助手做"第三方复核"(03 §4.1 优秀档要求);② D5 的坏例子复盘不要跳——那是全课最值钱的一步。
  • 课程迭代:每期结束按 09 的期报模板复盘,改进项写回 02/05/08,形成课程自己的"飞轮"。

7. 设计依据(一句话版)

  • FDE 方法论 / 历史 / 原理:见 00-FDE方法论历史与原理.md——Palantir 与 Ontology 的来路、范式转移与三道成本门槛、80/95/99 与前线学习机制、Echo·Delta 与双向蒸馏;末尾附来源清单与引用纪律(每个市场数字都带来源与日期,源间冲突以 ⚠ 标注不擅自定论)。
  • FDE 最佳实践:源自本仓库 docs/fde_sop_full.md(4 区 18 阶段、10 门禁、12 反模式)与 docs/fde_playbook.md(现场 72 小时手册)。
  • 课程设计最佳实践:逆向设计(先定证据再定教法)、Bloom 认知层级、认知负荷控制(每天 ≤3 个新概念)、Kolb 体验学习循环(演示 → 复盘 → 讲解 → 动手)、刻意练习与间隔重复、同伴互评。详见 01-课程设计说明书.md 第 5 节。

8. 版本与维护

项 说明
课程版本 Level 1 · v1.0(设计稿)
文档数 25 份(00 知识底稿 + 01–15 主线 + 16–23 逐节教案 + 本 README;en/README.md 为英文快速入门,另计)
配套工具 fde-scope,命令以仓库根 README.md 为准
案例数据 全部虚构(茶语万象 / 迅捷出行 / 南湾汽车等),与真实公司无关,仅作演示
更新触发 fde-scope 的 18 阶段 / 10 门禁发生变更时,同步更新 01 的映射表与 02 的大纲

00 · FDE 方法论、历史与原理

00

course-level-1/00-FDE方法论历史与原理.md

这是全课程的知识底稿,回答三个"为什么": 历史(FDE 从哪来)· 原理(为什么是现在)· 方法论(到底怎么做)。

其余 13 份文档讲的是"怎么教、怎么交、怎么运营";本文件是它们的共同地基。 读完它,你在客户现场才有判断力——否则只是照着流程做动作。


0. 怎么用这份文档

你是 读哪里 花多久
学员 · 开营前 §1.0 速通版 + §7 一页纸总结 20 min
学员 · D1 之前 §1 历史 + §2 原理(跳过 §3 细节) 40 min
讲师 / 教研 全读,§3 与 docs/fde_sop_full.md 一起备课 90 min
面试 / 客户现场 §5 常见追问 30 min

阅读纪律(全课通用):本文件出现的市场数据、薪资、公司事件一律标注来源与查证时间; 带 ⚠ 的条目表示两个来源有出入,对外引用前必须自己再核一次。 这不是谨慎过头——是 FDE 的第一条职业习惯:数字要能追到源头(10 §8 查证纪律)。


1. 历史:FDE 从哪来

1.0 速通版(30 秒)

FDE 不是 2024 年新发明的岗位,它 2003 年就在 Palantir 存在了。为什么 20 年后突然爆火?

一句话:AI 让"到客户现场边做边学"这件事,第一次变得划算。

三个关键节点:

  1. 2003 —— Palantir 创立,工程师被派进 CIA / 五角大楼现场 → FDE 诞生
  2. 2023 —— 大模型能力起来,但企业落地率极低 → 缺口出现
  3. 2024–2026 —— OpenAI / Anthropic / 咨询巨头全部组建部署团队 → 岗位爆发

下面把这三步展开。

1.1 FDE 的三位前身(为什么这个角色必然出现)

在 FDE 这个词出现之前,"到客户现场把技术变成结果"这件事, 已经被三种角色各自干了一部分:

前身 干什么 缺什么
解决方案架构师 / 售前 讲清方案能不能做 讲完就走,不负责跑起来
实施 / 交付工程师 把成熟产品装起来 只能"配方化"交付,产品不成熟就抓瞎
驻场外包 / 咨询顾问 客户要什么做什么 经验留在个人脑子里,不回产品

FDE = 三者的合体 + 一个新东西:把现场经验回流成产品能力。 少掉最后这一块,FDE 就退化成"更贵的外包"(§2.6 会展开)。

类比:售前是"试驾员",实施是"装车工",外包是"代驾"。 FDE 是跟车队跑完整个赛季的随队工程师——既要开得动, 又要把每一站的数据带回工厂改车。

1.2 起源:Palantir(2003–)

  • Palantir 2003 年成立,早期把工程师直接派进 CIA / FBI / 五角大楼现场
  • 解决的问题:政府客户的数据散落在几十个系统里,决策靠人肉拼图
  • 因为客户环境高度保密,做不到"把需求带回去再开发"——只能把人派进去
  • 结果:FDE 模式帮 Palantir 拿下政府客户,并成为它 20 年的组织基因

Palantir 的产品线是三层叠起来长出来的。理解这三层,就理解了 FDE 的技术底座:

产品 定位 谁在用 FDE 在这里做什么
Gotham 情报与安全分析平台 军方、情报机构、执法部门 最早的 FDE 团队在此诞生:需安全许可、进保密环境,做目标追踪、关系分析、态势感知
Foundry 企业数据操作系统 商业企业、政府民用部门 FDE 的主战场:把企业异构数据映射为 Ontology,在客户现场建模、搭应用、做集成
AIP AI 能力层(2023 推出) 叠加在 Gotham / Foundry 之上 让大模型通过 Ontology 理解业务,而不是裸读数据库;FDE 在 Bootcamp 里用 AIP 快速搭原型

(来源:腾讯研究院《FDE 模式行业观察与实践》第 03 章 §3.1,查证于 2026-09)

一个反直觉的事实:Palantir 2025 财年毛利率约 82%,已接近纯软件公司水平, 远高于传统咨询公司 30%–40% 的区间(来源同上)。 —— 这说明"重交付"和"高毛利"可以同时成立,前提就是 §2.6 讲的前线学习机制。

1.3 Ontology:Palantir 真正的护城河

这一节是全文最值钱的一页。如果只能记住一个技术概念,记 Ontology。

问题:Palantir 早期给每个情报客户建数据库,都是"给'人'建一张表、给'资金'建一张表"。 每换一个客户,就要从零重建一遍。 这生意做不大。

解法:把抽象层级拉高。底层只保留四类原语——

对象 objects  ·  属性 properties  ·  媒体 media  ·  对象之间的链接 links

四类原语搭出来的东西,就是这个行业的统一业务语言。

白话理解"本体(Ontology)":

它不是数据库,也不是知识图谱的炫技版。 它是把"这个行业里到底有哪些东西、它们怎么互相牵扯、能对它们做什么" 写成一份机器能读的字典。

例:金融行业有「账户 / 客户 / 交易 / 授信 / 审批 / 风险事件」; 教育行业有「学生 / 课程 / 作业 / 教案 / 评价 / 教务流程」。

Ontology 分三层,这个分法直接解释了**"为什么 AI 需要它"**:

层 回答的问题 装什么
语义层 Semantic 世界里有什么 核心业务对象和属性、实体定义、属性 schema、元数据映射
动势层 Kinetic 可以做什么 Action 定义、权限模型、审批流程、函数
动态层 Dynamic 正在发生什么 实时数据管道、事件流、状态机

关键结论:

没有这层语义抽象,AI 只能停留在问答和摘要;有了它,AI 才有可能进入流程执行。

这也是 FDE 现场的通用武器——不管客户用的是 Palantir 还是别的平台, "先把业务对象讲清楚"这一步永远绕不过去。 (本仓库对应命令:fde-scope ontology,见 12 §3)

一个耐人寻味的组织细节:Bob McGrew(前 Palantir 高管、前 OpenAI 首席研究官)回忆, Palantir 很长时间不招产品经理(来源同上)。 —— 因为"产品定义"这件事,是由在现场的 FDE直接从客户那里学回来的。

1.4 2024–2026:从一个小众岗位到行业标配

时间 事件 意义 来源
2003 Palantir 成立,FDE 模式诞生 起点 Palantir 官方 / fde-research.md
2023 AIP 推出,AI 能力层叠加到 Ontology 上 技术上准备好 腾讯研究院报告 Ch.03
2024-04 全球 FDE 职位约 600+ 条 基线 fde-research.md §2.2
2025-04 全球 FDE 职位约 6000+ 条(10 倍增长) 拐点 fde-research.md §2.2
2025-04 → 2026-04 Indeed 平台从 643 条 → 5330 条,年增 >700%;a16z 观察增幅 800%–1000% 爆发 腾讯研究院报告 Ch.01 §1.5
⚠ 2025-09 或 2026-05 OpenAI Deployment Company 成立 里程碑(两来源日期不一致,见 §1.6) fde-research.md / 腾讯研究院报告
2026-01 Anthropic 与高盛 / 黑石合作,组建部署团队 金融 FDE fde-research.md §2.2
2026-01 Accenture + Microsoft 成立 FDE 实践 咨询 + 科技巨头入局 fde-research.md §2.2
2026 国内 FDE 招聘增长 42 倍 中国市场爆发 fde-research.md §2.2

几个比数字更有信息量的观察(来源:腾讯研究院报告 Ch.01 §1.5):

  • YC 旗下创业公司中已有上百家招聘 FDE,三年前这一数字几乎为零。
  • 采用 FDE 模式的 AI 公司,前 18 个月 ARR 增速平均比同行快 3 倍, 但客户成功团队规模只有同行的三分之一。 → 这说明 FDE 不是在堆人,是在换组织形态。
  • OpenAI 官方对 FDE 的定位:

    "FDE 的工作不是单纯接入模型,而是与业务领导者、运营人员和一线团队一起 识别 AI 的高价值场景,围绕 AI 重构组织基础设施和关键工作流, 并把收益转化为可持续运行的系统。"

三种组织路径(没有标准答案,看公司阶段):

路径 优势 代价
内部团队型 产品反馈链短,客户经验更容易进入平台 扩张慢,依赖高密度人才培养
生态放大型 覆盖广,适合中腰部客户复制 伙伴质量参差,交付标准不统一
独立实体型 起量快,便于整合资本和咨询渠道 现场问题可能难以回流母公司研发

(来源:腾讯研究院报告 Ch.01 §1.5)

给学员的读法:你大概率是从"内部团队型"的一线进去的。 记住你在这张表里的位置——你每天的现场工作,都在决定公司走哪条路。

1.5 中国市场的三个特殊性(必须知道,否则会照搬错经验)

① 我们缺的不是 FDE 的前身,缺的是"闭环"

云厂商的解决方案架构师、交付工程师,以及 AI 创业公司里的 AI 售前、 AI 应用工程师、行业落地工程师——这些角色国内早就有,职能高度相似。 差异在于:较少形成"现场经验反哺产品和平台"的闭环(即 §2.6 的第三步)。

→ 所以国内做 FDE,第一步是把闭环补上,不是把岗位名字改掉。

② 美国是"加装大脑",中国是"对话驱动"

美国的 ERP / CRM / ITSM 沉淀得比较完善,AI 更像"在一台精密机器上加装智能大脑"。 中国的很多企业更像"对话驱动":需求常以非结构化方式提出,协作依赖即时沟通, 决策链条高度依赖关键负责人——

流程常常不写在系统里,而写在默契和人情里。

(来源:腾讯研究院报告 Ch.01 §1.6)

这听起来像劣势,其实是跳级机会:

过去的软件要求客户先填表、画流程、配规则; AI 的入口是自然语言——很多客户未必能先把流程画清楚再上系统, 反而更适合在 FDE 陪跑下**"一边跑、一边修路"**。

③ 经济性约束是真实的

硅谷的高价值客户可以支撑六到七位数美元的年合同; 国内大量项目仍在十万到百万人民币量级。 → 所以中国 FDE 必须解决两个问题: 一是用 AI 和平台能力压低交付成本;二是用 Skill、连接器、行业模板和伙伴生态提高复用率。

(来源同上)

这段话是对学员最实用的一句。 它解释了为什么本课程反复强调 "沉淀技能卡""交接包""留痕"——不是为了好看, 是为了让单个人的现场经验变成可复用的资产, 否则国内的项目经济性根本撑不住。

1.6 ⚠ 事实核查待办(对外引用前必读)

本文件有两处来源冲突,已如实标出,不装作只有一个答案:

冲突项 来源 A 来源 B 建议
OpenAI Deployment Company 成立时间 fde-research.md 记为 2025-09 腾讯研究院报告 Ch.01 §1.5 记为 2026 年 5 月,并提到拟收购 Tomoro、约 150 名 FDE 与部署专家,且称 Anthropic 同日宣布组建部署团队 对外引用前自行复核(建议以 OpenAI 官网新闻页为准);课程内部表述统一用"2025–2026 年间"
Indeed 招聘数量口径 fde-research.md:2024-04 约 600+ → 2025-04 约 6000+ 腾讯研究院报告:2025-04 为 643 条 → 2026-04 为 5330 条 两者时点不同、并不矛盾;引用时必须同时给出时点,禁止只说"增长 10 倍"

薪资参考(2026 北京,BOSS 直聘 / 京津冀大数据中心口径,来源 fde-research.md §2.3):

岗位 月薪
AI FDE 40–70K
资深 FDE 70–100K
FDE 团队 Lead 100K+
OpenAI 风格 FDE(美国) 100K+ 美元 / 年

⚠ 不得当作承诺或预期(01 §9 第 3 条): 薪资受城市、公司、年限、面试表现影响极大。课程只要求你知道"这个岗位在涨", 不要求你相信"你一定能拿到这个数"。


2. 原理:为什么是现在

历史回答了"从哪来";原理回答的是**"为什么 2023 年之后这件事突然成立"**。 理解了原理,你在客户现场才有判断力。

2.1 范式转移:从"卖席位"到"持续使用"

传统 SaaS 的生意逻辑:产品标准化 + 规模化扩张,边际成本趋近于零。 这套逻辑非常适合 CRM / HR / 财务 / 协同办公。 但它覆盖不了"非标、跨系统、强流程、强组织约束"的工作。

AI Agent 时代,客户要的东西变了:

企业要的不是一个模型,也不是一个通用 API,而是一个能把事情做完的流程。 这个流程涉及:数据接入、权限体系、流程适配、合规审计、异常处理、人工兜底。

结果是商业模式的位移:平台收入从"卖席位"转向"持续使用"—— 本质上是在放大客户生命周期价值(LTV)。 (来源:腾讯研究院报告 Ch.01 §1.1)

给学员的翻译:SaaS 卖的是"座位数",Agent 卖的是"这个流程跑得怎么样"。 座位数在合同签完就确定了;流程跑得好不好,要有人持续盯着—— 那个人就是 FDE。

2.2 三道成本门槛:AI 降低了哪三道

这是"为什么是现在"的核心答案。

过去,"到客户现场做重交付"这件事只有少数公司能承担,因为有三道成本门槛:

# 门槛 过去为什么贵 AI 降低了什么
1 行业知识蒸馏 要把老师傅脑子里的隐性经验写成规则,靠人访谈、人整理,慢且贵 大模型能从文档、对话、工单里快速抽取行业知识,蒸馏成本大幅下降
2 定制开发 每个客户都要从零写代码、搭系统 AI coding 让原型与定制的边际成本显著下降
3 复合型人才供给 同时懂业务 + 懂技术 + 懂交付的人极少,培养周期以年计 AI 把"技术侧"的门槛拉低,让更多有业务感的人能上手

一句话记住:

AI 同时降低了这三道门槛,使过去只有少数公司能够承担的重交付模式, 开始具备更广泛的商业可行性。

(来源:腾讯研究院报告 Ch.01 开篇)

重要提醒:门槛降低 ≠ 门槛消失。 第 3 条最容易误读——AI 降低了 Delta(做出来)的门槛, 但没有降低 Echo(想清楚做什么)的门槛。详见 §2.6。

2.3 机制链条:五步推演

把上面的结论串成一条因果链,这就是整个 FDE 现象的完整机制:

需求异质化 + 效果不确定
        ↓
必须做可运行 Demo 来验证
        ↓
售前必须具备交付能力(前置)
        ↓
AI 降低了原型与定制成本
        ↓
FDE 成为更可行的组织形态

逐句解释:

  1. 需求异质化 + 效果不确定 —— 每个客户的流程都不一样, 而且没人能保证 AI 在这个场景下一定有效。
  2. 必须做可运行 Demo 来验证 —— 既然说不清,就只能做出来看。
  3. 售前必须具备交付能力 —— 如果 Demo 要在签单前做出来, 那么"售前"就不能只会讲 PPT:售前与交付的边界被打穿了。
  4. AI 降低了原型与定制成本 —— 否则第 3 步在经济上不成立 (先免费干一遍,谁也扛不住)。
  5. FDE 成为更可行的组织形态 —— 把"能做 Demo 的人"和"能交付的人" 合并成同一个角色。

一条必须记住的纪律(来源:腾讯研究院报告 Ch.01 §1.2):

Demo 的意义不是替代生产系统,而是提前暴露风险。 健康的 FDE 模式不是把 Demo 当成结束, 而是把 Demo 当成进入生产验证和经验积累的起点。

→ 这正是课程 D5 批判 Demo-Debt 的原理依据(fde_sop_full.md 反模式 #4)。

2.4 80 / 95 / 99 规律:FDE 的战场在哪里

企业级 AI 落地有一条"80/95/99 规律":

阶段 需要什么 难度感受
0 → 80% 通用大模型 + 简单 Prompt 很容易——有经验的工程师一天就能搭出"挺好用"的原型
80% → 95% 大量 Prompt 优化、规则补充、数据标注、测试集构建 难——模型在特定场景出错、行业术语理解不准、边界情况处理不了
95% → 99% FDE + 专用平台 + 上万级真实对话数据 非常难——1% 的错误也可能造成严重后果(品牌事故 / 合规风险);且 AI 测试不同于传统软件测试,常常"改好 A 又坏 B"

所以:

FDE 不是做从 0 到 80% 的活,而是做从 80% 到 99% 的活。

这就是为什么"会用 AI 工具"和"能做 FDE"差距巨大。 会搭 Demo 的人很多(0→80);能把 Demo 变成生产线上稳定系统的人很少(80→99)。

为什么上限是 99%,不是 100%? 三条理由:

  1. LLM 是概率系统——数学上不存在 100% 保证;
  2. 从 99% 推到 99.9%,边际成本指数级增长、边际收益递减;
  3. 高风险场景那 1% 不应该让 AI 覆盖,而应通过人工审核和回滚机制兜底。

(来源:腾讯研究院报告 Ch.01 §1.3)

这是全文最漂亮的一句话,建议背下来:

99% 不是技术妥协,而是工程经济学的最优解: AI 覆盖可规模化的 99%,人工守住不可自动化的 1%。

现场应用:客户说"我要全自动、不出错"时,用这句话回应—— 然后带他一起设计那 1% 的人工兜底流程 (这正是课程 D6 的 Runbook,与反模式 #11 No HITL 对应)。

AI 落地的三个阶段(决定你在客户面前该讲什么):

阶段 内容 时间尺度
1. 个人提效 一线员工用 AI 提高个人产出 以年为单位
2. 组织转型 打破"人肉 API"式中间层,重排流程与责任 以年为单位
3. 业务重构 把行业隐性知识沉淀为本体,重构业务本身 以年为单位

一个关键判断:

FDE 不是一个新增岗位,而是所有面向客户角色的能力升维。 售前、架构师、客户成功,都在向 FDE 靠拢。

2.5 能力-采用剪刀差:缺口到底卡在哪

两个数字(来源:腾讯研究院报告 Ch.01 §1.4):

  • 超过 70% 的企业已在至少一个职能中尝试生成式 AI;
  • 超过 60% 仍停留在试点或实验阶段。

60% 停留在试点,意味着绝大多数企业的 AI 项目没有走到生产。 而 AI 能力本身还在快速上涨——两条线之间的开口,就是"剪刀差"。

瓶颈不在模型能力,也不在工具,而在人:

真正卡住的是最后 20% 的生产化工程。 产品瓶颈正在从"工具"转移到"人"。 FDE 的核心价值也随之变化:不是单纯帮客户搭系统,而是帮客户想清楚 做什么、为什么做、做到什么程度,以及做完之后如何持续产生业务结果。

这就是本课程"三律"第一律"先成功标准后代码"的出处(D1 M3)。 它也是 §2.2 那句话的证据:AI 降低了 Delta 的门槛,没降低 Echo 的门槛。

2.6 前线学习机制:FDE 的"发动机"

这是全文最重要的一节。 前面讲的是"为什么有机会",这一节讲的是**"凭什么能持续赚钱"**。

① 根本矛盾(所有 ToB 重交付模式共同的死结)

现场做得越深,对个人经验的依赖越重;规模越大,利润越薄。

这就是"外包"这门生意永远做不大的原因。 FDE 之所以被单独拎出来讨论,是因为它试图在交付的同时完成学习—— 把一次客户项目中暴露的行业知识、系统接口和流程规则, 沉淀为可复用的平台能力。

这个转化如果成立,重交付就有可能跑出规模经济; 如果不成立,FDE 最终只是换了个名字的外包。

② 名字造成的误导

FDE 很容易被误解成"更高级的驻场外包"或"更懂 AI 的实施工程师"。

  • "前线":关键不是物理位置,而是进入客户真实业务问题的一线;
  • "部署":关键不是安装系统,而是把模型、数据、流程、权限、 组织责任和业务指标,部署成可持续运行的结果。
③ 学习闭环三步(缺一不可)
① 重新定义客户问题   →   ② 交付为可验证结果   →   ③ 把现场经验带回来
   把客户"说出来的需求"      接听率、转化率、          行业里反复出现的流程、接口、
   翻译成真正值得做的        处理时长或人效           测试方法和合规要求,
   业务问题                  确实改善                 沉淀为可复用的平台能力

⚠ 缺少第三步,FDE 就会退化为高端外包。 这三步就是本课程 8 件产出的设计骨架—— D7 的技能卡与交接包,对应的正是第三步。

一个可操作的判断标准(现场很好用):

客户能被培训后自助完成的部分,不应长期依赖 FDE; 真正需要 FDE 的,是三种复杂度交织在一起、且最终可以沉淀为产品的场景。

④ Echo 与 Delta:两种跨边界能力
角色 管什么 核心问题 干什么
Echo 该做什么(输入侧) 理解客户业务:钱从哪里来、流程卡在哪里、AI 从哪个环节撬动价值 "客户要求的是一个功能,但真正需要的是重构某个流程;客户想买的是一个工具,但真正缺的是一套用起来的组织机制"
Delta 怎么做出来(执行侧) 快速建原型、接系统、调模型 AI coding 降低了 Delta 的技术门槛,但没有消除对工程判断的要求——粗糙原型可以,但不能没有质量底线;快速迭代可以,但不能忽视安全、权限和审计

关键组织结论:

Echo 与 Delta 不一定是两个岗位,而是两种角色。 发现回流贡献多的人逐渐承担 Echo,专注客户交付的人承担 Delta, 两者应获得不同的考核标准和激励方式。

对你的意义:不管你在哪个岗位,先有意识地问自己"我今天是 Echo 还是 Delta"。 只做 Delta,你会被 AI 持续压缩;能承担 Echo,你才有定价权。

⑤ 双向蒸馏:经验怎么变成资产

蒸馏有两个方向,很多人只知道第一个:

蒸馏方向 蒸馏对象 形成资产
面向客户(第一层) 员工经验、流程规则、隐性知识 知识库、工作流、SOP、业务应用
面向厂商(第二层) 行业场景、系统接口、测试方法、失败案例 Skill、模板、测试集、产品能力

载体是什么?就是 §1.3 讲的 Ontology(本体层):

实体、关系、属性,本质上就是结构化的业务知识图谱。 它把不同客户的字段名、编码、流程表达翻译成统一的业务语言。 从一个客户总结出来的本体,有机会复制到同行业另一个客户—— 不是把客户数据拿去训练模型,而是把行业知识沉淀成可复用抽象。 这些概念不属于任何一家企业,而属于共同的业务领域。

⑥ 延迟收益与规模效应(这套模式的"财务原理")

延迟收益:

沉淀本体的投入不会在当期项目中回收。第一个项目甚至前几个项目, 成本会比纯项目制交付更高。

规模效应:

做完一家标杆企业后,其他几十家甚至上百家类似企业可以复用同一套本体, 交付成本显著下降。 一个典型垂直领域里,七到八个客户做下来,本体基本趋向稳定, 后续更新幅度显著减小。

两条叠加:

FDE 模式本质上是一种先投入后回收的商业逻辑。 它不适合所有场景——如果一个领域只有一两个客户, 本体沉淀的性价比就不高。

现场判断:客户问"你们为什么贵",如果这个领域值得深耕, 正确答案不是打折,而是告诉他这笔钱买了两样东西: 这个项目的交付 + 属于他这个行业的知识资产。

⑦ 试金石:四级判据(一句话判断你是不是真 FDE)
只留给客户一个系统               →  外包
带回一些经验但无法复用           →  项目制交付
沉淀为 Skill / 模板 / 产品能力   →  FDE
沉淀后显著降低下个客户成本       →  可规模化 FDE

三个前提条件(缺一不可):

  1. 客户是否值得深耕——需求真实 + 业务参与
  2. 项目能否沉淀资产——流程有共性 + 数据可复制
  3. 公司有没有机制复用——头部经验能传递到中腰部

三项都不满足就是高端外包,三项都满足才可能成为"行业知识的蒸馏机器"。

两个辅助自检问题(季度问一次):

  • 产品边界每个季度是否在向产品侧移动?
  • 成熟客户的现场投入是否持续下降?

Bob McGrew 的度量原则(背下来,面试也常问):

如果第一个客户需要 10 个人-月,第十个同类客户仍然需要 10 个人-月, 模式就没有跑通。

⑧ 知识沉淀的载体怎么变:从知识图谱到 Skill
载体 优势 问题
知识图谱 / 本体 结构化强 构建维护成本极高
工作流编排 降低门槛 仍需较强技术能力
Multi-Agent 协作能力强 系统设计和调试复杂
Skill + 连接器(当前更值得关注) 轻、可组合、贴近工程实践 需要平台与流程配套

三者的分工:

本体解决"业务对象如何被理解", Skill 解决"能力如何被复用", 连接器解决"系统如何被操作"。 —— 分别对应知识沉淀、能力沉淀和系统连接沉淀。

产品厚度决定 FDE 的形态:

产品越薄,FDE 越像全能救火队;产品行业属性越厚,Skill 越成熟, 越多事情能沉淀进产品,FDE 的长期驻场属性也会随之减弱。

这就是本课程 D7"技能卡"与 fde-scope skill 命令的原理依据。 你写的那一张技能卡,就是"能力沉淀"最小可用的一个单位。

⑨ 一条必须知道的警示

AI 生成的结果可能 98% 是正确的,但要找出那 2% 的错误,人必须读完 100%。 不能给管理者形成"AI 来了,本体建模成本很低了"的错觉。 —— 这也是 Echo 团队成本不可回避的原因。

本节的结论(全文最重要的一句):

AI 会让 Delta 变便宜,却不会自动让组织更懂客户。 谁能系统性培养 Echo,谁才更可能把这套模式做成规模化商业。


3. 方法论:FDE 怎么做

本节是目录级导航。完整方法论见本仓库 docs/fde_sop_full.md(4 区 18 阶段 + 10 门禁 + 12 反模式) 与 docs/fde_playbook.md(现场 72 小时)。 课程只做"小白可执行"的裁剪,映射见 01 §6.2。

3.1 主方法论:4 区 18 阶段

一句话:把"到客户现场做交付"从口号, 变成可执行、可被门禁拦截的工程化流程。

Zone A · 定边界        ①qualification ②site-survey ③stakeholder-map ④success-criteria
Zone B · 造出来        ⑤connect ⑥corpus ⑦prototype-on-real-data ⑧validate ⑨deploy ⑩eval
                       (课程拆成三天:接数据 → 造语料 → 验证评估)
Zone C · 稳得住        ⑪slo-sla ⑫runbook ⑬monitoring-drift ⑭change-mgmt-training ⑮flywheel→productization
Zone D · 交得出去      ⑯ops-handoff ⑰knowledge-transfer ⑱disengage

为什么不是"5 步走完":

网上流行的 5 步模型(connect → corpus → deploy → eval → flywheel) 只覆盖 Zone B,约占真实项目的一半。 Zone A(4 阶段)、Zone C(5 阶段)、Zone D(3 阶段)是它完全缺失、 却决定项目成败的部分。 —— 这几块缺失,正好对应 §2.4 里"卡在试点"的那 60%。

每个区的"离开证据"(本课程按这个逻辑设 8 件产出):

Zone 离开时必须留下 课程产出
A · 定边界 可度量的成功标准 + 双发起人 产出 2 客户委托单
B · 造出来 真实数据上的原型 + 评估 + bad case 产出 3 / 4 / 5
C · 稳得住 SLO + Runbook + 值班安排 产出 6
D · 交得出去 交接包 + 知识转移 + 退场时间盒 产出 7

3.2 时间盒:抗"无限 Pilot"的三个数字

数字 含义 防的是什么
≤14 天 集成 拖成半年还没接上数据
≤90 天 上线 Demo 之后无限打磨,永不生产
≤120 天 交接 无限 Pilot,FDE 变成永久驻场

(来源:perspective.ai《FDE Founder Playbook 2026》,经 fde_sop_full.md 转引) → 课程 D2 的委托单必须写时间盒;D7 的退场计划必须写终止条件。

3.3 门禁:为什么清单会烂,门禁不会

清单 Checklist 门禁 Gate
谁来判 自己勾 系统 / 流程判(可执行、可复现、留痕)
不通过会怎样 打个折继续走 挡住,进不了下一阶段
记录 无 留痕(含强制放行)

"门禁是工程,不是清单。" —— fde_sop_full.md

本课程有两套门禁,别搞混(详见 03):

系统 数量 谁判 用在哪
课程门禁 G0–G8 9 道 讲师 / 助教 每天的教学进度
工具门禁 10 道 程序判(fde-scope) 真实项目的阶段推进

3.4 十二反模式:FDE 现场的高压线

完整解释见 docs/fde_sop_full.md。 课程的 D2–D7 每天重点警示 1–2 个。

# 反模式 一句话
1 Consulting Trap FDE 漂成定制咨询,饿死平台
2 Snowflake-Per-Customer 每客户一套,单位经济腐烂
3 Hero Engineer 单人英雄主义,知识孤岛
4 Demo-Debt Spiral Demo 演的平台做不到
5 Sponsor Collapse 唯一发起人离职即死
6 Burnout Death Spiral 高级 IC 先走
7 Probabilistic Degradation 无飞轮,线上退化无人知
8 Infinite Pilots 没人定义 done,飘过 180 天
9 Data Quality Surprises 假设数据已集中、已干净
10 Scope Creep 无时间盒 SLA
11 No HITL 缺人机协作
12 Safety Incidents 工业现场未经功能安全验证

原理对照(把反模式和 §2 的"为什么"连起来): #1 / #2 对应 §2.6 的"缺少第三步就退化为外包"; #8 / #10 对应 §3.2 的时间盒; #9 对应 §2.4 的"最后 20%"; #11 对应 §2.4 的"人工守住那 1%"。

3.5 现场打法:72 小时

到客户现场的前 72 小时做什么,见 docs/fde_playbook.md:

时间 动作
Day 1 上午 接入数据:先看后装(schema 探测 + PII 候选 + 类别分布)
Day 1 下午 锻造语料:清洗 → 质量门 → 覆盖度 → 补盲合成 → 出报告
Day 2 部署 Agent(三层隔离)+ 评估(用数据说话)
持续 飞轮:人工覆盖 → 高价值样本 → 周度增量调优

课程把这 72 小时压缩成 D3–D5 三天:动作一个不少,深度按小白裁。

3.6 能力模型:40 / 30 / 30

能力 占比 内容
工程能力 40% 全栈开发、部署、调试、运维
业务能力 30% 理解客户业务、拆解需求、定义成功
解决方案能力 30% 架构设计、技术选型、风险控制

(来源:docs/fde-research.md §3.1)

读法:40% 是入场券(Level 1 给你工程侧的起步 + 业务意识的种子), 后面 60% 才是区分水平的地方——而其中一大半(Echo 相关)只能在做中学。


4. 与本课程的对应关系(讲师 / 学员速查)

本文件的节 课程里在哪讲 用什么形式
§1.0 速通版 / §1.2 起源 D1 M1 世界观 讲师 15 分钟串讲 + 时间线图
§1.5 中国特殊性 D1 M1 结尾 讲 3 个小故事(不是讲报告)
§2.2 三道门槛 D1 M2 一句话带过,不展开
§2.4 80/95/99 D1 M3 三律("先成功标准后代码"的出处) 正式讲,画阶梯图
§2.5 剪刀差 D1 M3 只用一个数字(60% 停在试点)
§2.6 前线学习机制 D7 交接与沉淀(技能卡那一节) 只讲 ③⑤⑦ 三个子节
§3.1 4 区 18 阶段 D1 M2 交付地铁图 主内容,讲成 4 条地铁线
§3.3 门禁 D1 M2 + 全程 核心概念(只讲 1 遍会忘,每天重复)
§3.4 十二反模式 D2–D7 每天警示 1–2 个 分散讲,不集中灌
§3.5 72 小时 D3–D5 的实际操作 变成三天的手把手

认知负荷红线提醒(01 §5 原则 3):

D1 全天只允许出现 3 个新概念(交付链路 / 门禁 / 真实数据)。 本文件的 §1.4 时间线、§2.6 全部子节、§3.4 全部反模式,都不在 D1 讲—— 它们是讲师的备课底料、学员的课后读物。


5. 常见追问(面试 / 客户现场都用得上)

追问 回答要点(一句话)
FDE 是不是就是高级外包? 区别在第三步:外包把系统留下就走,FDE 还要把经验带回来变成可复用资产(§2.6 ③)
FDE 和售前有什么区别? 售前讲方案,FDE 在签单前就要让方案跑起来(§2.3)
为什么现在才火? AI 同时降低了行业知识蒸馏、定制开发、复合型人才供给三道成本门槛(§2.2)
大模型这么强,还要人干什么? 0→80% 很容易,80→99% 才是战场;而且最后 1% 必须人工兜底(§2.4)
FDE 会被 AI 替代吗? Delta 部分会被持续压缩;Echo 部分(判断该做什么)不会(§2.6 ④⑨)
怎么衡量一个 FDE 模式跑通没有? 第一个客户 10 个人-月,第十个同类客户还要 10 个人-月,就是没跑通(§2.6 ⑦)
国内做 FDE 和美国有什么不同? 国内流程写在默契和人情里 → 更适合"一边跑一边修路",但经济性约束更强(§1.5)
Palantir 凭什么毛利 82%? 靠 Ontology 沉淀行业知识,服务同类客户的成本逐次下降(§1.2 / §2.6 ⑥)

6. 来源清单与引用纪律

本文件的知识来源(全部可追):

来源 用在本文件的哪部分 性质
docs/fde-research.md §1.2 起源、§1.4 时间线、§1.6 薪资、§3.6 能力模型 本仓库内部研究稿
docs/fde_sop_full.md §3.1 4 区 18 阶段、§3.2 时间盒、§3.3 门禁、§3.4 反模式 本仓库方法论核心
docs/fde_playbook.md §3.5 现场 72 小时 本仓库现场手册
腾讯研究院《FDE 模式行业观察与实践》 §1.2 Palantir 三层产品与 82% 毛利、§1.3 Ontology、§1.4 招聘数据与组织路径、§1.5 中国市场、整个 §2 原理 外部行业报告(查证于 2026-09)
perspective.ai《FDE Founder Playbook 2026》 §3.2 时间盒数字 外部(经 fde_sop_full.md 转引)

引用纪律(与 01 §9、10 §8 同源):

  1. 市场数据必须带来源与日期——本文件已逐条标注,引用时不得剥掉。
  2. ⚠ 标记的条目(§1.6)对外引用前必须自行复核。
  3. 不承诺就业与收入;薪资数据只是市场观察,不是预期。
  4. 本文件提到的第三方产品与公司,仅作行业事实引用,不构成推荐或背书。
  5. 外部报告的观点(尤其 §2 原理部分)属于该报告作者的判断,本课程做了转述与课程化重构; 引用时请注明"转引自腾讯研究院报告",不要伪装成本课程的原创结论。

7. 一页纸总结(贴在显示器旁)

FDE 是什么   把 AI 从"演示"变成"生产线上跑得稳的结果"的人

历史          2003 Palantir → 2023 AIP → 2024~26 爆发(全球岗位 10 倍+,国内 42 倍)
              中国不一样:流程写在默契里 → 一边跑、一边修路

原理          三道门槛降了(行业知识蒸馏 / 定制开发 / 人才供给)
              战场在 80%→99%,不是 0→80%
              99% 是工程经济学最优解:AI 覆盖 99%,人守 1%
              缺口卡在"人":70% 在尝试,60% 停在试点
              Echo 决定做什么,Delta 做出来;AI 让 Delta 变便宜
              三步闭环:重定义问题 → 交付可验证结果 → 经验带回来
              缺第三步 = 高端外包
              试金石:第十个客户还要 10 个人-月?模式没跑通

方法论        4 区 18 阶段(定边界 / 造出来 / 稳得住 / 交得出去)
              时间盒 ≤14d / ≤90d / ≤120d
              门禁是工程,不是清单
              十二反模式 = 高压线

最后一句(§2.6 的结论,也是你在这行能走多远的判据):

AI 会让 Delta 变便宜,却不会自动让组织更懂客户。 谁能系统性培养 Echo,谁才更可能把这套模式做成规模化商业。


相关:01-课程设计说明书.md · 02-逐日教学大纲.md · docs/fde_sop_full.md · docs/fde-research.md · docs/fde_playbook.md

01 · 课程设计说明书

01

course-level-1/01-课程设计说明书.md

本文件是 Level 1 课程的设计总纲。改动课程结构(增删天、换产出、调门禁) 必须先改这里,再同步 02-逐日教学大纲 与 03-评估体系与通关门禁。


1. 课程定位

项 内容
课程名 小白 FDE 炼金术 · Level 1
副标题 一天入门,七天变现:快速融入工作与客户交付链路
一句话定位 用 8 天,把"会一点技术、没上过现场"的小白,炼成能独立跑通一条交付链路并留下作品集的准 FDE
时长 8 天,建议总投入约 22 小时(D1 全天 6h;D2–D8 每日约 2.25h = 直播 90min + 自练 45min)。逐日口径见 02
形式 线上直播训练营(默认)· 自学版 · 企业内训版,见 04-交付实施手册
平台层 fde-scope(本仓库)——主页/门户 + 自研 FDE 工具与流程平台(CLI + Web 控制台 + Python 库),零 API key 可全程跑通
知识底稿 00-FDE方法论历史与原理.md——历史 / 原理 / 方法论三合一;本说明书的所有结构决策都可在其中找到依据(对应关系见其 §4)
工具纪律 不要求换工具:学员/客户已有的主流产品(编码 Agent、办公 Agent)照常用,课程只叠"流程与门禁层",见 §6.4
命名解释 "炼金术"= FDE 的本质不是变魔术,是把客户现场散乱、脏、模糊的"矿石"(需求、数据、干系人)炼成可交付、可验证的"金属"(成功标准、语料、原型、交接包)

2. 目标学员画像

共同特征:能操作电脑、愿意敲命令行、想进入或刚进入 AI 交付现场,但没有完整的交付方法论。

Persona 现状 典型恐惧 课程给的解药
A. 新人(刚入职 / 即将入职 FDE、交付工程师) 有技术底子,没上过客户现场 "到了现场不知道先干什么,怕露怯" 给一张从进场到退场的完整路线图 + 每天可交付的产出
B. 转型者(测试 / 运维 / 前端 / 数据 / 后端) 会写代码、会部署,没做过"以客户价值为终点"的活 "我做的都是内部系统,客户要什么我不懂" 用 Zone A(定边界)与 Zone D(交接)补上"价值闭环"的缺口
C. 邻近岗(应届生 / 产品 / 售前 / 实施 / 咨询) 懂业务、懂沟通,技术不敢碰 "怕代码、怕数据、怕评估指标" 全链路提供可复制命令 + 白话解释,先"会用"再"会改"

先修门槛(刻意压低):

  • 必会:装软件、用浏览器、复制粘贴命令行、读懂表格
  • 不必会:Python 编程、Linux、SQL、机器学习(这些是 Level 2 的内容)

非目标(明确不做什么,防止期待错位):

  1. 不培养算法/建模专家——本课不训练模型、不调参
  2. 不培养架构师——不做大规模系统设计
  3. 不承诺就业与收入——"变现"指的是把能力转化为可展示、可验证、可复用的职业价值(详见 10-变现路径与结营包)
  4. 不做认证考试刷题班——评估全部基于真实产出

3. 学员的真实痛点 → 课程对策

# 痛点(现场高频原话) 根因 课程对策(对应 Day)
1 "客户说的需求每周都在变" 没在 Zone A 把成功标准契约化 Day 2:委托单 + 成功标准(≥2 位发起人)
2 "数据拿到了,是 3 个 Excel 和一堆缺失值" 假设客户数据已集中、已干净 Day 3–4:数据体检 → 语料锻造("先看再装")
3 "demo 演示的时候好好的,一上生产就崩" 用策展过的测试集原型,不是真实脏数据 Day 5:在真实未策展数据上做原型
4 "上线之后没人管,出了事才找我" 跳过 Zone C,没有 SLO / Runbook Day 6:SLO 卡 + Runbook + 值班交接卡
5 "项目结束我走了,客户说啥也没留下" 没有交接包与知识转移 Day 7:交接包 + 技能沉淀
6 "干了 3 个月,简历上写不出一行" 产出没有留痕、没有量化 全程:8 件产出 + Day 8 作品集装配

4. 学习目标(出口能力)

采用 K/S/A 三段式,括号内标注 Bloom 认知层级。

K · 知道(记忆 / 理解)——结课时能:

  • K1 用大白话向非技术朋友解释 FDE 是什么、和售前/实施/客户成功的区别(理解)
  • K2 画出并讲清 4 区 18 阶段的交付链路,说清每个区"离开时的证据"是什么(理解→应用)
  • K3 认出 ≥5 个 FDE 反模式(如 Sponsor Collapse、无限 Pilot、Demo 债),并说出一个规避动作(应用)

S · 会做(应用 / 分析 / 评价)——结课时能:

  • S1 独立跑通 connect → corpus → eval → handoff 全链路,并解释每一步为什么这么做(应用)
  • S2 把一句模糊的客户抱怨,拆成可度量的成功标准 + 干系人地图(分析)
  • S3 对一份陌生 CSV 做数据体检,说出"能用多少、缺什么、风险在哪"(分析)
  • S4 读懂评估报告,从 bad case 里挑出最该先修的 3 个(评价)
  • S5 用一页纸向老板/客户汇报:做了什么、证据是什么、下一步要什么(综合)

A · 心态(内化):

  • A1 先成功标准,后写代码/做原型
  • A2 一切产出要能被验证(有数据、有证据、有签字人)
  • A3 诚实报告:合成数据标注来源、未配好的工具如实说 unbound、做不到就说做不到

5. 设计原则(课程设计最佳实践落地)

# 原则 在本课的具体落地 依据
1 逆向设计:先定证据,再定教法 先定义 8 件产出(=03 的门禁检查对象)→ 再设计每天的教学活动 → 最后才选内容 Wiggins & McTighe, Understanding by Design
2 门禁制:进度由证据决定,不由时间决定 每天一道 gate(G1–G7),产出+证据齐了才解锁下一天;与 fde-scope 的 Engagement.advance() 同构 本仓库 docs/fde_sop_full.md("门禁是工程,不是清单")
3 认知负荷控制 每天最多 3 个新概念(rule of 3);Day 1 只装世界观+工具箱,不碰细节 Sweller, Cognitive Load Theory
4 体验学习循环 每日节奏固定为:演示(体验)→ 复盘(反思)→ 讲解(概念化)→ 作业(实践) Kolb, Experiential Learning
5 刻意练习 每一项产出都给出"失败样例 → 对照修改"的练习,学员练的是缺口,不是舒适区 Ericsson, Deliberate Practice
6 间隔重复 每天开场 10 分钟"回炉":抽考前一天的 3 个概念 + 1 个学员产出的错误案例 Ebbinghaus 遗忘曲线
7 社会学习 结伴打卡(buddy)、同伴互评(Peer Review)、优秀作品展、结营答辩 Bandura;同伴反馈的效应量证据
8 诚实边界 明确"不承诺就业/收入";所有案例标注虚构;AI 辅助需声明 与仓库 PRODUCT.md「不得虚构」约束一致

6. 课程架构:1 + 7 天模型

6.1 总览

第 1 天 · 入门日(Bootcamp)        第 2–8 天 · 变现周(Value Sprint,每天 1 关 1 产出)
├─ 世界观:FDE 与交付链路           ├─ D2 Zone A 定边界    → 客户委托单
├─ 三律:先标准 / 真实数据 / 可验证   ├─ D3 Zone B 接数据    → 数据体检报告
├─ 工具箱:fde-scope 冒烟          ├─ D4 Zone B 造语料    → 语料报告 + 话术
└─ 🎯 产出 1:迷你链路证据           ├─ D5 Zone B 验证评估  → 原型 + bad case
                                   ├─ D6 Zone C 运维化    → Runbook + SLO
                                   ├─ D7 Zone D 交接沉淀  → 交接包 + 技能卡
                                   └─ D8 变现日           → 作品集三套包装

6.2 与 fde-scope 4 区 18 阶段的对齐

课程不是简化到与真实 SOP 无关的玩具,而是把 18 阶段重新分组,保证学员结课后衔接 Level 2 时无缝。

课程天 fde-scope 区/阶段 课程化处理(小白版) 刻意省略(留给 Level 2)
D1 全链路导览 把 18 阶段讲成"交付地铁图"的 4 条线 各阶段细节、命令参数
D2 Zone A ①②③④ qualification / site_survey / stakeholder_map / success_criteria 合并为"定边界":客户是谁、谁拍板、怎么算成功 工业 gemba walk、FAT/SAT
D3 ⑤ connect 数据体检:schema、缺失、PII、分布 10 种连接器深入、OT 协议(OPC UA/MQTT)
D4 ⑥ corpus 清洗 → 质量门 → 覆盖度 → 补盲 → 报告 合成策略调参、质量模型
D5 ⑦⑧⑨⑩ prototype / validate / deploy / eval 合并为"证据冲刺":真实数据原型 + 评估 + bad case 多 Agent 装配、权限管线、生产部署
D6 ⑪⑫⑬ slo_sla / runbook / monitoring_drift 三张卡:SLO 卡、Runbook、值班交接卡 监控系统落地、漂移检测实现
D7 ⑭⑮⑯⑰⑱ change_mgmt / flywheel / ops_handoff / knowledge_transfer / disengage 交接包 + 技能沉淀 + 退场检查 产品化飞轮运营、劳资共决
D8 ——(课程特有) 变现日:作品集、简历、汇报、模拟面试 ——

工业增强(manufacturing profile 的 7 个专属门禁)在 Level 1 仅作 D1 的"世界观延伸"提及, 完整工业 overlay 属于 Level 2/3 内容。

世界观从哪来:本节的 4 区 18 阶段不是凭空划的,其历史由来、经济学原理与完整方法论 见 00-FDE方法论历史与原理.md §3(方法论)与 §2(原理)。 01 负责回答"课程怎么排",00 负责回答"为什么这么排"——两者是一对,改动其一须同步另一。

6.3 每天的标准时间盒(可复用模板)

时段 时长 内容 目的
开炉 10 min 回炉抽考:昨天 3 个概念 + 1 个典型错误 间隔重复
讲与演 25 min 讲师演示当天产出的完整做法(含"故意翻车"片段) 体验 + 概念化
上手 35 min 学员在自己的案例上动手做当天产出,助教巡场 刻意练习
复盘 10 min 展示 1 个优秀 + 1 个典型问题,讲评 社会学习
布置 10 min 当日门禁检查项 + 明日预告 门禁制

6.4 工具体系:平台层 + 你现有的工具(不要求换工具)

本课程的平台层只有一个工具(fde-scope),但不要求任何人放弃自己已经在用的产品。 这条不是客套——它是 FDE 现场能力的一部分,也是 D1 就要立的纪律。

fde-scope 的三重身份(先讲清,避免把"主页"当成"平台"):

身份 是什么 课程的哪里用到
主页 / 门户(对外的门) 中英双语落地页:讲清"是什么、给谁用、怎么收费、怎么联系"——客户与学员的第一入口 招生与开营前(04 / 08)
控制台(操作的台) fde-scope web:engagement 矩阵、门禁面板、报告——把状态机与门禁变成看得见的界面 D1 M5 起每天
自研 FDE 工具与流程平台(底座) 17 条命令的 CLI + Python 库;底座是 18 阶段状态机 与 10 个可执行门禁 D1 起每天——8 件产出全落在它的门禁上

三层分工(现场最重要的一张图):

层 干什么 谁提供 举例(仅作举例,非推荐、非背书)
编码 / Agent 开发层 写代码、改代码、搭 Agent 客户 / 学员自带 Qoder、Trae、CodeBuddy
办公 / 通用 Agent 层 写文档、做表格、跑多步自动化 客户 / 学员自带 豆包工作、千问办公、WorkBuddy、QoderWake
流程 / 门禁 / 留痕层 定阶段、卡门禁、落证据、沉淀技能卡 本课 / 本仓库(fde-scope) 18 阶段 + 10 门禁 + handoff 交接包

现场纪律(D1 立规矩):不要要求客户换工具。你的价值在流程与门禁层,不在编辑器。 客户已经买了什么、习惯用什么,是他们的既有投资与组织现实;FDE 进场是叠一层, 不是换一套——与本课批判的 Demo-Debt 同源:交付物是"可验证的流程与证据", 不是"你用了哪个工具"。

"允许客户用现有工具"不是口号——平台已经给出互通面(可演示给客户看):

  • 产物导出:fde-scope qwenpaw export;技能卡双格式导出 fde-scope skill export --format agentscope|qwenpaw
  • 知识互操作:fde-scope ontology(结构校验 + JSON-LD 导出,可喂给外部系统)
  • 数据侧 10 个连接器:csv · zammad · salesforce · mysql · documents;工业 5 种 opcua · mqtt_sparkplug · ros2_bag · mes · historian
  • 模型侧可选:可接 MiMo Token Plan 等;无 key 自动走规则路径,不被任何一家绑定
  • Agent 协议适配:ACP(delegate_external_agent)——运行时对接属 Level 2/3,Level 1 只讲到"有这个面"

⚠ 说法纪律(与 §9 诚实声明同源):上表产品名仅用于说明分工,不构成推荐或背书; 产品形态与归属变化极快,对外引用须标注查证时间——本表查证于 2026-09(来源:各产品官网)。 现场永远以"客户实际在用什么"为准——先问,再答。


7. 八件产出与作品集

# 产出 完成日 可对外展示形式
1 迷你链路证据(命令截图 + 一段白话解释) D1 学习日志
2 客户委托单(画像 / 干系人地图 / 成功标准) D2 工作汇报、需求文档范例
3 数据体检报告 D3 数据治理岗位作品
4 语料报告 + 客户话术 D4 交付物范例
5 原型 + 评估结果 + bad case 清单 D5 Demo 视频 + 指标页
6 Runbook + SLO 卡 + 值班交接卡 D6 运维/SRE 方向作品
7 交接包 + 技能沉淀卡 D7 项目管理与知识管理作品
8 作品集三套包装(求职 / 汇报 / 接单) D8 简历附件、面试材料

作品集分级(判定条件以 03 §6 为唯一口径):A 级 = 8 件齐全 + 平均分 ≥9/12 + 无未达项;B 级 = 8 件齐全 + 平均分 ≥7/12;C 级 = 缺 ≤2 件或平均分 <7/12。


8. 评估与通关(总览)

  • 诊断性:入学自评雷达(技术 / 业务 / 沟通 / 交付四维),用于分组与预期管理
  • 形成性:每日门禁 G1–G7 + 同伴互评 + 助教抽查
  • 终结性:结营答辩(10 分钟 / 人)+ 作品集评分 → 电子结业证书(A/B/C 级)
  • 补交机制(课程版 --force):每个门禁有 1 次 24h 内补交机会;逾期补交将标记"延期通过", 仍计入完课但作品集等级受限——强制放行仍然留痕,与仓库"即使例外也记录"的原则一致。

完整判定规则、评分量表见 03-评估体系与通关门禁.md。


9. 课程边界与诚实声明

  1. 不承诺就业与收入。课程交付的是能力与作品集;就业与涨薪取决于市场、岗位与个人面试表现。
  2. 案例全部虚构。茶语万象、迅捷出行、南湾汽车等客户名与数据均为演示用途,与任何真实公司无关。
  3. 薪资/岗位数量等市场数据(如"FDE 岗位同比增长")引用自公开资料,须标注来源与时间,不得当作承诺。
  4. AI 使用规则:鼓励用 AI 辅助(这就是 FDE 的日常),但每件产出必须: (a)能口头讲清关键决策;(b)标注 AI 参与的部分;(c)证据可复现。
  5. 不用真实客户数据练习。练习统一使用仓库自带虚构数据或学员自有的、已脱敏的数据。
  6. 工具名只作举例。课程提到的第三方产品(如 Qoder、Trae、CodeBuddy、豆包工作、千问办公、WorkBuddy、QoderWake) 仅用于说明工具分工(§6.4),不构成推荐或背书;引用须标注查证时间(当前查证:2026-09,来源为各产品官网)。

10. 后续课程前瞻

级别 主题 出口能力
Level 2 交付工程化:连接器深入、语料质量调优、多 Agent 装配、评估体系 能独立负责一个真实 engagement 的 Build 区
Level 3 工业与规模化:制造 overlay(FAT/SAT、功能安全、CE/EU-AI-Act)、飞轮产品化、团队与商业化 能带一支小 FDE 团队、跑通工业交付与合规链路

Level 1 的所有产出与术语,都直接复用于 Level 2 的入口检查(Level 2 入学要求: 提交 Level 1 作品集中的第 2、4、5 件产出)。

10.1 三级课程是一条"能力阶梯",不是三个独立产品

关系 说明
Level 1 定位 成品:8 天训练营,可独立招生、独立交付、独立结业(已完成设计,即本仓库 25 份文档:00 知识底稿 + 01–15 主线 + 16–23 逐节教案 + README)
Level 2 / 3 定位 规划中,尚未设计。本节只做前瞻与衔接承诺,不是交付承诺——刻意不写时间表,避免"PPT 课程"(本课 D5 批判的反面教材之一)
为什么现在就要写 ① 让学员知道"这 8 天不是终点";② 强制 Level 1 不把话说满——凡 Level 1 教不到的(连接器深入、多 Agent、工业 overlay),这里明确留给后续,而不是含糊承诺
对外的说法纪律 招生时只能说"Level 1 是完整的一门课,后续级别在规划中";不得用"完整体系 3 级"作为卖点抬价或暗示已交付(与 10 §8 查证纪律同源)
入口复用 Level 1 的 8 件产出 + 术语表(12 §1)即为 Level 2 的入学语言;Level 2 不重新发明词汇

02 · 逐日教学大纲(Day 1 – Day 8)

02

course-level-1/02-逐日教学大纲.md

本大纲是讲师与教研的执行清单。设计依据见 01-课程设计说明书.md, 历史 / 原理 / 方法论底稿见 00-FDE方法论历史与原理.md(讲师备课必读;学员课前读物), 评分标准见 03-评估体系与通关门禁.md, 讲师话术与卡点应对见 05-讲师手册.md。

命令说明:文中 fde-scope 命令以仓库根 README.md 的 CLI 参考为准; 版本升级后若有出入,以仓库为准并回改本文件(见 09 的期报复盘闭环)。


Day 1 · 入门日:装上世界观与工具箱

今日承诺:一天结束时,你能用自己的话讲清 FDE 交付链路,并亲手跑通第一条迷你链路。 时长:6 小时(上午 3h + 下午 3h),线上直播。 认知负荷红线:全天只允许出现 3 个新概念(交付链路 / 门禁 / 真实数据)。

历史(Palantir 2003-、招聘数据——引用必须带时点,口径见 00 §1.6)与原理(80/95/99、前线学习机制)不占这 3 个额度—— 它们是 00 的课前读物与讲师备课底料,不在直播里展开讲; 直播只保留 M1 的 45 分钟"讲故事"版本(见 00 §4 的对应关系表)。

课前预读(开营前 20–40 分钟):学员读 00 §1.0 + §1.1(30 秒速通版 + FDE 三位前身), 带一个问题进 D1:"FDE 和售前、实施、外包到底差在哪?"——M1 的第一个互动就从这个问题的举手回答开始。

时间盒

时段 模块 内容 产出
09:00–09:30 开营 学员自我介绍(30 秒/人:我是谁 + 我最怕现场哪件事);课程契约(D2–D8 每天约 2.25h、门禁制、诚实边界) ——
09:30–10:15 M1 世界观 FDE 是什么:Palantir 起源 → 2026 岗位爆发;FDE vs 售前/实施/客户成功(一句话对比);FDE 的 40/30/30 能力模型(讲师展开素材见 00 §1.1–§1.4、§3.6) 世界观笔记
10:15–10:30 休息 ——
10:30–11:30 M2 交付地铁图 4 区 18 阶段讲成"4 条地铁线";每站的"下车证据";门禁概念(为什么清单会烂、门禁不会);12 反模式里最常踩的 4 个 手绘/数字版地铁图
11:30–12:00 M3 三律 ①先成功标准后代码 ②在真实脏数据上原型 ③一切产出可验证 ——
13:30–14:30 M4 工具箱开箱 安装 + 冒烟:pip install -e ".[dev]" → fde-scope connect --type csv --source examples/quickstart_csv/sample_tickets.csv → fde-scope corpus --input … --out reports/corpus_report.html → 打开报告 冒烟证据
14:30–15:30 M5 看控制台 fde-scope web → 工作台 / engagement 矩阵 / gate 面板 / 引导模式;打开一个 mock engagement 看门禁拦截的红色 blocker 控制台截图
15:30–16:30 M6 迷你链路挑战 学员独立完整跑一遍 connect → corpus,并向同桌用 3 句话解释"我刚才干了什么、为什么" 🎯 产出 1
16:30–17:00 门禁 G1 + 答疑 对照 G1 检查表自评、提交;讲师预告 D2(明天你就是"进场第一天") 通过 G1

今日讲解要点(讲师提示)

  • 用类比,不用术语:18 阶段 = 地铁 4 条线;gate = 检票闸机(没票不放行);corpus = 淘米(去砂、去石、补水)。
  • 必须"故意翻车"一次:演示时故意跳过成功标准直接跑 corpus,然后让学员指出问题——先体验代价,再讲原则。
  • 降级路径:学员装不上环境时,立刻切到 11-工具与环境准备 的故障排查表,助教 1v1;实在不行用助教共享屏幕代跑,学员口头指挥。
  • M1 讲深讲浅的分寸:讲师手里的完整素材是 00 §1–§2(Palantir 与 Ontology、三道成本门槛、80/95/99、前线学习机制),但直播只讲到"故事层"——起源时间线、40/30/30、一句"FDE 是做 80%→99% 那一段的活"。学员追问时按 00 §5 的 8 条回应,不要当天展开 §2.6 与 §3.4(会挤爆 45 分钟)。

常见问题:

学员问 回答要点
我不会 Python 能学吗? 能。今天所有命令可复制;Level 2 才碰代码。
没有 API key 能跑吗? 能,全链路有零 key 路径(规则模式),LLM 是可选加速器不是门槛。
我一直在用 Qoder / Trae / CodeBuddy 写代码,要换工具吗? 不用换。课程只叠"流程与门禁层",编码/办公工具继续用你顺手的(01 §6.4)。
学完能进大厂做 FDE 吗? 本课给能力与作品集,不承诺结果;D8 会教你正确地把作品集用起来。
FDE 的历史和原理要背吗?还有那些数据? 不背。今天的 3 个新概念里没有它们。要用的场合只有两个:D8 模拟面试、到客户现场被追问——那时翻 00 §5 的 8 条问答即可。所有市场数字都标了来源与日期(00 §6),引用时必须连来源一起说,不确定的就说"待核实"。

通关门禁 G1:见 03 —— 提交"迷你链路证据"(命令 + 一段白话解释 + 一份 corpus 报告截图)。


Day 2 · Zone A 定边界:把模糊抱怨变成可交付的边界

今日承诺:拿到一句客户抱怨,产出"客户委托单":画像 + 干系人地图 + 可度量成功标准。 时长:直播 90 min + 自练 45 min。 今日 3 个概念:qualification(值不值得做)· 干系人地图(谁拍板谁买单谁用)· 成功标准(可度量 + 书面 done)。

时间盒(直播)

时段 内容
10 min 开炉回炉:抽考 D1 的 3 个概念 + 讲评 1 个错误案例
25 min 讲与演:以虚构客户「茶语万象」为例,现场把一句抱怨拆成委托单;演示 fde-scope engage init --customer "茶语万象" --profile ticket 与 fde-scope gate list
35 min 上手上:学员用 07 的客户剧本做自己的委托单(助教巡场)
10 min 复盘:展示 1 优 1 劣;重点讲"成功标准写成形容词"这个典型错误
10 min 布置 G2 + 明日预告

交付物要求(🎯 产出 2:客户委托单)

  1. 客户画像:行业、规模、谁付钱、当前怎么干活、痛在哪(≤1 页)
  2. 干系人地图:执行发起人 + 第二发起人(防 Sponsor Collapse)+ 一线使用者 + IT/安全把关人;标注每个人的"在乎什么"
  3. 成功标准:≥3 条,全部可度量(含数字与时间);附时间盒:≤14 天集成、≤90 天上线、≤120 天交接(引用自行业 FDE 实践)
  4. 放弃标准:什么情况下我们应该说"这个不该做"(拒绝商品化用例)

今日反模式警示:Sponsor Collapse(唯一发起人离职即死)、Infinite Pilots(没人定义 done)。

通关门禁 G2:成功标准 ≥3 条且全部可度量;干系人含 ≥2 位发起人;委托单 ≤1 页。


Day 3 · Zone B 接数据:先看再装

今日承诺:拿到一份陌生 CSV/数据源,产出"数据体检报告",说清能用多少、缺什么、风险在哪。 今日 3 个概念:schema 探测(字段/类型)· PII 红线(哪些字段碰不得)· 覆盖度(类别分布)。

时间盒(直播)

时段 内容
10 min 回炉:G2 优秀委托单讲评(1 优 1 劣)
25 min 讲与演:fde-scope connect --type csv --source examples/quickstart_csv/sample_tickets.csv → 读 schema 预览与样本;讲 PII 候选字段(schema 标 ⚠——注意它只按字段名判:name/email/phone 这类列名才亮,本例四列一个都不亮,但 content 文本值里就写着手机号和邮箱 → 不亮 ≠ 没有 PII,自由文本必须逐条看值);讲"类别极度不均衡"意味着什么(A/B 两组都用这个文件起步;工业补充数据见 examples/quickstart_manufacturing/)
35 min 上手:每个学员/小组对自己分到的数据源做体检(助教巡场)
10 min 复盘:快速互评(相邻两人交换体检报告,找对方漏掉的 1 个风险)
10 min 布置 G3 + 明日预告

交付物要求(🎯 产出 3:数据体检报告)

  • 数据源概况:条数、来源、采集方式、时间范围
  • 字段清单与质量:字段名 / 类型 / 缺失率 / 异常值 / 备注
  • PII 清单与处置建议:哪些字段必须脱敏、哪些根本别拿
  • 覆盖度观察:类别分布 Top/Bottom,是否存在长尾盲区
  • 风险与建议:一句话结论——"这份数据能支撑什么、不能支撑什么"

今日反模式警示:Data Quality Surprises(假设数据已集中、已干净)。

通关门禁 G3:报告含 PII 清单与 ≥3 条质量风险;给出"能不能做"的明确结论(不允许写"待定")。


Day 4 · Zone B 造语料:把矿石炼成金属

今日承诺:把脏数据锻造成一份可审计的语料报告,并能用客户听得懂的话讲清楚。 今日 3 个概念:质量门(什么样的样本不能进)· 去重与清洗 · 补盲合成(补缺口不是凑数量)。

时间盒(直播)

时段 内容
10 min 回炉:D3 典型体检报告讲评
25 min 讲与演:fde-scope corpus --input <数据> --out reports/corpus_report.html,逐段读报告:清洗后可用量、PII 脱敏数、覆盖盲区、合成补齐、train/eval/test 切分;(可选)--llm 合成路径与失败回退
35 min 上手:学员跑通 corpus 并解读报告;写"对客户怎么说"的话术
10 min 复盘:请学员用 3 句话向"客户"(助教扮演)汇报语料结果
10 min 布置 G4 + 明日预告

交付物要求(🎯 产出 4:语料报告 + 客户话术)

  • CorpusReport(HTML 或截图)+ 关键数字摘录:原始 N 条 → 可用 M 条(去重 X、质量门淘汰 Y)
  • 覆盖度分析:盲区 K 个及补盲策略
  • 客户话术(≤200 字):向非技术客户解释"你的数据能用多少、我们补了什么、为什么可信"——这一项是门禁硬指标
  • 诚实声明:合成数据比例与来源标注

今日反模式警示:数据"凑数"(用合成量掩盖真实缺口)、不报告合成比例。

通关门禁 G4:报告数字与实际运行一致;话术里无术语("语料/覆盖度"需替换成白话);合成比例如实标注。


Day 5 · Zone B 验证与评估:用证据说话

今日承诺:产出一个能演示的原型 + 一份评估结果 + 最该先修的 3 个 bad case。 今日 3 个概念:真实数据原型(不用策展测试集)· 评估指标(意图准确率/采纳率与业务口径)· bad case(改进抓手)。

时间盒(直播)

时段 内容
10 min 回炉:G4 话术讲评
25 min 讲与演:fde-scope eval --agent mock --test-set test_set.jsonl 读指标(测试集模板见 12 §2.4,先自己造 5 行再扩到 200);fde-scope kpi <你的档案id> --samples examples/quickstart_manufacturing/station_samples.jsonl 看场景 KPI;讲"demo 与生产的落差"为什么发生在这一步
35 min 上手:学员跑评估;从 bad case 里挑 3 个并写"根因假设 + 下一步动作"
10 min 复盘:干系人验证演练——助教扮演"持反对意见的业务主管",学员用数据回应
10 min 布置 G5 + 明日预告

交付物要求(🎯 产出 5:原型 + 评估 + bad case)

  • 原型证据:可运行命令与输出截图(或控制台 demo 录像 ≤2 min)
  • 评估结果:主指标 + 至少 1 个业务口径指标
  • bad case 清单:Top 3,每条含"现象 → 根因假设 → 下一步动作 → 预计改善"
  • 一页"验证记录":向谁演示了、对方提了什么、我们接受了/拒绝了什么(含理由)

今日反模式警示:Demo-Debt(演示里承诺平台做不到的事)、No HITL(假设全自动)。

通关门禁 G5:评估可复现(同命令同结果);bad case 每条都要有"下一步动作",不允许只描述现象。


Day 6 · Zone C 运维化:让东西稳得住

今日承诺:产出 Runbook + SLO 卡 + 值班交接卡——你走了,系统也能活。 今日 3 个概念:SLO 与错误预算 · Runbook(事件响应与回滚)· 漂移与监控(AI 会退化)。

时间盒(直播)

时段 内容
10 min 回炉:G5 bad case 讲评
25 min 讲与演:fde-scope gate check <你的档案id> 看 slo 门禁检查了什么(SLO/SLA + 错误预算 + 告警路由);演示 fde-scope handoff <你的档案id> 生成 runbook 草稿;讲"概率性退化"

<你的档案id> 用 COLUMNS=200 fde-scope engage list 查(不加 COLUMNS 会被截断成 eng-xxx-t…); 想先看别人家的成品,用 eng-southbay-manufacturing-seed03 等行业种子档案,见 12 §3.2。 | 35 min | 上手:学员为自己的场景写 SLO 卡与 Runbook(模板见 12) | | 10 min | 复盘:盲测——随机抽一份 Runbook,问"凌晨 2 点值班的人按这份文档,能不能处理完?" | | 10 min | 布置 G6 + 明日预告 |

交付物要求(🎯 产出 6:Runbook + SLO 卡 + 值班卡)

  • SLO 卡:3 条 SLO(含目标值与测量方式)、错误预算、告警路由(谁在什么渠道多久内响应)
  • Runbook:5 类常见事件(服务不可用 / 指标暴跌 / 数据异常 / 权限或配额 / 上游依赖挂)各自的:判断信号 → 处置步骤 → 回滚步骤 → 升级路径
  • 值班交接卡:交接要素(当前状态 / 待办 / 已知风险 / 联系人),适配多班次场景

今日反模式警示:Probabilistic Degradation(无飞轮,线上退化无人知)、Hero Engineer(只有你知道怎么修)。

通关门禁 G6:Runbook 含回滚步骤;SLO 卡有明确告警路由(缺路由只能算 warning,需补);用"凌晨 2 点盲测"通过同事检验。


Day 7 · Zone D 交接与沉淀:交得出去,带得走

今日承诺:产出完整交接包 + 把现场经验沉淀成可复用技能卡。 今日 3 个概念:交接包(交接的四件套)· 知识转移(教会 ≠ 讲完)· 退场(有始有终的时间盒)。

时间盒(直播)

时段 内容
10 min 回炉:G6 盲测结果讲评
25 min 讲与演:fde-scope handoff <你的档案id> --accept 装配交接包;fde-scope skill add --title "<标题>" --category methodology --body "<正文>" 沉淀技能卡,再 fde-scope skill publish <skill-id> 发布;讲"无限 Pilot"与"≤120 天交接"的行业时间盒
35 min 上手:学员装配自己的交接包(4 件套 + 培训材料题纲),写 1 张技能卡
10 min 复盘:交接签字演练(助教扮演客户运维负责人,提 3 个刁难问题)
10 min 布置 G7 + 明日预告(变现日预告:带齐 7 件产出)

交付物要求(🎯 产出 7:交接包 + 技能卡)

  • 交接包四件套:Runbook + 评估报告 + SLO 卡 + 培训材料(题纲即可)
  • 验收清单:客户签收项逐条列出(谁验收、验收标准、签字人)
  • 技能沉淀卡(1 张):本次最有复用价值的一条经验,格式:场景 → 问题 → 做法 → 证据 → 适用边界
  • 退场计划:交接后 30/60 天的支持安排与终止条件

今日反模式警示:Infinite Pilots(没有 done)、Consulting Trap(越做越像定制咨询,没人能接手)。

通关门禁 G7:交接包四件套齐全;技能卡含"适用边界"(防止经验被滥用);退场计划有明确终止条件。


Day 8 · 变现日:把 7 件产出换成职业资产

今日承诺:作品集三套包装完成;完成结营答辩;带走一份可以直接用的简历段落与面试题库。 今日 3 个概念:作品集(证据 > 描述)· 汇报公式(做了什么/证据/下一步要什么)· 变现三层(客户/雇主/个人)。

时间盒

时段 模块 内容
60 min M1 作品集装配 把 7 件产出包装成三套:求职版(简历段落 + STAR 故事 3 个)、内部汇报版(一页纸:价值/证据/下一步)、接单版(服务清单 + 案例页);模板见 10
60 min M2 结营答辩 每人 10 min:我为一个虚构客户做了什么 → 证据是什么 → 如果重来会改什么;(评分见 03)
45 min M3 模拟面试 讲师/助教按 10 的面试题库出题(含 FDE 高频追问:和传统实施的区别、没有外网怎么办、多租户怎么防泄露);每人至少被问 3 题。深水区追问的弹药在 00 §5(Echo vs Delta、80/95/99、三道成本门槛、为什么不用 LangGraph)——讲师出题时从这里挑 1–2 题加难度
30 min M4 结营仪式 表彰(最佳作品/最佳互助/最快进步);校友群与复训规则;7 日回访预告

交付物要求(🎯 产出 8:作品集三套包装)

  • 作品集索引页(一页):8 件产出的名称、日期、证据链接、一句话价值
  • 简历段落(3–5 行,使用 10 的句式模板,含数字)
  • 一页纸汇报(给老板/客户)
  • 面试自测清单:20 题中至少自测 10 题并写下答案要点

通关门禁 G8(结业门):G1–G7 中至少 6 关通过 + 作品集索引完整 + 完成结营答辩 → 电子结业证书(A/B/C 级判定见 03)。


附:全天候支持节奏(讲师/助教排班参考)

时间 动作 负责人
每日 09:30 发布当日任务卡与门禁检查项 运营
直播后 30 min 上传录播 + 讲义 + 命令清单 助教
19:00–20:00 集中答疑窗口(群内语音/直播) 助教轮值
21:30 催交 + 当日优秀作品提名 运营
次日 08:30 门禁通过榜更新 运营

03 · 评估体系与通关门禁

03

course-level-1/03-评估体系与通关门禁.md

课程信条:门禁是工程,不是清单。(源自仓库 docs/fde_sop_full.md) 清单记录"曾经为真"的事;门禁在你要通过的那一刻,重新验证它现在是否为真。


1. 为什么用"门禁"而不是"作业打卡"

打卡(清单思维) 门禁(工程思维)
判定依据 交没交 产出里的证据是否成立
时间点 填完那一刻最新鲜,之后腐烂 每次推进都重新验证
例外处理 补卡 = 和正常无异 补交/豁免留痕,作品集等级受限
学员获得的信号 "完成就好" "可验证才算数"

课程门禁与 fde-scope 的 Engagement.advance() 同构: 不达标不放行;即使放行(补交),也记录在案。

1.1 ⚠️ 别搞混:这里有两套门禁

学员最容易踩的认知坑:以为 fde-scope gate list 里印的那 10 个门禁就是本课程的门禁。 不是。它们是两套不同的东西,只是名字都叫"门禁"。

课程门禁 G0–G8(本文件 §3) 工具门禁 10 个(fde-scope gate list)
管什么 你在训练营里的进度:能不能进下一天 SOP 交付链路的进度:18 阶段里某个阶段能否推进
有几个 9 个(G0 入学 + G1–G8 每日) 10 个(🏢 通用 3 + 🏭 工业专属 7)
谁判定 讲师 / 助教(按 §4 评分量表) 程序(Engagement.advance() 实时重算)
在哪看 本文件 §3 的表 fde-scope gate list

工具那 10 个的具体名字(fde-scope gate list 就能看到):

  • 🏢 通用 3 个(ticket / manufacturing 都会走到):success_criteria · slo · handoff_signoff
  • 🏭 工业专属 7 个(只有 manufacturing 档案会走到):site_survey · fat_sat · functional_safety · conformity · works_council · air_gap · shift_handover

判断"我今天该过哪一关、该交什么"只认本文件 §3 的 G0–G8。

⚠️ 一个要命的坑:在 ticket 档案上手动跑 fde-scope gate check <id> --gate site_survey,你会看到 ✅ PASS。 那是"这个门在 ticket 档案下没有可检查的数据"的空过,不是你通过了工业门。 把它当证据写进作品集 = 拿一个空 ✅ 充数,助教一眼能看出来。 (ticket 档案根本走不到工业阶段,本课程也不考这 7 关。)


2. 三层评估

层 时点 工具 用途
诊断性 开营前 自评雷达(技术 / 业务 / 沟通 / 交付,1–5 分) 分组、结对、讲师调参
形成性 每天 G1–G7 门禁 + 同伴互评 + 助教抽查(30% 抽样) 即时纠偏、防止掉队
终结性 Day 8 结营答辩(10 min)+ 作品集评分 结业证书、优秀作品、表现信(非内推,见 §6)

权重:作品集 60% + 答辩 25% + 互助与出勤 15%。


3. 门禁总表(G0 – G8)

判定语义与仓库一致:blocker = 硬拦(必须补齐才放行); warning = 提醒(可放行但记入档案,且在作品集评分中扣分)。

门禁 挂在哪天 检查项(逐条验证,不只看"交了没") 判定
G0 入学门 开营前 ① 环境自检通过(Python 3.11+ / 终端可用 / 装包成功)② 学习契约已读(D1 全天 6h、D2–D8 每天约 2.25h、门禁制、诚实边界)③ 自评雷达已填(模板:12 §2.0) ① blocker;②③ warning
G1 冒烟门 D1 ① connect + corpus 命令跑通,报告文件真实存在 ② 能用白话解释"我刚才做了什么"(口头或 3 行文字)③ 报告中的关键数字与实际运行一致 ① ② blocker;③ warning
G2 边界门 D2 ① 成功标准 ≥3 条且全部可度量(有数字与时间,禁止"提升体验"类形容词)② 干系人含**≥2 位发起人** ③ 有"放弃标准" ④ 委托单 ≤1 页 ①② blocker;③④ warning(④ 超 2 页为 blocker)
G3 数据门 D3 ① 字段清单含类型/缺失率 ② PII 清单与处置建议 ③ 明确结论"能做 / 不能做 / 有条件能做" ④ ≥3 条质量风险 ①②③ blocker;④ warning
G4 语料门 D4 ① 报告数字与实际运行一致 ② 有覆盖盲区说明与补盲策略 ③ 客户话术 ≤200 字且零术语 ④ 合成数据比例如实标注 ①②③ blocker;④ warning
G5 证据门 D5 ① 评估可复现(同命令同结果)② bad case Top3 每条含"下一步动作" ③ 有一页"验证记录"(含被拒绝的需求) ①② blocker;③ warning
G6 稳运门 D6 ① Runbook 含 5 类事件且每类有回滚步骤 ② SLO 卡含错误预算 ③ 明确告警路由(谁/渠道/响应时限) ④ 通过"凌晨 2 点盲测"(同事按文档能处理) ①②④ blocker;③ warning
G7 交接门 D7 ① 交接包四件套齐全(Runbook/评估报告/SLO/培训材料) ② 验收清单含签字人 ③ 技能卡含"适用边界" ④ 退场计划有终止条件 ①② blocker;③④ warning
G8 结业门 D8 ① G1–G7 至少 6 关通过 ② 作品集索引完整(8 件) ③ 完成结营答辩 ④ 作品集等级判定完成 ① blocker;②③④ blocker

补交规则(课程版 --force)

  1. 每道未通过的门禁有 1 次 24 小时内的补交机会,补交通过后正常放行。
  2. 超过 24 小时补交:标记 "延期通过"——计入完课,但作品集等级最高只能到 B。
  3. 确实无法完成(如数据涉密、岗位冲突):走 "豁免" 流程,由讲师评估后记录在案, 空缺件以书面说明替代——豁免记录会出现在证书备注里,不混同于正常通过。

4. 评分量表(Rubric)

4.1 通用四维(每件产出都用)

维度 未达(0) 达标(1) 良好(2) 优秀(3)
证据链 只有描述,无证据 有截图/文件但不可复现 可复现(给出命令/路径) 可复现 + 第三方(同伴/助教)复核过
可度量性 全是形容词 部分指标有数字 关键结论均有数字与时间 有基线(before/after)对比
客户语言 满篇术语,客户看不懂 术语未解释 白话为主,术语有注解 可直接拿去对客汇报,零修改
诚实标注 发现夸大/隐瞒 不夸大、不隐瞒(底线,做到即得 1 分) 合成数据/假设有标注 主动写出"不确定项"与"已知局限"

单件得分 = 4 维之和(0–12)。诚实标注维度若判 0,该件直接退回重做(一票否决)。

4.2 关键产出的专项要点

产出 额外专项检查
委托单(D2) 成功标准是否"客户自己能验收"?(写成只有工程师能测的不算)
数据体检(D3) 结论是否敢下?("待定"= 未达)
语料报告(D4) 话术里是否出现"语料/覆盖度/合成"等术语?出现即未达
原型与评估(D5) 是否用了策展过的漂亮数据?用了即"Demo 债",退回
Runbook(D6) 盲测:同事能否在不问你的情况下处理?不能则未达
交接包(D7) 客户能否拿着它独立跑一周?不能则未达

5. 结营答辩(10 分钟/人)

环节 时长 要点
陈述 5 min 我为一个虚构客户做了什么(2 min)→ 证据是什么(2 min)→ 如果重来会改什么(1 min)
追问 4 min 评委(讲师 + 助教 + 1 名学员代表)从 10-变现路径与结营包 的面试题库随机抽取 ≥3 题;答得太顺时可加 1 题深水区题(00 §5 的 8 条追问,如 Echo/Delta、80/95/99)
打分 1 min 按下表记录

"应变"项的判分提醒:学员答不上"为什么是现在"这类原理题时,正确答案不是编一个数字—— 而是说"这个数字我记得大概范围,但来源和日期我需要回去核对(00 §6 有引用纪律)"。 诚实承认 + 知道去哪查,比背错年份得分更高——这与 D5 教的"不演 demo"是同一条原则。

答辩评分表(每项 0–5 分):

项 观察点
结构清晰 能否在 5 分钟内讲完,不超时、不跑题
证据意识 每个结论是否都有证据指向
复盘深度 "如果重来"是否具体、是否指向自己的决策而非外部借口
应变 面对反问是否诚实(不知道就说不知道 + 说出会怎么查)
客户视角 是否始终在讲"客户得到什么",而非"我用什么技术"

6. 作品集等级与证书

等级 判定条件 证书 附加权益
A 级 8 件齐全;平均分 ≥ 9/12;无未达项;无"延期通过" 电子证书 + A 级徽章 优秀作品展 + 讲师签名的表现信(对 8 件产出做事实陈述:写了什么、证据在哪、表现如何——不是内推,不承诺录用或面试机会,细则见 10 §9)+ 可申请助教
B 级 8 件齐全;平均分 ≥ 7/12 电子证书 复训旁听资格
C 级 缺 ≤2 件或平均分 < 7/12 完课证明(非证书) 免费重读下一期

证书备注栏如实记录:补交/延期/豁免项(与门禁"留痕"原则一致)。


7. 诚实与 AI 使用规则

  1. 鼓励用 AI 助手(这本身就是 FDE 的日常工作方式),但:
    • 每件产出必须能口头讲清关键决策(答辩会抽查);
    • 标注 AI 参与部分(在产出末尾写一句即可);
    • 证据必须可复现:AI 生成的数字/结论,必须自己跑过一遍。
  2. 禁止:代做(他人代交)、伪造证据(P 图、编造报告数字)、用真实客户敏感数据练习。
  3. 违规处理:首次判定为"退回重做 + 记录";二次则取消证书资格。
  4. 数据红线:练习统一使用仓库自带虚构数据(examples/)或学员自有且已脱敏的数据; PII 不上传、不进群、不进任何第三方工具(见 11-工具与环境准备 第 6 节)。

8. 数据留档与隐私

数据 用途 留存 访问
门禁通过记录 完课判定、期报复盘 2 年 运营 / 讲师
作品集 结业判定、优秀展(需学员授权) 学员自持;授权后展示 6 个月 学员 / 经授权
答辩记录 证书等级 2 年 讲师
自评雷达与问卷 课程改进 匿名化后长期 教研

默认规则:作品集属于学员;任何对外展示(优秀作品展、案例宣传)必须单独取得书面授权。

数据合规一票否决:使用真实客户名 / 真实 PII 练习(见 11 第 6 节红线), 一经发现——该件产出作废 + 取消证书资格 + 记录在案,且不适用补交。 这条与 §4.1 的"诚实标注判 0 即退回"是两条独立的一票否决,都不走申诉豁免。

04 · 交付实施手册

04

course-level-1/04-交付实施手册.md

本文件回答一个问题:这门课怎么开起来、怎么跑完、出事了怎么办。 讲师怎么带 → 05-讲师手册.md|运营怎么运转 → 08-运营手册.md


1. 四种交付形态

A. 线上直播训练营(默认产品) B. 自学版 C. 企业内训版 D. 影子项目(加档)
适合 个人报名、公开招生 时间碎片、自学能力强者 企业 FDE/交付团队批量培养 少数在营/结营学员,愿接受 ≤1:3 监护并走完准入四件套(14)
周期 8 天连续(含周末)或 2 周(隔天) 4 周自主节奏 3 天集中 + 1 周作业 排在 A 之后 4–8 周,按学员与客户窗口协商
直播 每天 90 min 无(录播切片) 每天 6h 驻场或半驻场 无固定直播;导师 1v1 / 小组复盘
助教配比 1 : 15–20 社群答疑(1 : 50) 1 : 10(内部导师兼任) 导师 ≤ 1 : 3(14 §3.8)
案例 虚构案例库(07) 同左 客户真实项目(脱敏) 优先 客户真实小场景(脱敏 + 双签,14 §3.4)
门禁执行 严格(每日 G1–G7) 自助打钩 + 社群互评 严格 + 内部考核挂钩 严格 + 客户侧准入闸门(缺一件不进)
结营 答辩 + 作品集评级 作品集自评 + 抽检 答辩 + 内部汇报演出 方法与骨架 +(可选)经双签的脱敏摘要
规模上限 按助教配比定,不设硬顶 无 单期 1 家 每期最多 3 人(14 §3.8)
定价档位(§1.2) L1 标准档 L0 免费公开版 / L1 标准档 L3 企业内训档 L2 影子项目档

选择建议:第一次开班一律用 A 形态(反馈闭环最快);企业客户 20 人以上直接用 C, 把 07 的虚构案例替换为客户自己的一个真实(脱敏)小场景。

D 形态不是默认产品,是 A 之后的加档,理由与执行顺序见 14 §3.1、§3.8: 它碰真实数据,所以按"先替代轨道 → 攒够 B 级学员 → 每期 ≤3 人"的节奏放量,不为了多收人而放宽准入。

1.1 定价与成本:只给算法,不给数字

⚠ 本手册不写"承诺价"。价格随城市、渠道、你的资历、当期人数剧烈变化, 写死一个数字只会误导。这里给你两样东西:算得清成本的公式(本节)+ 四档的公开定义与比价锚点(§1.2)。 数字你自己填,且对外报价前先算一遍。

第一步:先算"一期班要花多少钱"(成本六项,逐项填)

# 成本项 怎么估 一期(示例口径)
1 讲师课时 讲师日费率 × 授课天数(含备课/答疑的 1.5 倍系数) 占大头,通常 50%+
2 助教课时 助教时薪 × 天数 × 人数(配比见 §1 表) 按 1 : 15–20 配
3 平台与工具 直播平台 / 群工具 / 云盘 / 证书制作 通常很低,别忘域名/邮件
4 获客成本 投放费 ÷ 报名人数,或分佣比例 × 客单价 最容易被漏算
5 运营人力 班主任/教务的工时折算 涉及催交、答疑、复盘
6 风险金 意外赔付/免费复训/退款预留(建议预留 5–10%) 见 §7 预案

第二步:套公式

保本价 = 成本合计 ÷ 实收人数          ← 低于它办一期亏一期
建议定价 = 保本价 ÷ (1 − 目标毛利率)   ← 通常按 40–60% 毛利反推

第三步:三条纪律

  1. 先算再报:任何"随口报个价"都要在群里被追认为正式承诺——报价前必须过一遍上面的公式。
  2. 档位差异有依据:§1.2 的四档不是"贵贱之分",而是成本结构不同—— L0 免费档是边际成本为零的公开版(网页 + 仓库,不含直播/点评/证书)、 L1 标准档按人天成本定价、L2 影子项目档 = L1 + 导师 ≤1:3 的监护与脱敏人力(14 §3.8)、 L3 企业内训档按项目制报价(含脱敏、定制案例、内训考核对接的人力,通常单期价最高)。
  3. 不许拿"变现"当卖点抬价:招生口径受 08 §11 与 10 §8 约束—— 不得承诺就业/收入;提价只能提"服务密度"(助教配比、点评深度、案例定制),不能提"回报承诺"。

📌 企业客户(形态 C)报价还涉及发票与对公流程,见 08 §10 与 10 §6.1「合规六件套」第 2 条。

1.2 四档定价:一档真免费,三档公开算法

对症 13 §6 #6「价格不透明」:竞品有明码标价,我们只有算法, 在比价场景是实打实的劣势。补法不是随便标个数字,而是把能公开的全部公开—— L0 的价格(¥0)、四档的包含与不包含清单、每期招生页必须给出的三个数字,以及同行公开价锚点。

四档定义(价格怎么定写清楚;数字仍按 §1.1 公式逐期算)

档 对应形态 包含什么 不包含什么(必须写) 价格怎么定
L0 免费公开版 B 的公开子集 网页版全部课文(fde-scope web / 仓库 Markdown)+ 工具链 + 自学路径 直播、点名点评、答辩与评级、证书、答疑窗口 ¥0,永久免费;不设名额、不用报名
L1 标准档 A(含 B 的付费加强) 8 天直播 + 助教 1:15–20 + 每日门禁 + 答辩评级 + 结业证书 + 结营包(10 §9) 影子项目、客户真实场景、对公发票 保本价 ÷ (1 − 目标毛利率),按 §1.1 逐期算
L2 影子项目档 D L1 全部 + 真实小场景准入 + 导师 ≤1:3 监护 + 脱敏双签产出(14 §3) 承诺客户采纳、承诺就业/收入、下一期名额 L1 + 导师工时 + 合规与脱敏人力;一例一议
L3 企业内训档 C 3 天集中 + 1 周作业 + 客户脱敏场景 + 内训考核对接 + 对公发票(08 §10) 公开班名额、个人报名优惠 项目制报价:人天费率 × 人数 + 定制案例人时

同行公开价锚点(定位参考,不是"市场价";来源与查证日期见 13 §8)

同行 公开价 口径 对我们的含义
GSDC 认证 US$0–500 9 模块考试 · 5 年有效(官方站) 下界 $0 说明"零成本入门"已是行业既有选项——这正是 L0 存在的理由
ADaSci CFDE US$164.99 30 学时 · 7 模块 · 60 题监考 · 终身(官方站;源间冲突见 13 §4.2) 单张国际认证的价格带;与 L1 不是同一件商品,不做换算
职业培训机构长课(职坐标等) ¥5,000–29,000 4–5 个月,含就业服务(广告稿,不可作为唯一依据) 国内"长课 + 就业服务"那一档的价格带——我们不提供的那部分,价格也体现在这里
苏州瑞塔 ¥3,800–15,800 机构培训 + 工信部证书(媒体转述) 国内短训 + 部委证书的价格带
企业侧院校合办班 未公开 5 天集中(媒体转述,价格未取回) "企业档不公开价"是常态;但 L3 报价须对采购方逐项拆开(见下)

读表纪律(三条,缺一不可):

  1. 这是锚点,不是市场价。 13 §4.4 已经说过"'国内 FDE 培训多少钱'目前没有可靠答案"。 上表的唯一用途是让学员/采购方能自己把我们放进坐标里,不是用来说明"我们比谁便宜"。
  2. 不比总价,比包含什么。 学时不是可比单位(30 学时认证 vs 8 天训练营不是一件事), 题量、模块数同样不是。任何"我们用 X 学时顶他们 Y 学时""他们那个不值这个价"的说法都是违规话术(08 §2.1 禁用句清单)。
  3. 不换算不承诺。 不做"考完送 XX 认证""学完省下 XX 元"的等价话术;不引用第三方的成功率/涨薪率(15 §3 发布纪律)。

每期招生页必须给出三件事(这是"透明"的可检查定义,缺一项即不合规):

  1. 本档包含清单:直播天数、助教配比、门禁与证书,逐条列;不包含的也要写(如 L0 不含点评)。
  2. 本期班型与人数上限:上限由助教配比推出(08 §2.2)——写"最多 30 人",不写"名额有限"。
  3. 价格的构成口径:至少给"讲师日费率区间 + 助教配比 + 是否含证书制作与复训", 让采购方/学员能拿 §1.1 的公式自己验算一遍。

三条禁止:不做虚构划线价("原价 ¥X 现价 ¥Y");不做无依据的稀缺话术("最后 3 个名额"); 不拿"变现"当提价理由(§1.1 第三条纪律)。

📌 L0 为什么敢永久免费:课文与工具本来就在公开仓库,多一个人读的边际成本是 0。 免费档的存在不靠"以后会收费"的隐含承诺,所以它不需要任何倒计时或限额。


2. 排期模板

2.1 标准 8 天案(连续)

T-14  招生启动 ── T-7 报名截止 ── T-3 分班/建群 ── T-1 开营前任务(装环境)
D1 入门日(6h)  D2 定边界  D3 接数据  D4 造语料  D5 验证评估
D6 运维化      D7 交接沉淀  D8 变现日(答辩+结营)
D+7  回访(变现动作追踪)      D+30 期报复盘

2.2 企业内训 3 天压缩案

保留三根支柱,其余转自学作业(带门禁):

天 内容 转自学的内容
第 1 天 D1 入门(压缩到 3h)+ D2 定边界 D3 数据体检(作业 + 助教线上答疑)
第 2 天 D4 造语料 + D5 验证评估 D6 运维化(作业 + 盲测互评)
第 3 天 D7 交接沉淀 + D8 变现日(内部汇报演出) 作品集补全(一周内提交,内部评审)

2.3 自学版 4 周案

第 1 周 D1–D2|第 2 周 D3–D4|第 3 周 D5–D6|第 4 周 D7–D8 + 社群每周一次线上互评会。


3. 人员配置与职责

角色 配比 职责 关键动作
主讲讲师 1 教学、演示、答辩主评委、课程迭代 每期结束后 48h 内提交期报(09)
助教(TA) 每 15–20 人 1 名 巡场答疑、门禁初审、盲测陪练、"客户/刁难干系人"角色扮演 每日答疑窗口值班 1h;当日门禁通过名单 21:30 前交运营
运营/班主任 1 招生、社群、打卡、催交、激励、结营组织 见 08
课程研发 0.5 维护 01/02/03、处理反馈闭环 每 2 期做一次大纲修订

课堂角色扮演提示:D5 的"反对意见业务主管"与 D7 的"客户运维负责人"由助教扮演, 剧本见 07-实战剧本与案例库.md。

3.1 助教规模化:把"人力重"降成人时可算的数

对症 13 §6 #8「交付人力重」:试讲 ≥8/10 的讲师 + 1 : 15–20 的助教配比, 自助开班门槛不低。补法不是降配比(那是拿交付质量换便宜),而是把单项人时压到可复用。

三级助教阶梯(每一级都要有准入,不能凭"热心"上岗)

级别 准入 能做什么 不能做什么
影子助教 完成 L1 且评级 B 级以上 只观察 + 记录:把当日高频问题整理成 FAQ 草稿交运营 答疑定调、门禁初审、评分
值班助教 影子一期 + 任选一天试讲 ≥8/10(§7 第 1 条) 巡场答疑、门禁初审、盲测陪练、角色扮演(D5/D7) 改分、裁决申诉(08 §10 要求复核人未参与该次评分)
主答疑助教 完整带过 2 期 答疑定调、初审复核、编排互评、给新助教做影子带教 跳过任何门禁、放宽任何数据红线

四条"减人时不减标准"的手段

# 手段 怎么做 省的是哪一笔人时
1 FAQ 复利 同一问题第二次出现,就必须有一条现成答案进 08 §10;每期新增控制在 ≤20 条 重复答疑(占比最高的那一笔)
2 机器初审 + 人只看标红 能用工具判的门禁(命令是否跑通、产出文件是否齐全、命名是否规范)交给 fde-scope;助教只看工具标红与人判项(如"边界写清了吗") 机械核对
3 同伴层分担 结对 + 盲测互评(03)承担一部分"人盯人";助教从"逐人看"改为"看互评质量 + 抽查 20%" 逐人巡场
4 录播补课 缺课学员 24h 内补看并补交门禁;补课人时从"另约时间 1v1"变成"自助 + 抽查" 补课排期

四条硬底线(这四条永远不省)

  1. 配比不动:助教不足时砍招生人数,不砍助教——A 形态开班人数上限 = 助教数 × 20。
  2. 试讲门槛不动:新讲师 ≥8/10(§7 第 1 条),新助教先当一期影子。
  3. 门禁标准不动:机器只做初审,通过与否仍由人判定;03 §5 的十条门禁一条不减。
  4. 数据红线不动:真实客户名 / PII / 凭据仍然绝不出现在群聊、仓库、截图里。

一句话:这四条省的是重复劳动,不是判断。判断恰恰是学员付费买的东西。


4. 平台与工具链

用途 推荐形态 备注
直播 任意支持屏幕共享 + 分组讨论的会议工具 必须有分组(breakout)用于互评
社群 微信群 / 飞书群 / Slack 置顶:任务卡、答疑时段、规则(见 08)
打卡与作业收集 表单 / 群里接龙 / LMS 均可 统一命名规范:D2-姓名-委托单
代码与命令 学员本机 + 仓库 examples/ 无需服务器;零 API key 可跑
演示环境 讲师本机 + fde-scope web 提前 24h 冻结演示环境,禁止当天升级版本
录播与资料 云盘 / 知识库 直播后 30 min 内上传;仅限学员,不公开传播

5. 清单:课前 / 课中 / 课后

T-1(开营前一天)

  • ☐ 名单确认、分班(按自评雷达分组,强弱搭配结伴)
  • ☐ 群公告:学习契约、环境准备指引(11-工具与环境准备)、课前预读 00(20–40 分钟,见 06 §0.5)、开营时间
  • ☐ 讲师环境冻结:仓库版本、examples/ 数据、演示脚本试跑一遍
  • ☐ 助教就位:分工表、答疑排班、角色扮演剧本发放

D1 开营当天

  • ☐ 开营仪式(30 min):课程契约、门禁制说明、诚实边界声明
  • ☐ 环境救护站:助教开 1 个"急诊室"分组,专治装不上环境
  • ☐ 收齐:自评雷达、结伴名单
  • ☐ 点名收集课前预读的问题(06 §0.5 的"带一个问题进 D1")——M1 开场用它起手

每日(D1–D8)

  • ☐ 09:30 发任务卡 → 直播 → 30 min 内上传录播 → 答疑窗口 → 21:30 催交 → 次日 08:30 门禁榜

D+1 / D+7 / D+30

  • ☐ D+1:结营问卷(NPS + 最有价值的一天 + 最想砍掉的一天)
  • ☐ D+7:变现动作回访(更新简历 / 汇报 / 面试 / 复训报名)
  • ☐ D+30:期报复盘会(用 09 模板),改进项写回 02/05/08

6. 风险与应急预案

风险 触发信号 预案
学员环境装不上 开营 30 min 内 >20% 报错 切"主治医师"模式:助教 1v1;提供"影子环境"(助教共享屏幕代跑,学员口头指挥)
无 API key 导致以为不能学 群里反复问 明确:全链路零 key 路径可跑;LLM 只是可选加速(演示一次对比)
直播翻车(演示跑不通) 演示报错 把翻车变成教学:现场排查(这就是 FDE 日常),并在课后补一份正确记录
学员掉队 连续 2 天未打卡 三级干预(见 08 第 7 节)
学员用真实敏感数据 群内出现真实客户名/PII 立即提醒删除 + 私聊说明红线;产出退回替换为脱敏/虚构数据
讲师超时 单模块超时 10 min 助教举牌(约定暗号);超时即砍"彩蛋",保核心产出时间
答辩人数多排不下 >40 人 分组答辩(助教带组),讲师只进"优秀组"复核

7. 质量保障机制

  1. 试讲:新讲师必须完整试讲 D1 + 任选一天,由教研打分(≥ 8/10 才能带班)。
  2. 影子跟班:新助教先当一期"影子助教"(只观察 + 记录),再上岗。
  3. 录播双保险:直播 + 录播,缺课学员 24h 内补看并在群内补交门禁。
  4. 反馈采集:每日 1 题快评("今天最有用的 1 句话是什么")+ 结营 NPS。
  5. 迭代闭环:期报中的每个"改进项"必须在下期开营前落实或明确否决——闭环记录在 09。

8. 交付验收(给课程负责人的 checklist)

一期训练营"交付合格"的定义:

  • ☐ 完课率 ≥ 70%(完成 G1–G7 中 ≥6 关)
  • ☐ 作品集完整率 ≥ 60%(8 件齐全)
  • ☐ NPS ≥ 40
  • ☐ 期报已产出,且改进项已闭环到下期
  • ☐ 零数据合规事故(无真实敏感数据流出)

05 · 讲师手册(Facilitator Guide)

05

course-level-1/05-讲师手册.md

面向主讲讲师与助教。目标:让任何合格的 FDE 从业者,按本手册都能带出合格的课。 依赖:02-逐日教学大纲.md(教什么)· 07-实战剧本与案例库.md(用什么演) 备课底料:00-FDE方法论历史与原理.md(历史 / 原理 / 方法论 + §5 常见追问 8 条——学员问到"为什么"时的弹药库)


1. 讲师画像与备课清单

能力要求:做过至少 1 个完整交付项目;会用 fde-scope 全链路;能接受"小白式提问"不烦躁。

备课量:首期 ≈ 每天 4 小时(含试跑);成熟期 ≈ 每天 1 小时(过脚本 + 检查环境)。

  • ☐ 通读 01/02/03,理解门禁判定的每一句话(学员会挑战你)
  • ☐ 通读 00 §1–§3(历史 / 原理 / 方法论):直播不展开讲,但学员的"为什么"要能一句话答上;§5 的 8 条追问先自己答一遍
  • ☐ 在干净环境完整跑一遍 D1 冒烟链路(11 第 2–3 节)
  • ☐ 通读 07 的三份案例剧本,选定本期使用的客户案例
  • ☐ 准备"故意翻车"脚本(D1 必演,见第 3 节)
  • ☐ 准备 3 个自己的现场故事(真实、脱敏、有代价):一个成功、一个失败、一个"当时不懂后来才懂"

铁律:讲师讲的每个故事必须真实且脱敏;宁可少讲,不可编造。这与课程"诚实标注"原则一致。 同理,引用 00 里的市场/薪资数字时必须连来源与日期一起讲;两来源冲突的(如 OpenAI Deployment Company 的成立时间)就照 00 §1.6 说"两种说法,我们讲 2025–2026 年间",不要挑一个顺口的当定论。


2. 每场直播的标准骨架

环节 时长 讲师动作要诀
开场公式 3 min ①昨天最高分产出点名(10s)②今天一句话目标(10s)③"学完你能拿走什么"(10s)④今天的最小挑战(20s)
回炉 10 min 只抽 3 个概念 + 1 个错误案例;抽人不抽"积极分子"(点名靠后的学员)
讲与演 25 min 演示 > 讲解;每 7 分钟一次互动(投票/提问/群里打 1)
上手 35 min 讲师闭嘴巡场;助教主攻;只答"卡住超过 3 分钟"的问题
复盘 10 min 1 优 1 劣,优的要讲"为什么好",劣的要讲"我也犯过"
布置 10 min 只念门禁检查项,不念说明书——让学员去读 06

3. D1 演示脚本(含"故意翻车")

场景:用虚构客户「茶语万象」的工单数据演示。全程投屏,命令逐条敲(不要复制粘贴大段)。

M1 世界观段(09:30–10:15)的讲法:先收学员课前预读的问题("FDE 和售前/实施/外包差在哪?"), 用 00 §1.1 的类比速答(售前=试驾员 / 实施=装车工 / 外包=代驾 / FDE=随队工程师); 时间线只讲三个锚点(2003 Palantir → 2023 LLM → 2024–2026 岗位爆发),不要展开 §2 的原理—— 那 45 分钟的 KPI 是让学员记住"FDE 是做 80%→99% 那一段的活"这一句话。

# 第 1 步:先看数据长什么样(look before you load)——建立"先看再装"的职业习惯
fde-scope connect --type csv --source examples/quickstart_csv/sample_tickets.csv

# 第 2 步:锻造语料——讲"淘米"类比:去砂(去重)、去石(质量门)、补水(补盲)
fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --out reports/corpus_report.html

# 第 3 步:打开报告——逐段读关键数字,示范"对客户怎么说"
open reports/corpus_report.html      # macOS;Windows 用 start,Linux 用 xdg-open
# 学员更推荐:直接在文件管理器里双击 reports/corpus_report.html

# 第 4 步:打开控制台——让学员看到 18 阶段与门禁面板的红色 blocker
fde-scope web     # → http://127.0.0.1:8080
# 这一步不用敲 open:把终端里打印的 http://127.0.0.1:8080 地址复制到浏览器即可

翻车脚本(必演):演示前故意先跑 corpus 再"想不起来"要定成功标准,问学员: "我刚才跳过了哪一站?跳过它的代价是什么?" → 引出 D2 的委托单。用"代价的体验"替代"原则的说教"。

控时提示:D1 是 6 小时长直播,必须在 10:15、14:30 设两个硬性休息; 第 3 段(工具箱)不能晚于 14:30 开始,否则装环境的学员会拖到晚上。


4. D2–D8 每日带教要点(每节 ≤5 条)

D2 定边界

  1. 收作业时先问:"你的成功标准,客户能自己验收吗?"——验收主体搞错是最高频错误。
  2. 干系人地图必须逼出"第二发起人",没有就让他写"死亡风险"三个字在图上。
  3. 现场把一句形容词成功标准("提升效率")改造成可度量版本,示范一次胜过讲十次。
  4. 提醒:Zones A 的目标不是写方案,是定义 done。
  5. 预告 D3 时埋钩子:"明天你会看到号称最干净的数据长什么样。"

D3 接数据

  1. 让学员先猜"这份数据有几成能用",再跑命令对照——制造认知冲突。
  2. PII 环节用提问推进:"如果这列身份证泄了,谁担责?"
  3. 强制结论:"待定"不允许,逼学员做判断并写出条件。
  4. 用仓库里 mock engagement「南湾汽车」的"门禁被真实拦截"案例展示数据问题的后果。
  5. 提醒不要真拿客户数据:红线再讲一遍(11 第 6 节)。

D4 造语料

  1. 核心一句:"合成是补盲区,不是凑数量。" 每一条合成样本都要有缺口理由。
  2. 演示 --llm 与规则路径的差异(有 key 时),并演示失败自动回退——让学员看到"没有 key 也能活"。
  3. 话术环节做角色扮演:助教扮演客户老板,听学员用 ≤200 字白话解释。
  4. 诚实标注合成比例,当场制造一个"如果客户问合成比例是多少"的追问。
  5. 预告:"明天的坏消息是,指标一定不好看——这正是它的价值。"

D5 验证与评估

  1. 先给学员打预防针:第一次评估指标难看是正常的,指标是地图不是成绩单。
  2. 强调 bad case > 平均分:把"最该先修的 3 个"讲成"烧钱最快修的 3 个"。
  3. 角色扮演高潮:助教演反对的业务主管,学员必须用数据回应(不能讲情怀)。
  4. 要求记录"被拒绝的需求"——这是防 Scope Creep 的证据。
  5. 预告:"明天开始,你要为凌晨 2 点值班的人写文档。"

D6 运维化

  1. 开场问:"你走了以后,谁修?" 让沉默 10 秒再继续。
  2. 讲 SLO 时用外卖超时赔付类比(错误预算 = 赔付额度)。
  3. Runbook 环节做"凌晨 2 点盲测":随机抽一份,让别人按文档念,发现断点当场标注。
  4. 提"概率性退化":AI 不是坏了才叫坏,慢慢变差也是坏。
  5. 预告:"明天你要把手里的东西交给一个不爱你的人。"

D7 交接与沉淀

  1. 核心心态:"交接不是走过场,是你专业度的最后一道签名。"
  2. 技能卡必须有"适用边界"——强迫学员写出"什么情况下这条经验不适用"。
  3. 角色扮演:客户运维负责人提三个刁难问题(剧本见 07)。
  4. 讲"无限 Pilot"是行业最贵的反模式:没有 done,就没有价值结算。
  5. 预告 D8:"明天带齐 7 件产出——空手的,作品集直接判 C。"

D8 变现日

  1. 作品集装配时反复强调:证据 > 描述;把"我做了"改成"数据显示"。
  2. 模拟面试优先问 10 的 20 题里学员最虚的:没有外网/客户数据差/多租户防泄露。
  3. 答辩控时严格(10 min),超时打断——这就是交付现场的纪律。
  4. 结营仪式必须点名每一位完成者(哪怕 30 秒),掉队者私聊而非公开处刑。
  5. 最后布置一个"课后动作":72 小时内完成一次对真人的作品集讲解(同事/朋友都行)。

5. 提问库(苏格拉底式,随机抽用)

场景 问题
讲成功标准 "这句话,客户用什么数字来验收?"
讲干系人 "如果这位发起人明天离职,项目还活着吗?"
讲数据 "这份数据的哪个字段一旦泄露,你要负法律责任?"
讲语料 "你怎么向客户证明,补的这些样本不是编的?"
讲评估 "指标 91% 很好看——它回答的是客户的哪个问题?"
讲 bad case "如果只能修一个,你选哪个?为什么是它?"
讲 SLO "凌晨 3 点报警,谁来处理?他看哪份文档?"
讲交接 "客户拿到你的交接包,不给你打电话能活几天?"
讲变现 "你的产出里,哪一件能直接放进简历?证据在哪?"

6. 卡点解药表(学员原话 → 应对)

学员原话 背后情绪 讲师应对
"我不会写代码,是不是学不了?" 畏难 "今天所有操作都是可复制的命令——你的任务是看懂每一步在干什么;代码是 Level 2。"
"我们公司没有这样的客户,学这个有什么用?" 迁移焦虑 现场把他的日常工作映射到 4 区:"你现在做的 X 属于 Zone B 的哪一站?缺的是哪一站?"
"客户根本不给我数据" 真实困境 "这正是 Zone A 的存在意义:先拿到成功标准和干系人,数据是第 5 站的事。说说你卡在哪一位干系人?"
"我的指标很差,是不是做错了?" 挫败 "指标差是信息,不是判决。把它翻译成一个 bad case 加一个下一步动作。"
"Agent 这么强,FDE 会不会被取代?" 职业焦虑 "工具越强,'定边界 + 交接'越值钱。课程前两站和最后两站全部是跟人打交道——这正是训练重点。"
"能不能给个模板我直接填?" 求效率 给模板(12),但追加一问:"这个模板的第 2 条为什么这么写?"确保理解而非套壳。
"我全用 AI 生成的行不行?" 试探边界 "行。答辩我会请你脱稿讲 3 分钟,讲不清的判定为未达——这是课程唯一的'防伪'。"
"没时间打卡" 掉队前兆 启动三级干预(08 第 7 节);先给最小可交付版本(Mini 版产出),保住连续性。

7. 金句与类比库

概念 类比 / 金句
18 阶段 "交付不是百米冲刺,是换乘 4 条线的地铁——每站都要验票。"
门禁 "清单会烂,门禁不会。"
语料工程 "淘米:去砂、去石,补水——补的是缺口,不是把米堆高。"
成功标准 "客户验收不了的成功,不叫成功标准,叫许愿。"
真实数据原型 "在样板间练出来的手艺,撑不过毛坯房。"
bad case "平均分是安慰剂,坏例子是处方。"
Runbook "凌晨 2 点没人爱你,除了你的文档。"
交接 "交接是你留在现场的最后一次签名。"
变现 "作品集不是日记,是证据袋。"

8. 控场技巧

状况 处理
冷场(没人答) 换选择题:"A 还是 B?群里打字母";先点已经举手的人,再引第二个
超时 助教举牌暗号(黄牌=剩 5 分钟,红牌=立即收尾);被砍的彩蛋课后录 3 分钟短视频补给
跑题 "这是个好问题,我先记在'停车场'里,答疑窗口第一个讲"(准备白板/文档记 Parking Lot)
专业抬杠 承认合理部分 + 转成练习:"这个反例很好,D7 的盲测环节请你来当客户运维负责人。"
学员当众贬低课程 不辩论;私聊了解真实诉求;若是共性,写入期报改进项
有人全程开摄像头吃饭/摸鱼 运营侧处理(私聊),讲师不点名

9. 每期讲师复盘模板(48h 内提交)

## 期次 / 日期 / 讲师 / 助教 / 人数

### 1. 数据
- 完课率 / 作品集完整率 / NPS / 每日门禁通过率(附 `09` 看板截图)

### 2. 三个最好用的(保留)
- (例:D3 "先猜后看"制造认知冲突 → 数据理解正确率明显提升)

### 3. 三个最卡的(改进)
- 卡点描述 + 原因假设 + 下期改法(写回 02/05/08 的具体条目)

### 4. 本期学员提出的新问题(进题库/题库淘汰)
- 

### 5. 下期开营前必须落地的 3 件事(含负责人与截止日)
- 

06 · 学员手册与作业包

06

course-level-1/06-学员手册与作业包.md

写给学员:8 天里你只需要盯住这一份文档。 每天一张任务卡:做什么 → 交什么 → 门禁自查 → 卡住找谁。

判分依据见 03-评估体系与通关门禁.md|装环境见 11-工具与环境准备.md|全部模板见 12-附录-术语表与模板库.md 课前读物见 00-FDE方法论历史与原理.md(开营前 20–40 分钟,见 §0.5)


0. 先读这 5 句

  1. 第 1 天全天 6 小时,第 2–8 天每天约 2.25 小时(90 分钟直播 + 45 分钟自练),合计约 22 小时。排不进去就别报——这门课不靠"抽空看看"过关。
  2. 每天交一件产出,产出里必须有证据(命令、文件、截图)——没有证据 = 没交。
  3. 门禁制:当天的产出不过关,就暂时进不了下一关;补交可以,但留痕(作品集等级受限)。
  4. 练习只用虚构数据(课程自带)或你自己已脱敏的数据;永远不上传真实客户 PII。
  5. 鼓励用 AI 助手——但你得能脱稿讲清自己的关键决策(答辩会抽查)。

0.5 开营前 20–40 分钟:世界观预读(不考核,但很值)

不看也能跟上 D1——只是会在"为什么 FDE 是这样"的地方卡一下。

读 00-FDE方法论历史与原理.md,按你的时间二选一:

你有多少时间 读哪几节 读完你应该能回答
20 分钟(够用) §0 怎么用这份文档 → §1.0 三十秒速通版 → §1.1 FDE 三位前身 "FDE 和售前 / 实施 / 外包差在哪?"
40 分钟(推荐) 上面 + §2.1 范式转移 → §2.4 80/95/99 → §3.1 4 区 18 阶段 上面 + "为什么客户愿意为 FDE 付钱?"

带一个问题进 D1(M1 开场会点名回答):"我们公司现在是谁在干 FDE 的活?他缺哪一块?"

其余章节(§1.3 Ontology、§2.6 前线学习机制、§3.4 十二反模式、§5 常见追问)不用提前看—— 它们是 D8 模拟面试和日后客户现场的速查页。别在开营前背数字(00 §6 有引用纪律)。


1. 学习契约(开营日勾选)

开营 30 分钟内读完并在群里回复"已签署"。

  • ☐ 我承诺每天投入 2 小时,连续 8 天;若缺课,24 小时内补看录播并补交当天门禁。
  • ☐ 我承诺每件产出都诚实标注:合成数据比例、AI 参与部分、不确定项。
  • ☐ 我承诺不自造数字、不 P 图、不让他人代交。
  • ☐ 我承诺练习数据用仓库自带虚构数据或已脱敏数据,真实客户名与 PII 不进群、不上传。
  • ☐ 我接受门禁制与补交规则(24h 内补交 = 正常放行;超 24h = "延期通过",作品集最高 B;特殊豁免记录在证书备注)。

2. 开营前 15 分钟:环境自检(G0 入学门)

完整指引与故障排查见 11-工具与环境准备.md 第 2–3 节。

# 检查项 命令 期望结果 不通过怎么办
1 Python ≥ 3.11 python3 --version 显示 3.11 或更高 按 11 第 2 节重装
2 装包成功 pip install -e ".[dev]" 无报错,末尾 Successfully installed 报错截图发群,@助教
3 冒烟:看数据 fde-scope connect --type csv --source examples/quickstart_csv/sample_tickets.csv 输出票数 / 类别 / 渠道 + 样本预览 同上
4 冒烟:造语料 fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --out reports/corpus_report.html 生成 reports/corpus_report.html 同上
5 学习契约已读 + 自评雷达已填 模板 12 §2.0(手写即可,无命令) 四维分数 + 三句实话 + 契约 4 项全部勾选 缺雷达 → 补填后发群 @助教(拖延不影响开营)

不需要:API key、Docker、AgentScope——全链路有零 key 路径,装包即可跑。


3. 每日任务卡怎么用

每张卡四件事:今日产出 → 完成步骤 → 门禁自查 → 提交。 建议开播前 5 分钟把当天卡打开;直播"布置"环节只念门禁检查项,细则以本卡为准。

提交截止:直播次日 21:30(运营催交时间);次日 08:30 出"门禁通过榜"。 命名规范(统一,缺一律打回):D<N>-姓名-产出名,如 D2-张三-委托单; 同一产出多文件时加后缀:D2-张三-委托单-干系人图.png。


4. 每日任务卡

Day 1 · 入门日

今日产出(🎯 产出 1):迷你链路证据包

  • ☐ 课前:按 §0.5 读 00 的 20 分钟版,带一个问题进直播
  • ☐ 跑通(逐条复制,必须在仓库根目录、已激活虚拟环境): fde-scope connect --type csv --source examples/quickstart_csv/sample_tickets.csv fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --out reports/corpus_report.html
  • ☐ 提交 reports/corpus_report.html(在文件管理器里双击它即自动用浏览器打开; 提交文件本身或报告首页截图均可。打不开先查 11 §3.2)
  • ☐ 写 3 行白话解释:"我刚才做了什么、为什么要先看数据、报告里最重要的数字是哪个"
  • ☐ 先种案例数据:python examples/seed_mock_engagements.py(幂等,重复跑安全) 再 fde-scope web → 打开「星澜科技(Adnova)」→ 存好红色 blocker 那页的截图 (空仓库的控制台只有"创建一个 engagement"的提示,没有 blocker——所以这一步不能跳)

门禁自查 G1:命令真跑过(报告文件真实存在)|能用自己的话解释|报告数字与实际一致。 常见坑:命令跑在错误目录(应在仓库根目录)|报告路径看错(在 reports/ 下)。 卡住:先查 11 第 3 节排查表 → 再群内提问(用第 7 节的四要素模板)。

今天不需要背 00 里的任何年份与数字——那是速查页,不是考点。


Day 2 · 定边界

今日产出(🎯 产出 2):客户委托单(≤1 页)

  • ☐ 客户画像:行业、规模、谁付钱、现在怎么干活、痛在哪
  • ☐ 干系人地图:≥2 位发起人 + 一线使用者 + IT/安全把关人,标注每人"在乎什么"
  • ☐ 成功标准 ≥3 条:全部可度量(有数字 + 时间),客户自己能验收
  • ☐ 时间盒:≤14 天集成 / ≤90 天上线 / ≤120 天交接
  • ☐ 放弃标准:什么情况下该说"这个不该做"
  • ☐ 用 07 的客户简报,或替换成你自己的(脱敏)场景

门禁自查 G2:成功标准 ≥3 条全可度量(禁"提升体验"类形容词)|≥2 位发起人|有放弃标准|≤1 页(超 2 页直接打回)。 常见坑:成功标准写得只有工程师能测(验收主体必须是客户)|发起人只有一位(想想"他明天离职项目还活着吗")。


Day 3 · 接数据

今日产出(🎯 产出 3):数据体检报告

  • ☐ 先猜后看:写下"我猜这份数据有几成能用",再跑 fde-scope connect --type csv --source examples/quickstart_csv/sample_tickets.csv 对照 (A/B 两组共用此文件起步;工业补充数据见 examples/quickstart_manufacturing/)
  • ☐ 概况:条数、来源、采集方式、时间范围
  • ☐ 字段表:字段名 / 类型 / 缺失率 / 异常值 / 备注
  • ☐ PII 清单:哪些必须脱敏、哪些根本别拿
  • ☐ 覆盖度:类别分布 Top/Bottom,指认长尾盲区
  • ☐ 结论一句话:能做 / 不能做 / 有条件能做(写"待定" = 未达)

门禁自查 G3:字段表含类型与缺失率|PII 清单带处置建议|明确结论|≥3 条质量风险。 常见坑:只列字段不判风险|结论不敢下(犹豫就写条件:"若能补齐 X 字段则能做")。


Day 4 · 造语料

今日产出(🎯 产出 4):语料报告 + 客户话术

  • ☐ 跑 corpus 生成报告;摘录关键数字:原始 N → 可用 M(去重 X、质量门淘汰 Y)
  • ☐ 覆盖度:盲区几个、补盲策略是什么(每条合成样本有缺口理由)
  • ☐ 写客户话术 ≤200 字:向非技术客户说明"能用多少 / 补了什么 / 为什么可信"
  • ☐ 诚实标注:合成数据比例与来源(synthesize:llm 或规则路径)
  • ☐ (可选)有 key 时对比 --llm 路径与规则路径

门禁自查 G4:报告数字与实际运行一致|有盲区与补盲说明|话术零术语(出现"语料/覆盖度/合成"即未达)|合成比例如实标注。 常见坑:用合成量掩盖真实缺口|话术里冒术语(想想怎么跟老板讲"淘米")。


Day 5 · 验证与评估

今日产出(🎯 产出 5):原型证据 + 评估结果 + Top3 bad case + 一页验证记录

  • ☐ 先造测试集:把 12 §2.4 的模板复制成 test_set.jsonl(一行一条 JSON; 不会存文件?看 §2.4 的"零基础三步"框),先填 5 行跑通再扩到 ≥200 条; 首次 --agent mock 跑通时先删掉每行的 expected_category (否则 intent_accuracy 恒为 0.000——这是子串判分的设计,不是 bug,原因见 12 §2.4)
  • ☐ 跑 fde-scope eval --agent mock --test-set test_set.jsonl,截取主指标 + 1 个业务口径指标
  • ☐ 准备一个可演示的原型(命令输出截图,或 fde-scope web demo 录像 ≤2 min)
  • ☐ 从 bad case 里挑 Top3:每条写"现象 → 根因假设 → 下一步动作 → 预计改善"
  • ☐ 一页验证记录:向谁演示了、对方提了什么、接受/拒绝了什么(拒绝的要写理由)

门禁自查 G5:同命令同结果可复现|bad case 每条有"下一步动作"(只描述现象 = 未达)|有验证记录(含被拒绝需求)。 常见坑:用策展过的漂亮数据(= Demo 债,直接退回)|只贴平均分不挖坏例子。


Day 6 · 运维化

今日产出(🎯 产出 6):SLO 卡 + Runbook + 值班交接卡

  • ☐ SLO 卡:3 条 SLO(目标值 + 测量方式)+ 错误预算 + 告警路由(谁/渠道/多久响应)
  • ☐ Runbook:5 类事件(服务不可用 / 指标暴跌 / 数据异常 / 权限配额 / 上游依赖挂),每类四段:判断信号 → 处置步骤 → 回滚步骤 → 升级路径
  • ☐ 值班交接卡:当前状态 / 待办 / 已知风险 / 联系人
  • ☐ 自查门禁:fde-scope gate check <你的档案id> 看 slo 关到底在检查什么 (id 用 COLUMNS=200 fde-scope engage list 查;不加 COLUMNS 会被截断成 eng-xxx-t…)
  • ☐ 找一位同学做"凌晨 2 点盲测":他按你的文档念,能处理完才算过

门禁自查 G6:Runbook 每类事件有回滚步骤|SLO 含错误预算|告警路由明确|盲测通过。 常见坑:写成了"说明书"不是"操作步骤"(每步都得能照着敲)|忘了写回滚。


Day 7 · 交接与沉淀

今日产出(🎯 产出 7):交接包四件套 + 技能卡 + 退场计划

  • ☐ 装配交接包:fde-scope handoff <你的档案id> --accept
  • ☐ 交接包内容:Runbook + 评估报告 + SLO 卡 + 培训材料(题纲即可)
  • ☐ 验收清单:谁验收、验收标准、签字人(逐条列出)
  • ☐ 技能卡 1 张:fde-scope skill add --title "<标题>" --category methodology --body "<正文>" 内容:场景 → 问题 → 做法 → 证据 → 适用边界(什么情况下不适用);确认无误后 fde-scope skill publish <skill-id>
  • ☐ 退场计划:交接后 30/60 天支持安排 + 终止条件
  • ☐ 答辩式演练:接受"客户运维负责人"的三个刁难问题(剧本见 07)

门禁自查 G7:四件套齐全|验收清单含签字人|技能卡含适用边界|退场计划有终止条件。 常见坑:交接包是给客户的、不是给自己的(客户不打电话能活几天?)|技能卡写成流水账。


Day 8 · 变现日

今日产出(🎯 产出 8):作品集三套包装 + 结营答辩

  • ☐ 作品集索引页:8 件产出的名称 / 日期 / 证据链接 / 一句话价值
  • ☐ 求职版:简历段落 3–5 行(含数字,句式见 10)+ STAR 故事 3 个
  • ☐ 汇报版:一页纸(价值 / 证据 / 下一步要什么)
  • ☐ 接单版:服务清单 + 案例页
  • ☐ 面试自测:20 题库里至少自测 10 题,写下答案要点
  • ☐ 结营答辩 10 分钟:做了什么 → 证据是什么 → 如果重来会改什么

门禁自查 G8(结业门):G1–G7 至少 6 关通过|索引完整|完成答辩|等级已判定。 常见坑:作品集全是"我做了"没有"数据显示"|答辩超时(现场会打断,这就是交付纪律)。


5. 提交规范与补交

项 规则
命名 D<N>-姓名-产出名(多文件加后缀:-截图1 / -数据)
渠道 群内指定提交入口(表单 / 接龙,以当期公告为准)
截止 直播次日 21:30 前;次日 08:30 出通过榜
24h 内补交 正常放行(标注"补交通过")
超 24h 补交 记"延期通过":计入完课,作品集等级最高 B
豁免 数据涉密 / 岗位冲突等特殊情况,私聊讲师走豁免,记录在证书备注

补交申请格式(群里 @助教):

【补交申请】D3-李四-数据体检报告
原因:<一句话> | 预计提交时间:<明晚 20:00 前>
当前卡点:<一句话,方便助教提前准备>

6. 门禁自查卡(G1–G8 学员版速查)

提交前逐条打钩。判定细节与 blocker/warning 语义见 03 第 3 节; 每件产出的"交付物要求"(要含哪几项才算齐)见 02 当天的「交付物要求」小节。

门禁 交什么(🎯 产出) 一句话自查 反例(会被打回)
G1 产出 1 · 迷你链路:报告文件 报告文件真实存在 + 我能解释 只交了截图,没交报告文件
G2 产出 2 · 客户委托单 成功标准全是数字和时间 "提升运营效率"
G3 产出 3 · 数据体检报告 我敢下"能做/不能做"的结论 结论写"待定"
G4 产出 4 · 语料报告 + 客户话术 话术里没有任何术语 "我们做了语料补盲合成"
G5 产出 5 · 原型 + 评估 + bad case 坏例子都有下一步动作 只写了"模型不行"
G6 产出 6 · Runbook + SLO 卡 + 值班卡 别人照我的文档能处理 文档里全是内部黑话
G7 产出 7 · 交接包 + 技能卡 客户不打电话能活一周 交接包里没有回滚步骤
G8 产出 8 · 作品集三套包装 8 件产出索引齐全 + 答辩完成 答辩讲不出证据来源

7. 求助路径(三级,先自助再找人)

Level 0 · 自助
  ├─ 装环境报错     → 11 第 3 节故障排查表
  ├─ 要模板         → 12 模板库(复制即用)
  ├─ 概念不懂       → 12 术语表 + 当天录播回放(2 倍速重看"讲与演")
  └─ 命令报错       → 逐字比对 02 的任务卡命令(90% 是路径或拼写)

Level 1 · 同学(结对伙伴 + 群)
  └─ 群内提问须带四要素(见下方模板);同学能答的先答,答对有互助分

Level 2 · 助教(19:00–20:00 答疑窗口)
  └─ @助教 + 四要素;非窗口期留言,值班助教次日 12:00 前回复

Level 3 · 讲师(私聊,仅限)
  └─ 豁免申请 / 严重掉队 / 数据合规疑问 / 想换练习场景

提问模板(不带这四样,助教有权请你补齐再问):

【想问什么】D4 的 corpus 跑完没有生成报告
【我试了什么】重跑了两次、换过 --out 路径
【期望什么】reports/corpus_report.html
【实际发生】终端最后一行报错:<粘贴报错原文>
【截图】<附上终端截图>

8. 学习方法(怎么学最快)

方法 怎么用 依据
费曼复述 每天复盘环节用 3 句话讲给同桌;讲不清 = 没学懂 输出倒逼输入
回炉 每天开播 10 分钟抽考昨日 3 个概念;别只当听众 间隔重复
结对互评 强弱搭配,每天交换 1 次产出,必须找出对方 1 个问题 社会学习
证据文件夹 从 D1 开始建 证据/ 文件夹,随手存命令与截图 D8 作品集直接取用
先猜后看 看数据/看指标前先写下预期,再对照 制造认知冲突

别做的事:攒到周末补所有作业(记忆曲线已凉)|抄模板不改(答辩必露)|用真实客户数据练(红线)。


9. 用 AI 助手的开工模板(提示词包)

课程鼓励用 AI——这本身就是 FDE 的工作方式。关键约束:产出要能脱稿讲、数字要自己跑过、AI 参与要标注。

场景 提示词模板
改成功标准 "以下是我写的成功标准,客户是<角色>。请逐条指出哪些无法被客户自己验收,改写成含数字与时间的版本,并说明改动理由:<原文>"
翻译成客户话术 "把下面这段技术说明改写成 200 字以内的白话,读者是不懂技术的<客户角色>,不准出现'语料/覆盖度/合成'等词:<原文>"
挖 bad case 根因 "这是评估失败案例<粘贴>。给出 3 个根因假设,每个附一个可以在 10 分钟内完成的验证动作。"
写 Runbook 初稿 "为<场景>写运行手册:5 类事件,每类按'判断信号→处置→回滚→升级'四段。要求每步可被值班新人照着执行。"
角色扮演陪练 "你现在扮演一位反对上 AI 系统的业务主管,对我提 5 个尖锐问题,每次只问一个,等我回答后再追问。"

使用纪律:AI 给的内容你自己跑过/核过才能进产出;末尾标注"本件部分内容由 AI 辅助生成"。


10. FAQ(学员版)

问 答
少上一天直播行不行? 行,录播 24h 内补看并补交当天门禁;连续 2 天未打卡会触发三级干预(班主任会找你)。
装环境一直报错怎么办? 先查 11 第 3 节;仍不行进"环境急诊室"分组,助教 1v1;最差情况助教共享屏代跑、你口头指挥——照样算你完成。
没有 API key 能学吗? 能。全链路零 key 可跑(规则模式),LLM 只是可选加速器;D4 会演示有/无 key 的差别与失败回退。
能拿公司真实项目练吗? 可以,但必须先脱敏并经你的公司同意;真实客户名与 PII 一律不进群、不上传。拿不准就问讲师。
我平时用的 Qoder / Trae / 豆包工作 这些,跟课程冲突吗? 不冲突,不要求换工具。课程只叠"流程与门禁层";编码、写文档继续用你顺手的(01 §6.4)。
我的指标很差是不是做错了? 指标是地图不是成绩单。把最难看的那个数字翻译成"1 个 bad case + 1 个下一步动作"就对了。
能改案例吗? 能。07 的案例允许替换成你熟悉的行业场景,但四区结构与门禁不变。
全用 AI 生成的行不行? 行。答辩会请你脱稿讲 3 分钟,讲不清的判定为未达——这是课程唯一的"防伪"。
证书怎么拿? 过 G8 结业门即可(G1–G7 至少 6 关 + 索引完整 + 答辩完成);A/B/C 级判定见 03 第 6 节。

11. 结营前终极自检(D8 前夜用)

  • ☐ 8 件产出齐了,每件都能说出"证据在哪"
  • ☐ 作品集索引页填好(名称 / 日期 / 链接 / 一句话价值)
  • ☐ 简历段落 3–5 行,至少含 3 个数字
  • ☐ 答辩 5 分钟稿写好了,掐表练过 2 遍不超时
  • ☐ "如果重来会改什么"准备了一个指向自己决策的答案
  • ☐ 面试 20 题自测 ≥10 题,答案要点已写
  • ☐ 证据文件夹已归档,含每件产出的命令记录

都打钩了:明天你不是去"结营",是去把 8 件产出一次性拿出手——讲清价值、指到证据、说出下一步。 (本课"变现"指把能力变成可展示、可对客交付的产出,不承诺就业或收入,见 README 诚实边界。)

07 · 实战剧本与案例库

07

course-level-1/07-实战剧本与案例库.md

本文件是课程的演练素材总库:5 个虚构客户案例(3 个演练案 + 1 个反面教材 + 1 个止损示范)+ Day 2–8 的角色扮演剧本。 讲师用它演示,学员用它做作业,助教用它扮演"刁难的人"。

消费方:04-交付实施手册.md §3(D5/D7 角色扮演由助教执行)· 05-讲师手册.md §4(D4/D7 角色扮演提示)· 02-逐日教学大纲.md(每日时间盒)


0. 诚实声明(先读)

  • 本文件所有客户名、人名、数字全部虚构,与任何真实公司无关。案例 A–D 与 examples/seed_mock_engagements.py 里的演示档案同名同源(可在控制台里对照查看);案例 E(明源体检)是本文件特有的合成示范,没有对应 seed 档案,只能按 §2.5 的剧本使用。
  • 剧本中的"客户原话""反对意见"是典型情境合成,来自公开 FDE 实践中反复出现的模式(见 docs/fde_sop_full.md 的 12 反模式),不代表任何具体客户。
  • 演练中禁止使用真实客户名与真实 PII 替换案例内容。

1. 案例库总览

⚠ 本文件全部案例、客户名、人名、数字均为虚构示范,用于教学演练; 不得对外引用为业绩,也不得用真实客户名/PII 替换(见文首与 README §0 诚实边界)。

案例 Profile 训练重点 核心反模式考点 主要用在
A. 茶语万象 Teaverse(新茶饮连锁) ticket 全链路示范(已走完全程;ticket 跳过 3 个工业专属阶段,实走 15 阶段) 无(标杆案例) D2 讲师演示 + D4 参考档案
B. 迅捷出行 Swift Ride(网约车) ticket 冲突干系人 / 真实数据原型 Scope Creep · No HITL D2 学员作业(A 组)
C. 南湾汽车 Southbay Motors(整车厂) manufacturing 工业叠加层 / 门禁真实拦截 Safety Incidents · Data Quality Surprises D2 学员作业(B 组)+ D3 数据课
D. 星澜科技 Adnova(出海营销) ticket 反面教材:唯一发起人 Sponsor Collapse D2 开场的"错误示范"
E. 明源体检 Haiyuan(连锁体检机构) ticket 止损示范:正确地说"不" Infinite Pilots · 沉没成本 D7 或 D8(讲师 5 分钟复盘,见 §2.5)

分组方法:D2 起学员分为 A/B 两组,A 组用案例 B、B 组用案例 C,一直用到 D7; D8 答辩时交叉提问——"你用的不是你的案例,但仍要听懂对方讲什么"(客户现场常态)。


2. 案例档案

2.1 案例 A · 茶语万象(标杆案例,讲师演示用)

客户一句话原话(演示开场直接念):

"全国 2800 家门店,每周订货全凭店长拍脑袋——订多了报废,订少了断货。 我们买了数据平台,但没人知道怎么让它'会订货'。"

背景卡:新式茶饮连锁 · 门店 2800+ · SKU 86 个 · 三个数据源(门店 POS / 供应链 / 会员)。

干系人(参考档案,学员不直接看):

人 角色 在乎什么
王芳 副总裁 · 数字化中心(发起人) 门店周订货准确率 ≥98%
陈宇 CTO(第二发起人) 全渠道会员 DAU 增长 30%
林晓 供应链总监 报废率与断货率
赵磊 数据平台负责人 接入工期与系统稳定性

参考成功标准(档案版):≤14d 完成数据接入(瞬时 10w+ TPS)· ≤90d AI 订货预测上线覆盖 90% 门店 · MAE 较基线下降 ≥20% · ≤120d 完成运维移交,SLO 99.5%。

演示命令:

fde-scope engage init --customer "茶语万象" --profile ticket
fde-scope gate list                       # 全部 10 个门禁(第 3 列 🏭=工业专属 7 关 / 🏢=通用 3 关)
python examples/seed_mock_engagements.py  # 幂等;种出全部 10 个 mock engagement
fde-scope web                             # 找到「茶语万象」看完整档案与已通过的 gate

演示要点:"这是别人家的满分作业——但你要做的不是抄,是知道每一站的证据长什么样。"


2.2 案例 B · 迅捷出行(学员 A 组,ticket)

给学员的客户简报(原始形态,故意不给整理好的):

"我们 146 个城市,客服中心每天 8 万通电话,投诉、调度、发票什么都有。 老板要求 AI 客服拦截率 60% 以上,人工工单降 30%。但数据总监说数据给不了那么快, 客服中心负责人又担心 AI 答错要背锅。你们看着办。"

背景卡:网约车平台 · 146 城 · 订单样本 5.2M 行 / 投诉 41k 条 / 司机侧会话 12k 条(含 PII)。

干系人(学员要自己整理出这张图,以下是档案对照):

人 角色 在乎什么 隐含冲突
罗成 技术 VP(发起人) AI 客服拦截率 ≥60% 要快
邓琳 数据总监(第二发起人) 146 城数据 ≤14d 接入 要稳,怕数据暴露风险
钱锋 客服中心负责人 人工工单下降 30% 怕 AI 答错砸了满意度
孙丽 司机端产品经理 司机投诉响应时长 关心司机侧,与客服 KPI 不同

训练重点:

  • 冲突干系人:罗成要快 vs 邓琳要稳;钱锋怕背锅 → 课程会问"成功标准写谁的"?
  • 隐含 PII:投诉与司机会话含 8900 条 PII 候选 → D3 数据体检的靶子。
  • 方言/口语化:已知局限(档案),D5 bad case 的天然素材。
  • 反模式考点:Scope Creep(四个人四个 KPI,不砍就爆)、No HITL(客服场景必须有人机协作)。

参考成功标准(档案版):≤14d 接入 146 城 · ≤90d 上线拦截率 ≥60% + 工单下降 30% · ≤120d 移交 bad_case <8%。

查看参考档案:python examples/seed_mock_engagements.py 后打开 web 控制台 →「迅捷出行」。


2.3 案例 C · 南湾汽车(学员 B 组,manufacturing)

给学员的客户简报:

"南沙工厂,焊装 + 座舱两条线。老板签了全栈 AI 战略合作,要'产线数据上云'加'座舱语音助手'。 但焊装车间主任说 PLC 谁都不许碰,安全部门还没签字,工会……我们厂没有工会。 两个赞助人,一个要激活率,一个要上云速度。"

背景卡:整车厂 · 焊装主线 PLC(Siemens S7 / PROFINET 环网)+ 智能座舱 HIL 台架(dSPACE)+ AGV 车队(5G)· 2 班制 · OT/IT 已分离 · 非气隙环境。

这个案例的特殊价值——门禁会真的拦住你:

想自己新建一个档案走到这一步?别这么干——新档案从 qualification 起步, 要逐关补齐成功标准、数据接入、语料、原型、验证五道材料才能摸到 deploy; 那本身是案例 C 的练习内容,不是热身。这里直接看已经走到 deploy 的那份档案:

python examples/seed_mock_engagements.py                          # 幂等;先种出 10 个虚构档案
COLUMNS=200 fde-scope engage list                                 # 找到 eng-southbay-manufacturing-seed03
fde-scope engage status eng-southbay-manufacturing-seed03         # 停在 deploy 阶段
# deploy 阶段有三个门禁,逐个查(不带 --gate 只查本阶段第一个 = fat_sat):
fde-scope gate check eng-southbay-manufacturing-seed03                              # ✋ fat_sat:SAT 未执行
fde-scope gate check eng-southbay-manufacturing-seed03 --gate functional_safety     # ✋ 未做危险分析
fde-scope gate check eng-southbay-manufacturing-seed03 --gate conformity            # ✋ CE / Annex IV / 危险分析 三条

档案版显示:FAT/SAT 未执行、功能安全未做危险分析、EU AI Act 高风险 → 缺 CE 与技术构造文件。 三个门禁全红(仅 conformity 一家就报了 3 条 blocker)——这正是课程想让你亲眼看到的: 工业现场的"上线"不是技术动作,是合规动作。

💡 gate check 撞上 blocker 时,系统会自动记一张待审技能卡草稿(飞轮设计,不是 bug)。 看完用 fde-scope skill review 查、fde-scope skill archive <skill-id> 清掉即可,详见 12 §3.5。

训练重点:

  • 工业 7 门禁全清单(site_survey / fat_sat / functional_safety / conformity / works_council / air_gap / shift_handover);本案例主要触发前 3 个 + air_gap / shift_handover
  • 车间主任说"PLC 不许碰" → site survey / 干系人地图的真实形态
  • 反模式考点:Safety Incidents(没做危险分析就动产线)、Data Quality Surprises(OT 数据形态与 IT 完全不同)

配套练习数据:

fde-scope corpus --input examples/quickstart_manufacturing/alarm_corpus.jsonl --out reports/alarm_corpus_report.html
# KPI 默认把 5 个工位聚合(grasp_success_rate=0.7931);想单独看某个工位就先把它单独存一行:
fde-scope kpi eng-southbay-manufacturing-seed03 --samples examples/quickstart_manufacturing/station_samples.jsonl
grep ASSY-HUMANOID-01 examples/quickstart_manufacturing/station_samples.jsonl > assy.jsonl
# ↑ Windows:findstr ASSY-HUMANOID-01 examples\quickstart_manufacturing\station_samples.jsonl > assy.jsonl
fde-scope kpi eng-southbay-manufacturing-seed03 --samples assy.jsonl    # grasp=0.7333、干预率=0.0321

(ASSY-HUMANOID-01 抓取率 73%、干预率 3.2%,是"还在爬坡"的典型画像——D5 挖 bad case 就用它。 顺带记住这个坑:指标永远先问"分母是谁"——整份文件的聚合值不是任何一个工位的画像。)


2.4 案例 D · 星澜科技(反面教材,D2 开场用,5 分钟)

用途:讲师在 D2 回炉环节展示的"错误示范"——只有一位发起人的委托单。

"出海营销 AI 素材工厂。COO 一个人拍板,说'先把东西做出来,其他人我来协调'。 委托单很漂亮,成功标准也有数字。但干系人地图上,发起人只有 1 个。"

追问学员:"如果这位 COO 下季度调岗,这个项目还活着吗?"(引向 Sponsor Collapse 与第二发起人制度)

档案里这条也真实存在(_run_gates 故意判 fail)——控制台里「星澜科技」的 success_criteria gate 是红色的。


2.5 案例 E · 明源体检(止损示范,D7 或 D8 收尾用,5 分钟)

用途:全课唯一一个"正确答案是走人"的案例。前四个案例训练"怎么把事做成", 这个训练"怎么判断一件事不该继续做"——G2 门禁要求委托单里必须有「放弃标准」,这一节就是它的实战演示。 谁讲:讲师口头讲,不用档案、不用命令,讲完留 3 分钟讨论。

背景(虚构):某连锁体检机构想做"AI 报告解读助手",已谈了两轮,氛围很好。

三条致命信号(讲师逐条给出,每给一条问一句"这时你会怎么做"):

信号 事实 为什么致命
① 无第二发起人 只有运营总监一个人推动;CTO 明确说"这是他们部门自己的事" Sponsor Collapse(同案例 D);一调岗项目就死
② 成功标准永远定不下来 三次访谈拿到三套说法:"客户满意度""解读时长""减少投诉",且都不肯写数字 没有 done = Infinite Pilot 的标准开场
③ 拿不到数据 体检报告涉大量健康 PII,法务明确拒绝任何形式的数据出域,也不批脱敏环境 数据红线:连"有条件能做"都构不成

剧本推演(讲师按这三步讲,学员只需听+讨论):

  1. 第 1 轮(体面提出):把三条写成书面风险清单,给出"如果你能解决①和③,我们下周就能开工"的条件。
  2. 第 2 轮(对方给不了):对方说"先做个小 demo 给上面看看,预算后面再说"。 —— 这句话同时命中 Infinite Pilot 与 Sponsor Collapse,此时不是砍价时机,是触发放弃标准。
  3. 第 3 轮(正式退出):按委托单 §6「放弃标准」执行:书面说明退出原因(只陈述事实,不指责)、 移交已完成的调研成果、留下"满足条件时的重启路径"、把这段经历写成技能卡(12 §2.13)沉淀。

讨论题(留 3 分钟):

  • 已经投入两轮访谈,退了"亏不亏"?(考沉没成本:投入越多越舍不得,这正是反模式)
  • 退出的方式会不会毁掉客户关系?(考退出方式:事实陈述 + 移交成果 + 重启路径 = 关系反而更好)

讲师收尾金句:

"会做的人是供应商,会说不的人才是顾问。 你在这门课学的一切交付能力, 都必须配一条底线:知道什么时候不该接、接了什么时候该退。"

与门禁的对应:G2 委托单第 6 节「放弃标准」(12 §2.1);G7 退场计划「终止条件」(12 §2.12); 反模式 Infinite Pilots / Burnout Death Spiral(12 §1.6 十二大反模式速查表第 8、6 条)。


3. Day 2–8 演练剧本(角色扮演)

通用规则:扮演者(讲师/助教)只给情境与追问,不给答案;学员必须用产出里的证据回应。 每次演练 3–5 分钟,结束后扮演者当场给 1 条"最狠的点评"。

3.1 D2 · 客户开场(助教 → 学员)

角色卡:见 §4.1。台词骨架:

(学员:自我介绍 + 想了解"痛点")
客户 CTO:别问了,我时间有限。我就一句话——AI 客服,三个月,能上就上。
          (学员若直接问数据)
客户 CTO:数据的事你找数据部,我只要结果。
          (学员若坚持问成功标准)
客户 CTO:那你说,你觉得这个"成功"应该怎么定?给我个数字。

观察点:学员是否顶住"直接要结果"的压力,把对话拉回成功标准与干系人; 是否识别出"客户只有一位出面人"(→ 追问第二发起人)。

3.2 D3 · 数据交接(助教扮演客户 IT → 学员)

情境:学员拿到案例数据文件。助教扮演客户 IT 主管,给数据时埋三个坑(照 dossier 设定):

  1. "这是我们能给的全部字段了。"(实际含 PII 候选字段,学员必须挑出来说"这个不能收")
  2. "类别分布很均匀的,放心。"(实际长尾极不均匀,学员要当场用 connect 输出反驳)
  3. "时间范围?大概是去年的吧。"(要求学员把"大概"变成确认项写进体检报告)

观察点:是否先看再装(先跑 connect 再下结论);PII 识别是否敢说"不收";结论是否明确。

3.3 D4 · 语料汇报(助教扮演客户老板 → 学员)

学员用 ≤200 字白话汇报语料结果。老板(助教)只追问三句:

  1. "你说的'能用多少',从头到尾是哪几个数字?"
  2. "补的那些样本,是你编的吗?"(考诚实标注与合成比例)
  3. "我一个字没听懂,重讲一遍,说人话。"(考零术语)

观察点:数字链完整(N→M→切分)|合成比例如实|重讲一遍仍不崩才是真懂。

3.4 D5 · 反对意见业务主管(助教扮演)★ 04/05 指定剧本

角色卡:见 §4.2。助教从下列反对意见中抽 3 条逐一发难,学员须用数据回应(禁止讲情怀):

# 反对意见(原话) 学员应调用的证据 反面回应(扣分)
1 "AI 答错了谁负责?出了舆情你们赔吗?" 评估指标 + bad case 率 + HITL 设计(人工兜底) "我们模型很准的,放心"
2 "你们根本不懂我们业务,先把知识库做好再说" 数据体检结论 + 真实数据原型结果(已经跑过) 争辩"我们很懂"
3 "预算砍一半,功能一个不能少" 成功标准优先级 + 放弃标准(当场划掉哪个) 全盘答应(Scope Creep)
4 "60% 拦截率太低了,我要 95%" 基线对比 + 渐进路线(先 60% 再涨)+ 反问成本 硬承诺 95%
5 "上一个供应商的 Pilot 做了半年,然后没有然后了" 时间盒(≤90d 上线)+ 验收清单 + 明确 done "这次不一样"(无证据)

扮演纪律:助教必须追到底——学员一给数字就换角度再问;学员说"不知道"时, 追问"那你准备怎么查、什么时候给答复"(诚实 + 行动 = 通过)。

观察点(评分表见 §5):用数据而非情怀|承认不知道时给行动|把反对意见转成可度量条件|守住范围。

3.5 D6 · 凌晨 2 点盲测(学员 ↔ 学员,助教监考)

剧本:随机交换 Runbook。B 学员朗读 A 学员的文档,遇到"读不下去/听不懂/缺步骤"处当场举手:

B(举手):这里写"检查服务健康"——凌晨 2 点的人具体敲什么命令?
B(举手):回滚这步说"恢复备份"——哪个备份?最近的还是昨天的?
B(举手):升级路径写"联系负责人"——谁的手机号?他不接怎么办?

观察点:每处卡壳都是 Runbook 的断点,A 学员当场记下并修复;修复后再测一次。

3.6 D7 · 客户运维负责人三个刁难问题(助教扮演)★ 04/05 指定剧本

角色卡:见 §4.3。这是交接签字演练——助教扮演不信任你的客户运维负责人, 提出三个刁难问题,学员须翻交接包作答(回答时手指要落在文档上,指出对应段落):

# 刁难问题 学员应指向 通过标准
1 "你说回滚 5 分钟——我们昨晚试了 40 分钟,怎么解释?" Runbook 回滚段 + 演练记录 承认差距 → 给出重新演练与修订文档的承诺与时限
2 "SLO 写 99.5%,真出事故,你们赔吗?" SLO 卡错误预算段 + 支持安排 讲清错误预算语义(预算内不追责)+ 退场计划里的支持边界
3 "我们的人看不懂'drift''bad case'这些词——你走了谁给我翻译?" 培训材料题纲 + 术语白话对照 指出培训已覆盖 + 承诺补充白话版;不得贬低客户
4 "模型悄悄变差了,谁先发现?" 监控与漂移段落 + 告警路由 指出漂移监控 + 告警路由,且给出没配监控时的补救方案

观察点:是否在交接包内找答案(找不到 = 交接包不合格,当场记 G7 修复项)| 是否诚实("这块我们没做到,我记下来"vs 硬撑)|语气是否专业不卑不亢。

3.7 D8 · 答辩追问(讲师/助教/学员代表)

答辩追问用 10-变现路径与结营包.md 的 20 题库, 优先抽这四道高频题(10 §7 中带 ⭐ 的题;与 docs/fde_playbook.md 的面试防御表一致):

  1. "FDE 和传统实施工程师的区别?"(考世界观)
  2. "客户数据质量极差怎么办?"(考接数据的诚实:敢下"能做/不能做/有条件能做"的结论)
  3. "客户现场没有外网、不想用外部 LLM 怎么办?"(考降级路径认知)
  4. "多租户数据泄露怎么防?"(考三层隔离:沙箱 / collection / 权限引擎)

评分见 03 第 5 节答辩评分表。


4. 角色卡(可直接打印发给助教)

4.1 角色卡 · 客户 CTO(D2 用)

你是「<案例客户>」的 CTO。特点:
- 时间少、语速快、要结果,对"调研""需求分析"这类词不耐烦
- 但心里其实是支持这个项目的(你签的字),只是被上次的失败供应商伤过
- 如果学员坚持问"怎么定义成功",你会松口——但要求他给数字
- 如果学员不问干系人,你全程不会主动提第二个人(埋雷)
暗号:学员问出"谁和您一起为这个结果负责"时,你可以提"VP 和我也在盯"(给出第二发起人线索)

4.2 角色卡 · 反对意见业务主管(D5 用)

你是使用部门的主管,一开始就反对上这个系统。特点:
- 不讲技术,只讲"出事了谁负责""我的团队会不会被裁"
- 对任何指标都先质疑口径:"你说 91%——统计的是哪批数据?谁标注的?"
- 学员给数据你就承认一部分,然后换一个新角度继续质疑(不许一次就放行)
- 底线:如果学员承认"不知道"并给出查证动作 + 时限,你要点头
暗号:学员说"我们可以在 90 天验收清单里加这一条"时,你松口:"这条我要签字。"

4.3 角色卡 · 客户运维负责人(D7 用)

你是客户方接手运维的负责人。特点:
- 保守、抠细节、怕背锅;你最恨"交接完就找不到人"
- 你的三个刁难问题见 §3.6;学员回答时你必须盯着他的**文档**——他要指给你看
- 如果他只说"我会支持你们",你会说:"你走了以后呢?"
- 底线:交接包里有明确段落 + 支持终止条件 + 演练记录,你就签字
暗号:学员主动说"我们安排一次联席演练,演练通过你再签"时,你同意签字

4.4 角色卡 · 车间主任(案例 C 专用,D3/D5 备用)

你是焊装车间主任。特点:
- 不信任何"上云",你的 PLC 停一分钟就是几十台车的损失
- 说话带工地味:"你们坐在办公室吹空调,知道焊装线停线赔多少吗"
- 学员提"停线做测试"你就炸;学员提"旁路采集、不碰控制回路"你才给好脸色
- 底线:学员把"不碰 PLC 控制层、只读数据"写进方案里,你认可
暗号:学员问"FAT 阶段你们能安排哪个窗口"时,你给一个 2 周后的停机维护窗口(考 site survey)

5. 助教评分要点(每次演练后现场给)

每次角色扮演结束,助教在群里发一句带 [演练] 前缀的点评,格式:

[演练·D5] 张三:✅用 bad case 数据回应了"答错谁负责",并给了 HITL 兜底设计
          ⚠️ 被问到"预算砍半"时全盘答应了 3 个新需求——Scope Creep 预警,去补"放弃标准"

通用观察表(助教打钩用):

观察项 通过 未达
用证据回应(数字/文档/演示)而非情怀 ☐ ☐
承认不知道时,给出查证动作与时限 ☐ ☐
把对方的情绪翻译成可度量条件 ☐ ☐
守住已定的范围(含当场拒绝新需求) ☐ ☐
语气专业、不卑不亢、不贬低客户 ☐ ☐

学员的演练收获(每次演练后 60 秒写进群):

"对方最难的那个问题是什么?我用了什么回应?下次我会改什么?"


6. 案例使用规则

允许 禁止
把案例替换成自己熟悉的(脱敏)行业场景 使用真实客户名 / 真实人名 / 真实 PII
在简报基础上补充合理细节(注明"补充假设") 修改门禁标准来"让自己好过"
跨组借用对方案例的数据(D8 交叉提问) 编造参考档案里没有的"客户原话"当证据
把参考档案当作"参考答案"对照自己的差距 直接抄参考档案当自己的作业(答辩会露)

企业内训特别说明:企业版(04 形态 C)直接把案例簿替换为客户自己的一个真实(脱敏)小场景—— 但简报形态要保留"原始、未整理"的样子,因为训练的核心就是"从模糊到可交付"。

08 · 运营手册

08

course-level-1/08-运营手册.md

面向运营负责人与班主任:招生 → 开营 → 日常 → 结营 → 复训的全流程 SOP。 交付执行(排期/人员/应急)见 04-交付实施手册.md; 指标与复盘模板见 09-运营指标与复盘.md。


1. 运营角色与总时间轴

角色 一句话职责
运营负责人 招生漏斗、社群、激励、结营组织;对完课率与 NPS 负责
班主任 每日节奏执行(任务卡/催交/门禁榜)、掉队干预、学员关系
助教(教学侧) 答疑、门禁初审、角色扮演——管理规则见 §8

一期总时间轴(标准 8 天案;压缩案见 04 §2):

T-14 招生启动 → T-7 报名截止 → T-3 分班建群 → T-1 开营前任务
D1–D8 每日运营节奏(§4)→ D+1 结营问卷 → D+7 变现回访 → D+30 期报复盘

2. 招生

2.1 渠道与文案

渠道 侧重 备注
公众号 / 社群 世界观长文 + 学员产出实拍 用真实作品集(须书面授权,见 03 §8)
短视频 60 秒演示:一条命令跑通 corpus 用虚构案例数据,不露真实客户
合作渠道(企业/猎头/社区) 企业内训对接 转 04 形态 C

文案三要三不要:

  • ✅ 要讲产出:"8 天带走 8 件可展示的交付物"
  • ✅ 要讲诚实边界:"训练能力与作品集,不承诺就业、不承诺收入"
  • ✅ 要讲零门槛:"不需要会 Python,不需要 API key"
  • ❌ 不要用"包就业 / 保涨薪 / 学完年薪 X 万"(合规红线,见 §11)
  • ❌ 不要贬低学员现状("还在做螺丝钉?")——用中立的问题陈述替代
  • ❌ 不要在营销素材里出现任何真实客户名/真实数据

禁用句清单(原句 → 为什么 → 换成什么)

# ❌ 禁用句(及同类变体) 为什么禁 ✅ 换成
1 "包就业 / 保涨薪 / 学完年薪 X 万" 合规红线,本课不提供就业与收入承诺(10 §8、§11) "训练能力与作品集;就业与收入不承诺、不预测"
2 "国内首个 / 全国唯一 / 行业第一" 官办与商业培训已在快速铺开,"首个"很快会过期,且无法自证(13 §6 #10) 用可核对的特点替代排名:零 key 可跑、8 件产出、门禁制(13 §1)
3 "学完就能考 CFDE / 包过认证班 / 考完送证书" 我们没考过、与发证方无合作(15 §2.3) 照 15 §2.1–§2.2 讲"有哪三条路径、怎么叠加",明说不代报名、不返佣
4 "结业送工信部 / XX 大学证书" 证书必须谁的渠道写谁的名,错渠道即虚假陈述(15 §2.2 例) 只写实际颁发的那张(本课证书 + 编号规则,15 §1.2)
5 "8 天顶 4 个月 / 8 天达到资深 / 学时顶 XX 学时" 学时不是可比单位,且我们主动认账深度有限(04 §1.2 读表纪律 2) "8 天学到能独立跑通一条链路 + 手里有 8 件产出;资深要靠真实项目里练"
6 "FDE 人才缺口 XX 万 / 平均月薪 XX"(无来源) 无出处数字一律禁用(10 §8) 引用四要素:<区间> | 来源 | 采集日期 | 口径;匿名爆料不做唯一来源
7 "原价 ¥X 现价 ¥Y / 最后 3 个名额 / 今晚涨价" 虚构划线价与无依据稀缺(04 §1.2 三条禁止) 写本期班型与人数上限("最多 30 人")+ 价格的构成口径
8 "包学包会 / 学不会全额退"(无书面条款) 承诺必须有可执行条款与责任主体 只承诺已写进文档的东西:补交与复训(03/08 §9)、申诉三步(§10)
9 "学员 XX 学完涨薪 X%"(个案当统计) 个案不等于比率;对外数字必须带分母与样本量(15 §3.3) 只引用 15 §4.1 的结果度量表,且带分母;未达样本量只做定性
10 素材里出现真实客户名 / 真实数据 / PII 数据红线(§11) 一律用虚构案例库(07);真实作品集须本人书面授权(03 §8)

怎么用这份清单:招生文案发布前,用 Ctrl+F 搜关键词——包、保、首个、唯一、原价、名额、缺口、年薪—— 命中任一条就改;改不了就不发(宁缺一次曝光,不欠一次承诺)。

这份清单与 10 §8 查证纪律、13 §6 劣势认账、 15 §2/§3 发布纪律,是同一套纪律的四个切片;改一处要对齐另外三处。

2.2 报名筛选(3 个问题,报名表内嵌)

  1. "你目前的工作/学习状态是?"(分人设 A/B/C,见 01 §2)
  2. "接下来 8 天,你每天能稳定投入 2 小时吗?"(选"不能"→ 引导自学版 04 形态 B)
  3. "你更想要什么:听概念 / 动手交付?"(选前者 → 明确告知本课以动手为主)

分班规则(T-3 执行,按自评雷达):强弱搭配结对;每 15–20 人配 1 助教; 同一个组的学员尽量来自不同行业(扩大互评视角)。


3. 开营(T-3 → D1)

T-3 · 建群与预热

  • ☐ 建群、置顶五件套:任务卡入口 / 答疑时段 / 群规(§5)/ 诚实边界声明 / 提交入口
  • ☐ 发布《学员手册》06,要求开营前读完 §0–§2
  • ☐ 发放自评雷达(4 维 1–5 分)+ 学习契约(06 §1)

T-1 · 开营前任务(环境)

  • ☐ 发布环境准备指引 → 11;群内"装好了"接龙
  • ☐ 统计未装好人数;>20% 报错 → 触发 04 §6 的"环境急诊室"预案
  • ☐ 公布分班与结对名单、助教分工与答疑排班

D1 · 开营仪式(30 min,运营主持 + 讲师压轴)

1. 运营(10 min):课程契约、门禁制、补交规则、群规、诚实边界
2. 学员(15 min):30 秒自我介绍(我是谁 + 我最怕现场哪件事)
3. 讲师(5 min):一句话点燃 + 预告今晚就要交第一件产出

4. 每日运营节奏 SOP

与 02 附录、04 §5 同一套节奏;本节的"运营动作"列是班主任的执行清单。

时间 动作 负责人 验收
08:30 发布门禁通过榜(昨日)+ 催未通过者 班主任 榜单+@未通过者
09:30 发布当日任务卡(06 对应日)+ 门禁检查项 班主任 群消息 + 置顶更新
直播中 记录"停车场"问题(讲师转交) 助教 问题清单
直播后 30 min 上传录播 + 讲义 + 命令清单 助教 群公告链接
13:00 午间"昨日优秀作品"展示(附点评一句话) 班主任 需学员授权(03 §8)
19:00–20:00 集中答疑窗口(语音/直播) 助教轮值 响应率 100%
21:00 提交截止前 30 min 提醒(仅提醒未交者) 班主任 私聊
21:30 催交 + 当日优秀作品提名(收集) 班主任 提名 ≥1 件
22:00 汇总:当日提交率、答疑遗留问题 班主任 记入 09 看板

每日运营三件必做:①任务卡准时(误差 ≤10 min)②答疑响应 100% ③掉队者当天私聊(不公开点名)。


5. 社群 SOP

5.1 群规(置顶,开营日发布)

  1. 不发广告、不拉人、不私加好友推销。
  2. 提问用四要素模板(06 §7);报错先附截图。
  3. 真实客户名与 PII 一律不进群(红线,见 §11)。
  4. 作业不抄袭;被发现抄模板不改者,公开提醒一次,二次记录。
  5. 友善:不嘲笑小白问题——"这是 FDE 现场最贵的品质"。

5.2 话题节奏(保持群活性的每日栏目)

栏目 时间 内容
#今日一句 09:00 讲师金句(05 §7 金句库)
#踩坑接龙 全天 学员贴一个报错 + 怎么解的;解对的加分
#优秀作品 13:00 昨日最佳产出(授权后展示)
#凌晨2点 21:00 预告/复盘 D6 的盲测梗,制造记忆点

5.3 禁止与升级

  • 出现争执:班主任先私聊双方 → 群里发一句"已处理,回归学习"(不辩论、不站队)。
  • 出现广告/PII:立即撤回 + 私聊警告;PII 情形记录到合规日志(§11)。

6. 激励体系(积分 / 徽章 / 排行)

设计原则:奖励证据与互助,不奖励活跃度——否则会催生"水群"。

6.1 积分规则

事件 积分 说明
门禁按时通过(无补交) +10 每天最多一次
24h 内补交通过 +5 留痕但仍有分
助人解答被采纳 +5 由被助者或助教确认
结对互评(有效:找出对方 ≥1 个真实问题) +5 每天一次
优秀作品(讲师提名) +15 每天 ≤2 件
主动披露自己产出中的错误/不确定项 +5 诚实加分项(课程独有)
代做 / 伪造证据 清当件积分 并触发 03 §7 违规处理

6.2 徽章

徽章 条件
🎯 过闸人 连续 3 天门禁一次通过
🧪 淘金者 D4 语料话术被评为零术语且数字链完整
🛡️ 诚实者 累计 3 次主动披露不确定项
🤝 摆渡人 累计助人 ≥5 次被采纳
🏁 完赛者 G8 结业(按 03 §6 等级加注 A/B/C)

6.3 排行与奖品

  • 排行榜只展示前 10(避免公开倒数);个人分数私聊可查。
  • 奖池建议:A 级作品集定制点评 / 与讲师 1v1 职业咨询 30 min / 下期助教直通面试。
  • 禁止现金化排名(防止刷分)。

7. 三级干预(掉队处理)★

被 04 §6、05 §6 引用。触发信号:连续 2 天未提交门禁,或答疑窗口连续 2 次未现身且群内无互动。

第一级 · 私聊唤醒(班主任,触发后 24h 内)
  - 一句话确认状态:"你还好吗?卡在哪一步?"
  - 给出**最小可交付版本**(Mini 版):如 D3 只交"字段表 + 一个风险"也算过
  - 若因工作/家庭突发:启动"暂停键"——可申请把节奏切到自学版(`04` 形态 B)

第二级 · 助教 1v1(第一级后 48h 仍无产出)
  - 15 分钟共屏:当场陪跑一次任务卡,把卡点定位到"概念/工具/时间"哪一类
  - 定一个 24h 内的"复活交付"(一件比 Mini 还小的产出,重建动量)
  - 结果抄送讲师(进 `09` 掉队档)

第三级 · 讲师谈话(第二级后仍停滞,或学员主动求助)
  - 判断根因:目标错配(其实想学别的)→ 劝转班/退款;时间不可控 → 协商延期到下一期
  - 任何第三级处理都**私聊进行**,不上群、不点名(`05` §8 控场原则)
  - 记录"流失原因"分类,进 `09` 期报

干预铁律:宁可让学员"Mini 版通过",也不让他掉出节奏——连续性 > 完整性。


8. 助教管理

环节 规则
招募 过 G8 的往期学员优先(A 级直通);外部助教需通过"试扮演"(演 §4.2/§4.3 角色卡)
培训 当一期"影子助教"(04 §7)后上岗;发 [05 §4 带教要点 + 07 角色卡 + 03 门禁判据] 三件套
排班 每日答疑窗口轮值(19:00–20:00);角色扮演日(D5/D7)全员在线
质量 每周抽 3 条助教答疑评语,检查是否"给答案 vs 给方法"——给方法才合格
激励 按学员完课率 + 好评率给酬劳系数;优秀助教进讲师培养池
红线 助教不得私下接学员外包/私单(利益冲突);不得泄露学员作品

9. 结营、校友与复训

9.1 结营日(D8)运营清单

  • ☐ 答辩排期表(>40 人分组,见 04 §6);计时员就位
  • ☐ 结营仪式:表彰(最佳作品/最佳互助/最快进步)、证书发放、合影
  • ☐ 收集:结营问卷(NPS + 最有价值一天 + 最想砍掉一天)
  • ☐ 预告:D+7 变现回访、复训规则、校友群入口

9.2 校友群与复训

项 规则
校友群 结营后保留;每周一次"作品集诊断"接龙(往期学员可提问)
复训 B 级学员免费旁听下期(03 §6);C 级可免费重读
复训义务 复训学员须当"摆渡人"(每周至少帮 1 位新学员)——形成互助飞轮
助教通道 A 级学员可申请助教(§8 流程)——课程自身的"飞轮"(对应 docs/fde_sop_full.md 阶段 15)

10. 运营 FAQ

问题 处理
学员要求退款? 开营前:全额退;开营后 D1–D2:退 50%;D3 起不再退(可延期到下一期一次)。以招生页条款为准。
学员想插班? 仅允许 D2 前插入,且须先补 D1 录播 + G1;之后一律引导下一期。
学员要求换组/换案例? 允许一次(私聊班主任),避免"案例不合口味"成为掉队借口。
企业客户要开发票/对公? 转 04 形态 C 报价流程;发票信息收集表另附。
讲师和学员起冲突? 班主任先接住学员情绪,48h 内与讲师对齐;若属实,进期报改进项。
学员想退课但先要作品集? 按已完成的产出如实交付(作品集归学员,03 §8),不设卡。
学员觉得被"判错"(门禁/评分不服)? 走申诉三步:① 私聊班主任写清"哪一条 / 我认为应该是什么 / 证据";② 24h 内由未参与该次评分的人(另一位助教或讲师)复核原件;③ 结果书面回执。改判成立 → 更新成绩并进期报改进项;不成立 → 说明理由。申诉不影响态度评分;对 G8 结业门结果仍有异议 → 班主任升级讲师,3 个工作日内终裁。
学员投诉讲师/助教(态度、迟到、歧视性言论)? 班主任先接住情绪、不辩解,24h 内独立记录事实与时间点;涉歧视/骚扰类零容忍——立即隔离当事双方、上报课程负责人,与当事人分开取证。处理过程不公开点名,结果告知投诉人。投诉渠道始终开放:班主任私聊 → 课程负责人 → (企业内训)客户 HR 对接人三级可达。

申诉与投诉的共同纪律:全程书面留痕(私聊记录/邮件),进合规日志(§11 第 5 条); 不得在公开群讨论具体投诉内容,不得因申诉/投诉降低对学员的评价。


11. 合规与数据红线(运营视角)

  1. 宣传口径:不得承诺就业/收入;引用薪资数据必须带来源与日期(见 10)。
  2. 学员数据:报名信息仅用于课程运营;对外展示作品集需书面授权(03 §8)。
  3. 练习数据:群内一旦出现真实客户名/PII——立即撤回 + 私聊 + 记录合规日志; 该学员产出退回替换为脱敏数据(04 §6 预案)。
  4. 录播与资料:仅限本期学员,不公开传播;讲师演示环境不出现真实客户内容。
  5. 合规日志:每期一份,记录事件/时间/处置/后续动作,随期报归档。

09 · 运营指标与复盘

09

course-level-1/09-运营指标与复盘.md

本文件回答两个问题:这期办得好不好,拿什么数字说话?办完之后怎么改进,改进有没有落地? 操作流程见 08-运营手册.md|教学复盘视角见 05-讲师手册.md 第 9 节。


1. 北极星指标

北极星 = 作品集完整率(8 件产出齐全的学员数 ÷ 实际开课人数)

为什么不是完课率?因为完课率可以被"降低标准"刷高——少判几道门禁、多放几个补交,数字立刻好看。 而作品集才是这门课的承诺物:招生海报上写的是"8 件可展示产出",兑现或没兑现,只看这一件事。

层 指标 回答的问题
北极星 作品集完整率 承诺兑现了吗?
辅助 变现动作率(D+7) 学员真的用起来了吗?
漏斗 7 级转化(见第 2 节) 哪一段在漏水?
健康度 每日看板(见第 4 节) 今天要不要干预?

一个视角提醒:复训率与转介绍率是滞后指标,第一期不要拿它对标——首期先攒基线。


2. 转化漏斗(7 级)

曝光 → 报名留资 → 缴费确认 → G0 入学门 → D1 开课 → G1–G7 逐关 → G8 结业 → D+7 变现动作
级 定义(口径) 采集点 首期基线
曝光 招生内容触达人次(各渠道去重后估算) 运营台账 首期只记录,不设目标
报名留资 填写报名表人数 报名表单 ——
缴费确认 完成缴费的人数 收款记录 ≥ 留资的 40%
G0 入学门 环境自检 + 契约 + 雷达三项完毕 06 §2 提交记录 ≥ 缴费的 85%
D1 开课 实际出席 D1 直播(≥ 一半时长) 直播记录 = 缴费人数(开营前流失在此暴露)
G1–G7 每关通过人数(分关记录,不合并) 门禁台账(08 §4) 逐关见第 4 节预警线
G8 结业 拿到结业证书人数 答辩记录(03 §5) ≥ D1 的 70%
D+7 变现动作 完成至少 1 个变现动作(更新简历/内部汇报/投递/接单咨询) D+7 回访(04 §5) ≥ 结业者的 60%

漏斗纪律:

  1. 分关记录,不合并。 "G1–G7 通过"这种合并口径会掩盖"卡在第 4 关"的真实问题。
  2. 首期基线用实测校准。 上表的建议值来自设计推演,不是行业数据——第一期跑完用实测覆盖它, 不要拿"行业均值"假装权威(与课程"诚实标注"原则一致)。
  3. 每级都记分母。 任何比率都必须能回答"除以谁"。

3. 每期体检表(合格线)

一期训练营是否"交付合格",与 04-交付实施手册.md 第 8 节同源,此处为运营侧的执行口径:

# 指标 合格线 判定 未达时的第一动作
1 完课率(G1–G7 通过 ≥6 关) ≥ 70% 硬线 掉队归因(第 5 节)写入期报
2 作品集完整率(北极星) ≥ 60% 硬线 检查是否为"最后两关集中掉队",下期重排时间盒
3 NPS ≥ 40 硬线 低于 0 的差评逐条读,进期报原声节
4 数据合规事故 = 0 一票否决 立即按 08 §11 处置,当期不得宣传
5 掉队复活率(进干预后回到 G 链) 记录观察 参考 复盘三级干预哪一级失效
6 门禁平均补交率 记录观察 参考 补交率过高说明当日时间盒太紧

一票否决说明:第 4 项不为 0 时,前 3 项再好看也不构成"合格交付"—— 这与仓库 Engagement.advance() 的 blocker 语义一致:硬拦项不通过,其余分数不生效。


4. 每日健康度看板与预警线

4.1 看板字段(每日 22:00 汇总时填写,08 §4)

字段 口径 一眼看什么
当日提交率 当日产出提交人数 ÷ 在线人数 掉了没有
当日门禁通过率 通过人数 ÷ 提交人数 是"没交"还是"交了不过"
答疑积压 19:00–20:00 窗口未闭环问题数 助教够不够
有效互助次数 帮同学解决问题且被确认的次数 社群是否在互助而非围观
掉队预警名单 触发预警线的人(见 4.2) 今晚要不要私聊
一句话异常 今日最出乎意料的一件事 期报素材

掉队预警名单同时抄送讲师,进入 09 掉队档(第 5 节)。

4.2 预警线 → 联动 08 三级干预

信号 黄线(提醒) 红线(立即动作) 联动
连续未打卡 1 天 2 天 红线自动进三级干预第一级(08 §7)
当日提交率 < 70% < 50% 红线:班主任当晚全员私聊排查
某关门禁通过率 < 60% < 40% 红线:次日直播加 10 min 回炉重讲该关考点
答疑积压 > 5 人排队 响应 > 2h 红线:启用第二答疑窗口(助教加班排班)
有效互助次数 连续 2 天 < 3 次 连续 3 天 < 3 次 红线:运营发起话题引导(08 §5)
NPS 中期快评 ≤ 0 ≤ −20 红线:讲师 48h 内找 3 名差评学员 1v1 面谈

原则:预警线只用来触发动作,不用来考核助教。指标一旦变成 KPI,就会被优化成数字游戏 (比如助教抢答简单问题刷"互助次数")——这是运营自己的反模式。


5. 掉队档(本期学员异常档案)

由 08 §7 的三级干预结果汇入,一人一行,逐期滚动。

字段 说明
姓名 / 分班 用于联系与面谈
触发日 / 触发级 哪天触发、落到三级干预的第几级
干预动作 实际做了什么(私聊 / 1v1 / Mini 版产出 / 谈话)
结果 复活(回到 G 链)/ 延期(转下期)/ 退款 / 失联
流失原因分类 见下方枚举,必填(失联者由班主任推测并标注"推测")
备注 面谈原话摘录(1–2 句),用于期报归因

流失原因枚举(统计时只在这 6 类里选,防止"原因:忙"淹没一切): 时间冲突 / 难度超预期 / 环境受阻(装不上) / 健康或家庭 / 岗位或工作变动 / 其他。

铁律:掉队档是内部档案,只在讲师与运营之间流转;任何对外材料不得出现学员姓名 (与 03 第 8 节的留档规则一致)。


6. 期报模板(结束后 48h 内提交)

提交人:运营负责人 + 主讲讲师(合并一份:运营填 1/2/3 节,讲师填 4 节的教学视角, 教学复盘细目沿用 05 第 9 节模板,作为本期报的附件)。 提交对象:课程负责人;抄送:下一期全体讲师与助教。

# 第 X 期期报(YYYY-MM-DD ~ YYYY-MM-DD)

## 1. 漏斗数据(附件:当日看板截图)

| 级 | 人数 | 转化率 | 对照首期基线 |
|---|---|---|---|
| 报名留资 | | | |
| 缴费确认 | | | |
| G0 入学门 | | | |
| D1 开课 | | | |
| G1 … G7(逐关) | | | |
| G8 结业 | | | |
| D+7 变现动作 | | | |

## 2. 体检表(第 3 节 4 条硬线)
- 完课率:__% (线 ≥70%)→ 达标 / 未达
- 作品集完整率:__% (线 ≥60%)→ 达标 / 未达
- NPS:__(回收率 __%)→ 达标 / 未达
- 数据合规事故:0 / 有(如有,附处置记录)

## 3. 掉队与流失(附件:掉队档)
- 触发干预 __ 人:复活 __ / 延期 __ / 退款 __ / 失联 __
- 流失原因 Top2:(枚举分类 + 各 1 句典型原话)
- 三级干预有效性判断:哪一级失效了?证据是什么?

## 4. 教学与内容(讲师填写,详见 05 §9 附件)
- 三个最好用的(保留)
- 三个最卡的(改进)
- 本期新学员问题(进 `05` §5 提问库 / 淘汰旧题)

## 5. 学员原声(≤5 条,匿名)
- 好评(挑一条具体的,不挑空洞的)
- 差评(必须原文照录,不许润色)

## 6. 改进项(写入第 7 节闭环追踪表,不许只写在这一节里)

| 改进项 | 类型 | 负责人 | 截止日 | 验证方式 |
|---|---|---|---|---|
| | 教材/交付/运营 | | | |

7. 改进项闭环追踪表(长期滚动)

规则来自 04-交付实施手册.md 第 7 节: 期报中的每个"改进项"必须在下期开营前落实或明确否决。 本表就是那句"闭环记录在 09"的落地载体;02 文档头提到的"期报复盘闭环"也指这里。

编号 来源期次 改进项 类型 负责人 截止 状态 验证方式 / 否决理由
001 第 1 期 例:D4 时间盒 35 min 不够,多数人话术没写完 教材 教研 第 2 期开营前 已落实 D4 时间盒改 45 min,02 已更新
002 第 1 期 例:改用某新工具替代现有演示 交付 讲师 第 3 期开营前 已否决 学员环境安装成本高,与"零门槛"原则冲突

状态只有四种:待办 / 进行中 / 已落实 / 已否决。 两条硬规矩:

  1. 否决必须写理由——"已否决"要能回答"为什么不做比做了好"。
  2. 跨期滚动,不允许无声消失——上期"待办"在本期开营日仍无进展的,在期报第 6 节置顶标红。

8. D+30 期报复盘会

参加:课程负责人、讲师、助教代表、运营。时长:90 min。输入:期报 + 闭环追踪表。

时段 议程 产出
20 min 数据回放:漏斗 + 4 条硬线 + 掉队档 全员对事实达成一致(不解释,先看数)
20 min 掉队归因:流失原因 Top2 逐条过 归因结论(区分"课程问题"与"个体原因")
15 min 学员原声:差评逐条读(匿名) 至少 1 条转化为改进项
25 min 闭环追踪表逐行核对 更新状态;新增改进项定人定截止
10 min 下期开营准备:硬线不达标的补救动作 下期开营前必办清单(≤3 件)

会前必做:上一期标记"已落实"的改进项,抽查 1 条验证真伪(比如改过的时间盒, 直接翻 02 对照)——闭环不是打勾,是验证。这与课程讲给学员的"门禁思维"完全同构: 清单会烂,验证不会。


9. 数据口径与隐私

项 规则
采集时点 看板每日 22:00;漏斗在结营日冻结;D+7 变现动作在回访时采集
分母 所有比率的分母必须写进口径说明(第 2、4 节表格里已固化)
NPS 回收率 < 60% 时,NPS 数值标注"低回收率,仅供参考",不与往期直接比较
匿名化 期报中的学员原声一律去名;掉队档仅讲师/运营可见(03 §8)
对外使用 期报数据对外(招生、宣传)引用时,必须同时给出分母与样本量,禁止只摘"完课率 92%"式的裸数字
上报纪律 不修饰:掉队、退款、差评如实上报。运营不得为达标而调整门禁判定——门禁归讲师,指标归运营,这两件事永不互相将就

10. 反模式:会骗人的指标

虚荣指标(别用) 为什么骗人 替代指标
报名人数 免费留资谁都能冲量 缴费确认数 + 开课率
直播在线时长 挂机也算 当日提交率 + 门禁通过率
群消息数 灌水也算 有效互助次数(被确认的)
完课率(单独用) 可被放宽判定刷高 作品集完整率(北极星)
满意度打分 不看回收率没有意义 NPS + 回收率
平均分 掩盖尾部 分数分布 + 最低分那件产出
"学员反馈热烈" 无法证伪的形容词 差评原文 + 改进项闭环率

这张表的反面,就是课程教给学员的同一件事:证据 > 描述。 运营用虚荣指标自我麻醉,和 FDE 用策展数据演 Demo,是同一种债务。


11. D+90 长期跟踪(轻量版,3 个问题)

为什么要有:本课对外的一切说法都卡在"不承诺就业/收入"上(10 §8)。 但"不承诺"不等于"不关心"——结营 3 个月后学员到底用没用上,是课程唯一能拿出的长期证据。 不做长期跟踪,课程就只能永远说"我们教得很好",而这恰恰是本课批判的"无法证伪的形容词"(第 10 节)。

什么时候发:结营后第 90 天(±7 天),群内一次群发 + 未回者班主任单聊一次,不追问第二次。

问卷(就 3 题,30 秒可答完):

【<期次> 校友 3 个月回访 · 3 个问题】
1. 这 3 个月里,你有没有用过课上的东西?(单选)
   □ 用在工作里了   □ 用在求职/面试里了   □ 用在接单/副业里了
   □ 只自己练过,还没用出去   □ 完全没用上
2. 用得最多的是哪一件产出?(单选,与 `README` §3 八件同源)
   □ 委托单  □ 数据体检  □ 语料报告  □ 原型与评估
   □ Runbook/SLO  □ 交接包  □ 技能卡  □ 作品集包装
3. 如果只能改课程的一件事,你改什么?(一句话,可留空)

回收与使用纪律:

项 规则
目标回收率 ≥ 40% 即可用;< 40% 标注"低回收率,仅供参考"(同第 9 节)
样本量纪律 回收 < 8 人时只做定性参考,不做百分比对外引用——小样本的比率毫无意义
对外引用 只能引用"具体某人做了什么"(匿名化成"某期学员 A 在 <行业> 把语料报告用在了 <场景>"),禁止换算成"就业率/涨薪率/接单率"
反向用途 选"完全没用上"的人,单独私聊 15 分钟问"卡在哪"——这是课程最有价值的一份输入,进期报改进项
隐私 问卷匿名;若需署名引用,取得书面授权(03 §8)
归档 结果进本期期报附件(09 §6);跨期汇总看"哪件产出被用得最多"(指导课程重心调整)

与北极星的关系:北极星是"作品集完整率"(第 1 节),衡量交付质量; D+90 跟踪衡量交付之后的实际使用。两者一起,才凑齐了"教得成 → 用得上"的完整证据链。 若连续两期 D+90"完全没用上" ≥ 30%:这不是运营问题,是课程设计问题—— 按 08 §1 的角色链路升级:运营 → 课程负责人 → 讲师,在本节 §8 复盘会上列为专项议题; 相关结论写回 02(时间盒)/ 05(带教)/ 07(案例)的对应章节,并在期报第 6 节留痕。

10 · 变现路径与结营包

10

course-level-1/10-变现路径与结营包.md

先说清楚"变现"是什么:本课程说的变现,是指把能力转化为可展示、可验证、可复用的职业价值。 我们不承诺就业、不承诺收入——招生页、课堂、结营现场一致(见 README.md 诚实边界)。 变现的三层定义见第 1 节;作品集与面试题库供 02 Day 8、03 答辩、06 Day 8 任务卡调用。


1. 变现三层(Day 8 概念之一)

层 定义 载体 谁买单
第一层 · 对客户变现 你的交付本身产生业务价值:客户愿意为"结果"续约、扩单、转介绍 一页纸汇报 + 评估证据 + SLO 客户预算
第二层 · 对雇主变现 把课上能力用回本职:汇报可见度、转岗、晋升、内部影响力 一页纸汇报 + 作品集索引 你的组织
第三层 · 对个人变现 作品集 → 面试/接单/个人品牌:能力有了"价格标签" 求职版 + 接单版包装 市场

顺序不能反:先做成事(第一层),再被看见(第二层),最后才有议价权(第三层)。 跳过后直接兜售"我会 FDE",就是课程 D5 批判的 Demo-Debt 的个人版。

⚠ 三层都指向"能力",不指向"收入"。第一层的"买单"是客户愿意为结果续约(你在岗做成的事), 不是"你能收到钱";第三层说的是"你的作品集有了价格标签的依据",不是"你会接到单"。 本课不承诺任何一层能换成多少钱——变现路径见 §6(含接单合规六件套)与 §8 查证纪律。


2. 作品集装配:三套包装(D8 M1 用)

输入:你从 D1 开始攒的 证据/ 文件夹 + 8 件产出。原则:证据 > 描述。

2.0 作品集索引页(一页,必交)

产出 日期 证据链接 一句话价值(含数字)
例:语料报告 D4 <仓库路径 / 云盘链接> 32,400 条原始记录 → 21,800 条可用语料,补 3 类盲区
……(共 8 件)

索引页是第一屏:面试官/老板只看一页的时候,看到的是这张表,不是你的过程。 ⚠ 上表的数字是虚构示范——填你自己的真实运行结果(随手 fde-scope corpus ... 跑一遍就有)。

2.1 求职版(给面试官)

  • 简历段落(3–5 行,句式见第 3 节)
  • STAR 故事 ×3(模板见第 4 节):一个成功、一个失败、一个"当时的取舍"
  • 作品集索引页 + 2 份最能打的产出全文(建议:委托单 + 评估报告)

2.2 内部汇报版(给老板/客户)

  • 一页纸:价值 / 证据 / 下一步要什么(模板见第 5 节)
  • 一页验证记录(D5 产出)作为附件——汇报里每句结论都有出处

2.3 接单版(给潜在付费方)

  • 服务清单(模板见第 6 节):你卖的是"边界定义 + 数据体检 + 语料锻造 + 评估 + 运维交接"这条链路,不是"会用某个工具"
  • 案例页:挑 1 个案例(虚构客户须标注"演示案例")走完全链路,放出证据截图
  • 红线:接单版不得使用真实客户名、真实数据;不得把课程内部资料作为交付物转售

3. 简历段落句式模板(含数字)

骨架:在 <场景> 中,为 <客户类型> 完成 <端到端交付>:从 <N 条脏数据> 锻造出 <M 条可用语料>,<指标> 从 <X> 提升到 <Y>,并以 <Runbook/SLO> 支撑 <上线/交接>;交付 <件数> 件可验证产出。

示例(纯虚构演示数字,禁止直接抄进简历):

为某茶饮连锁客服场景完成 8 天端到端交付:将 32,400 条原始工单锻造为 21,800 条可用语料(补齐 3 类长尾盲区),评估意图准确率由基线 78% 提升至 91%;产出含 SLO 卡与 5 类事件 Runbook 的交接包,通过"凌晨 2 点盲测"。全部结论附可复现命令与证据。

⚠ 这段话里的每一个数字都来自课程虚构案例,是为了让你看清"句式长什么样"。 抄数字 = 造假(答辩第一问就穿帮,且违反 03 §4.1 "诚实标注"一票否决)。 你要做的是把骨架套上你自己跑出来的数字——跑一次 corpus / eval,数字自然就有了。

把"我做了"改成"数据显示"(D8 现场反复练):

弱写法(我做了) 强写法(数据显示)
我做了语料清洗 32,400 条 → 可用 21,800 条(去重 6,100、质量门淘汰 4,500)
我写了 Runbook Runbook 覆盖 5 类事件含回滚步骤,同事盲测独立处理通过
我做了评估 主指标 91%(基线 78%),bad case Top3 均附下一步动作
我做了干系人管理 干系人含 2 位发起人,防住 Sponsor Collapse 风险(写进委托单)

三条纪律:① 每个数字你能在作品集里指到出处;② 没跑过的数字不写;③ 写着"演示/虚构案例"的标注不许删掉。


4. STAR 故事模板(3 个)

故事 素材来源 考的是
一个成功 你最有把握的一天(多为 D4 或 D5) 方法论是否真的会
一个失败 被打回/翻车/指标难看的那天 复盘能力与诚实
一个取舍 二选一的时刻(拒绝需求 / 砍彩蛋 / 选择回滚) 判断力与边界感

模板:

S 场景:<虚构客户 + 一句话业务背景>(1 句)
T 任务:<你要定义/交付什么,成功标准是什么>(1 句)
A 行动:<你做了什么关键决策,为什么这么决策>(2 句)
R 结果:<数字结果 + 证据在哪 + 如果重来会改什么>(2 句)

失败故事特别提示:不要讲"环境不好/客户不配合"式失败——答辩评分表里"复盘深度"一项 明确看"是否指向自己的决策"(03 §5)。模板: "我当时假设了 <X>,证据显示 <Y>,代价是 <Z>,现在的我会先 <做法>。"


5. 一页纸汇报模板(内部汇报版)

# <项目名> 一页纸 · <日期>
## 价值(客户得到什么)
- 一句话结论(含 1 个业务口径数字)
## 证据(凭什么信)
- 主指标 + 基线对比:__ → __(证据:<链接/路径>)
- bad case 收敛:__ 条 → __ 条(Top3 已附动作)
- 验证记录:向 <角色> 演示 <N> 次,接受 <N> 需求 / 拒绝 <N> 需求(理由见附件)
## 下一步要什么(明确 request)
- 决策请求:<继续投入 / 扩大范围 / 进入交接>,需要 <角色> 在 <时间> 前拍板
- 已知风险与不确定项:<如实列出,含缓解动作>

汇报公式(D8 三个概念之一):做了什么 / 证据 / 下一步要什么——一次汇报给一个要决策的问题,不做知识普及。


6. 接单版:服务清单 + 案例页

服务项 交付物 适用信号(客户在说什么) 不适用(诚实说)
定边界工作坊(2–3 天) 委托单:画像/干系人/可度量成功标准 "我们想上 AI 但说不清要什么" 客户已有明确验收标准
数据体检(3–5 天) 体检报告:字段/PII/覆盖度/明确结论 "我们数据很多,应该能用" 数据已在客户内部治理成熟
语料锻造(1–2 周) CorpusReport + 客户话术 "效果不好,但不想换模型" 缺的其实是业务规则而非语料
评估设计(1–2 周) 评估集 + bad case Top3 + 动作清单 "供应商说 95%,我们不敢信" 客户只要概念验证不计后果
运维化 + 交接(2–4 周) Runbook/SLO/培训/退场计划 "上线了没人会修" ——
完整链路打包 上述全链 + 时间盒(≤14 天集成 / ≤90 天上线 / ≤120 天交接) 有预算、有发起人、要一个 done 无第二发起人 / 只想要"无限试点"

接单纪律:先报"不适用"再报"适用"——敢劝退的乙方才有议价权(对应 07 案例 D 的反面教材)。

6.1 接单前必须齐的"合规六件套"(缺一件就别签字)

这一节是红线,不是建议。本课教你卖的是"专业服务",专业服务的第一次翻车往往不在技术, 在合同。以下六项逐项打勾才接单;任何一项对方不肯给,这笔单宁可不做。

# 件 说什么(白话说) 不给会怎样
1 书面合同 范围、交付物、工期、验收标准、付款节点(含尾款条件)写清楚;口头承诺一律不认 走完活拿不到钱 / 被无限加需求(Scope Creep 的法律版)
2 发票与税 你能开什么票(普票/专票/不开)提前说清;企业客户几乎必须对公 结算卡住,甚至被认定为不合规经营
3 IP 与源码归属 交付物(报告/Runbook/配置/脚本)归谁、你能不能把它当案例展示——书面写 你拿自己的作品做作品集反而侵权
4 责任上限 写明"赔偿上限 = 合同金额"之类条款;AI 交付有概率性,不要签无限责任 一次误判可能赔到倾家荡产
5 数据条款 数据所有权归客户;你只在授权范围内处理;PII 不上传、不进第三方、不进群(与 08 §11 一致);项目结束按约定删除或归还 直接触犯个保法/数据安全法,个人担责
6 验收与退出 验收主体是谁、多久内算验收通过(默示验收);什么情况可终止、终止后怎么结算 收不到"完成"信号,项目无限拖 —— 个人版的 Infinite Pilot

给零基础同学的一句实话:你第一次接单大概率是小活、熟人、口头。越是这种单,越要把 六件套里的 1(范围)/ 4(责任上限)/ 5(数据条款) 用微信文字过一遍并留下对方确认—— 不是不信任朋友,是保护这段关系。


7. 面试题库 20 题(含答辩抽查与答案骨架)

用法:D8 模拟面试时讲师/助教从这里出题(每人 ≥3 题,02 D8); 答辩评委随机抽取(03 §5)。 ⭐ = 高频四题,07 §3.7 要求优先抽。答案骨架与 docs/fde_playbook.md 的"面试追问防御"表一致。

要往深处问时(针对资深岗、或学员答得太顺):底稿 00-FDE方法论历史与原理.md §5 另有 8 条追问 (Echo 与 Delta、80/95/99、为什么不少产品经理、Skill + 连接器、双向蒸馏等),带完整回答要点, 出题时挑 1–2 题加难度即可。术语不熟时不建议用深水区题——先让学员把 A–E 组答扎实。

A 认知与角色(1–4)

# 追问 考点 回答骨架(要点)
1 ⭐ FDE 和传统实施工程师的区别? 世界观 AI 原生:不是装软件,是让 Agent 在客户业务里跑起来并持续进化;懂模型、懂语料、懂评估
2 FDE 和售前 / 客户成功 / 算法工程师的区别? 角色边界 售前管签约、客户成功管续约、算法管模型;FDE 管"从模糊抱怨到可验收交付"的整条链路,且要在客户现场定义 done
3 18 阶段里你觉得哪一站最容易出事?为什么? 实战理解 任选一站但要给出具体失败模式(例:Phase 2 成功标准写成形容词 → 后面全返工);别答"都重要"
4 说出 3 个你认识的反模式与预防动作 方法论 例:Sponsor Collapse(≥2 发起人)、Infinite Pilots(书面 done + 时间盒)、Demo-Debt(真实数据原型)

B 定边界与干系人(5–8)

# 追问 考点 回答骨架(要点)
5 客户说"先做个 demo 看看",你怎么回? 会不会被带着跑 可以演示,但先问"看到什么算满意";把 demo 目标写进委托单,避免用漂亮 demo 换模糊承诺
6 项目只有一个发起人,怎么办? Sponsor 风险 写明"第二发起人待确认"为风险项,推进中主动建立第二关系(VP/使用部门负责人);不确认不进入重投入阶段
7 客户的成功标准和你们内部的不一致,怎么办? 验收主体 以客户能自己验收的口径为准;不一致处书面列出并让客户拍板,不做默认假设
8 客户中途不断加需求,怎么处理? Scope Creep 先记录到"被拒绝/待评估需求"页(D5 产出物);用成功标准做筛子,超范围的走变更流程,不做口头承诺

C 数据与语料(9–12)

# 追问 考点 回答骨架(要点)
9 ⭐ 客户数据质量极差怎么办? 接数据的诚实 Connector 先 schema 探测 + 样本预览;CorpusReport 明确告诉客户"能用多少、缺什么";给"能做/不能做/有条件能做"的结论,不写待定
10 补盲/合成的样本能信吗?怎么向客户证明? 语料工程 三道关:策略约束 → 质量门控打分 → 覆盖度验证确实填了盲区;与规则样本同一质量门与缺口上限,逐条打分入库,可区分来源;合成比例如实报告
11 客户不给数据 / 数据里有 PII 怎么办? 红线意识 不拿到数据也能先做边界工作(Zone A 先行);PII 字段列清单、脱敏或"根本别拿";数据不落第三方、不上传、不进群
12 指标 91% 很好看——它回答的是客户的哪个问题? 业务口径 主指标要配业务口径(采纳率/转人工率/错误预算内可用性);说不清对应关系就说明评估没做完

D 技术现场与合规(13–16)

# 追问 考点 回答骨架(要点)
13 ⭐ 客户现场没有外网 / 不想用外部 LLM 怎么办? 降级路径认知 全链路规则路径可跑,LLM 纯可选(无 key 自动降级、失败自动回退);air-gap 场景有部署路径(本地模型/离线镜像),遥测出网是 gate blocker 不是默认动作
14 ⭐ 多租户数据泄露怎么防? 隔离设计 三层隔离:Docker 沙箱 + collection + 权限引擎(BYPASS 都绕不过);凭证只走环境变量,绝不落盘
15 技术选型为什么这么做?(以 Agent 框架为例;也常问"你平时用哪些工具") 架构判断 选能提供框架级能力的(沙箱/权限引擎/HITL/事件系统),而不是样样自造;给出"自造需要几周"的代价对比;客户已有的工具栈(编码 / 办公 Agent)不要求替换——只叠"流程与门禁层",原则是互补而非替换(01 §6.4)
16 没有标注数据/评估集,怎么验证效果? 评估设计 从真实数据里切评估集(不用策展数据);小样本先跑通闭环再谈规模;bad case 驱动迭代,用现成样本的分布盲区做定向补样

E 运维与交接(17–20)

# 追问 考点 回答骨架(要点)
17 上线后指标突然暴跌,你的前 3 步? 应急纪律 ①先看告警与监控定位层级(数据漂移/模型退化/上游依赖)②按 Runbook 处置、必要时先回滚 ③升级路径通知责任人与客户,事后补复盘
18 模型悄悄变差了,谁先发现? 概率性退化 漂移监控 + 定期评估回路(飞轮:人工覆盖 = 最高质量标注 → 周期增量优化);没配监控的就是"坏在用户先发现"
19 客户不接受 SLO,觉得是在推卸责任,怎么讲? 沟通 SLO 是承诺的量化:"99.5% 是保证,不是免责";错误预算是"允许出错的额度",超预算即触发投入决策——用外卖超时赔付类比
20 交接后客户说"先别走,你再支持三个月"——怎么办? 退场时间盒 引用退场计划里的支持安排与终止条件(30/60 天梯度);可以加支持窗口,但必须换到书面范围与付费结构;"无限试点"是行业最贵的反模式

自测要求(06 §11):20 题中至少自测 ≥10 题并写下答案要点;答案不会写就回作品集里找对应产出。 诚实红牌:任何一题答不出来,正确姿势是"这块我还没做过,我会先 <查/验证方式>"——硬编答案比不会更减分。


8. 薪资与市场信息:查证纪律

运营与学员共用本节。这是 08 §11 那句"薪资数据必须带来源与日期"的执行细则。

  1. 本课程不提供薪资数字、不承诺收入。任何一次对外引用(招生页/直播/群/作品集)都必须满足:

  2. 引用格式(缺一不可):

    <区间> | 来源:<发布方名称 + 链接> | 采集日期:<YYYY-MM-DD> | 口径:<岗位名称/城市/经验段/样本量>
    
  3. 可信来源优先级:企业官方招聘页面(在招 JD 的公开薪资区间)> 招聘平台公开薪酬报告 > 行业报告。 匿名爆料不做唯一来源。

  4. 必须标注的局限:FDE 在国内是新岗位,公开样本少、口径杂;同一 title 在不同公司差异极大; JD 区间 ≠ 实际 offer。

  5. 禁止句式:"学完就能拿 XX K""FDE 平均月薪 XX""包涨薪"——招生合规零容忍(见 08 §11)。


9. 结营包(D8 你带走什么)

# 内容 说明
1 电子结业证书 A/B/C 级判定见 03 §6;备注栏如实记录补交/延期/豁免
2 作品集(8 件 + 索引页) 归学员所有;对外展示需本人书面授权(03 §8)
3 三套包装 求职版 / 内部汇报版 / 接单版(第 2 节)
4 面试题库自测答卷 ≥10 题的答案要点(D8 交付物)
5 校友群与复训入口 规则见 08 §9(B 级旁听、C 级重读、复训须当"摆渡人")
6 课后 72h 动作 对真人讲一次作品集(同事/朋友均可),把"讲得清"变成事实而非自我感觉(05 §4)

A 级追加权益(03 §6):优秀作品展 + 讲师签名的表现信(基于你的 8 件产出与答辩表现做事实陈述——写了什么、证据在哪、表现如何;不是内推、不承诺录用或面试机会)+ 助教申请通道(08 §8)。

9.1 求职包三件套(结营即用,仍不承诺结果)

对症 13 §6 #4「没有就业服务」里可补的那部分: 我们不做就业服务——不代投简历、不对接雇主、不承诺录用;但"投递那天要用的东西", 可以在结营时做成一套完整、可自检的组合。

# 件 落在哪 完成标志(可自检)
1 求职版作品集(索引页 + 2 份最能打的产出全文) §2.0、§2.1 一页能讲完;每个数字都能指到证据(§10 反模式自查)
2 面试题库自测答卷(≥10 题,含答案要点) §7 每题挂的是自己的案例,而不是背下来的通用答案
3 双版本口述稿(30 秒电梯版 + 3 分钟 STAR 版) §4 STAR、§5 一页纸 对真人讲过一次并收到至少一条具体反馈(05 §4)

交付时点是 D8 结营前,与作品集评级同时发生(03 §6)。缺件不阻碍结营, 但评议时会指出缺的是哪一件,并如实写进证书备注栏(15 §1.1)。

9.2 内推池规则(同学之间的通讯录,不是我们的业务)

先说清楚它不是什么:不是就业服务、不是猎头、不是简历代投; 不收费、不筛选、不背书、不承诺成功率——03 §6 的 A 级表现信也仍然"不是内推"。

内推池只在校友群(08 §9.2)里运转,规则写进群置顶:

规则 说明
只转发公开可查的岗位链接 转原 JD 链接 + 采集日期;不二次加工、不改写职责与薪资
内推由学员本人发起 我们提供"一本人力通讯录"和一群同学;推不推、推谁,是同学之间的个人决定
不收任何费用、不做居间 向企业或学员收费即变猎头(涉及资质与责任),本课程不进入该业务
学员所在企业有内推通道时 可把公开 JD 链接发到校友群;JD 原文不进仓库、不进作业包(含企业名与联系方式)
不统计、不对外引用 不统计"内推成功率",不把个案当成果对外宣传(15 §3.3 发布纪律)
过期即删 群内岗位链接超过 90 天由运营清理;不做"长期有效"的存量岗位池

一句话:我们把人连起来,但不把结果包下来。这条界线同时也是 13 §6 #4 的答案—— 就业服务我们没有,可核对的替代品是上面这套三件套 + 一个不收费的通讯录。


10. 变现反模式(别做)

反模式 症状 解药
作品集灌水 塞课程笔记、截图流水账 只放 8 件产出 + 索引页;每件能指到证据
数字无出处 "提升了 30%" 但指不出来源 答辩/面试前做一遍"出处点名"演练
证书收藏家 用证书数量代替能力证据 面试官看的是案例,不是徽章
过度包装 把虚构案例说成真实项目 标注"演示案例"不丢分,被拆穿才丢分
无限等待 "等我再准备充分点再投" 72h 内先讲给一个真人听;用反馈驱动迭代

11 · 工具与环境准备

11

course-level-1/11-工具与环境准备.md

目标:30 分钟内,让一台普通电脑(8GB 内存即可)跑通 D1 冒烟链路。 全程不需要:API key、Docker、GPU、AgentScope、梯子、管理员权限。

相关文档:06 G0 入学门|02 D1 降级路径|03 §7 第 4 条 PII 红线


1. 你要准备什么(以及不需要什么)

1.1 需要

项 要求 说明
电脑 macOS / Windows 10+ / Linux,8GB 内存 2018 年后的机器基本都行
Python ≥ 3.11 唯一硬门槛,§2 教你怎么装
网络 能访问 PyPI(或公司镜像源) 只在"装包"时需要一次
磁盘 几百 MB(虚拟环境) 比 Docker 镜像轻得多
时间 首次安装约 30 分钟 提前装;开营当天才装 = 高风险

1.2 不需要(重要)

常见误解 事实
"得先买 API key 吧?" 不用。全链路有零 key 路径(规则模式),LLM 只是可选加速器,见 §4
"要装 Docker 吧?" 不用。课程全部命令在本机直接跑
"要不要装 AgentScope?" 不用。[dev] 里不含它;真实运行时是进阶内容
"要 GPU 吗?" 不要。不训练模型,只做语料工程与评估
"公司电脑没管理员权限?" 基本可以——虚拟环境装在用户目录下,见 §5.2
"要科学上网吗?" 不要。装包走国内镜像源即可(§3.2)
"我平时用 Qoder / Trae / CodeBuddy 写代码,要卸载吗?" 不用。课程只要求你用 fde-scope 走流程与门禁;写代码继续用你顺手的工具(分工见 01 §6.4)
"公司已经买了豆包工作 / 千问办公 / WorkBuddy 这类办公 Agent 呢?" 照常用,而且是加分项——现场本就不该要求客户换工具;你交付的是流程与证据,不是"你用了哪个工具"

2. 安装(约 30 分钟)

2.0 第 -1 步 · 打开终端(真·零基础必读,1 分钟)

后面所有命令都要在终端里敲。终端就是一个"用打字代替点鼠标"的窗口,别怕,本课你只需要三个动作:打开它、粘贴一行、按回车。

怎么打开(选你系统那一行照着做):

系统 打开方式
macOS 按 ⌘ + 空格 打开聚焦搜索 → 输入 终端(或 Terminal)→ 回车;或 启动台 → 其它 → 终端
Windows 点开始菜单 → 直接输入 PowerShell → 打开「Windows PowerShell」(不用管理员身份也行)
Linux 桌面右键 → 「打开终端」,或快捷键 Ctrl + Alt + T

怎么执行一条命令(全文通用,以后不再重复解释):

  1. 复制文档里的命令(选中 → ⌘C / Ctrl+C);
  2. 切到终端窗口,粘贴——macOS 是 ⌘V;Windows 是 Ctrl+V,或在窗口里点右键(会自动粘贴);
  3. 按 回车(Enter),等它跑完(命令结束的标志是重新出现一行等你输入的提示符)。

📌 三条纪律(先记住,能省 90% 的慌乱):

  1. 一次只贴一段——文档里每个代码块代表"一次操作",别把两个代码块一起贴进去。
  2. 终端里 Ctrl+C 不是复制,是"中止当前命令";复制粘贴用上面的方法。
  3. 报错不可怕,先读最后一行——最后一行通常就是原因(比如 command not found = 这个软件没装)。看不懂就把整屏截图发到学习群。

还认不全"终端 / 命令 / 参数 / 路径 / PATH"这些词?先花 2 分钟扫一眼 12 §1.0「电脑基础词」表格,全部用大白话解释了。

2.1 第 0 步 · 装 Python ≥ 3.11

先自检——在终端里(Windows:PowerShell),运行:

python3 --version
  • 显示 3.11 或更高 → 跳到 §2.2。
  • 显示 3.10 或更低 → 按下面方式装新版本。
  • 提示 command not found / 不是内部或外部命令 → 说明没装,按下面方式装。
系统 方式
macOS 官网 python.org 下载安装包(不要用系统自带的 python3);或用 brew install python@3.12
Windows 官网 python.org 下载安装包,安装时务必勾选 "Add python.exe to PATH"
Linux sudo apt install python3.12 python3.12-venv(Ubuntu)或发行版对应命令

已有 conda / uv 的同学:只要满足 Python ≥ 3.11 且能执行 §2.4 的安装命令,也可以用它们,后续命令不变。

2.2 第 1 步 · 拿到课程仓库

方式 A(推荐,便于以后更新):

git clone https://github.com/ai-guru-global/fde-scope.git
cd fde-scope

方式 B(不会 git):在仓库页面点 Code → Download ZIP,解压后进入文件夹即可。

⚠ 之后所有命令都必须在仓库根目录下执行(能看到 pyproject.toml 和 examples/ 的目录)。90% 的"文件找不到"都是这里出的错。

2.3 第 2 步 · 创建虚拟环境

python3 -m venv .venv

然后激活(每次新开终端都要做一次):

系统 激活命令
macOS / Linux source .venv/bin/activate
Windows (PowerShell) .venv\Scripts\Activate.ps1
Windows (CMD) .venv\Scripts\activate.bat

激活成功的标志:命令行提示符最前面多了 (.venv)。

为什么要虚拟环境?把课程依赖装进项目自己的"抽屉"里,不弄乱你电脑上的其他 Python 项目,也不需要管理员权限。

2.4 第 3 步 · 安装依赖

pip install -e ".[dev]"

等价写法 python -m pip install -e ".[dev]"(更不容易装错解释器,推荐)。

解释一下这行命令:

  • -e = 可编辑安装,仓库代码改动能立即生效;
  • [dev] = 核心层 + 测试 + Web 控制台(FastAPI/uvicorn)一次装齐——课程要用的都在里面。

期望结果:末尾出现 Successfully installed ...。

2.5 安装成功的判定

三个信号,缺一不可:

  1. 提示符有 (.venv);
  2. pip install 末尾显示 Successfully installed;
  3. 运行 fde-scope --help,能看到 connect / corpus / eval / web 等命令列表。

如果第 3 条报 command not found,改用 python -m fde_scope.cli --help 验证——两者等价,后者更稳。


3. 冒烟测试与故障排查

3.1 冒烟五条命令(与 06 G0 同源)

在仓库根目录、(.venv) 已激活的状态下依次执行:

# 1. Python 版本
python3 --version
# 期望:Python 3.11 或更高

# 2. 命令可用
fde-scope --help
# 期望:打印命令列表(connect / corpus / eval / deploy / web / engage / gate …)

# 3. 看数据(学员 D1 产出 1 的一部分)
fde-scope connect --type csv --source examples/quickstart_csv/sample_tickets.csv
# 期望:schema 表(含 PII? 列)+ rows≈… · categories=… · channels=…
#       + 样本预览 + "✅ Sample extracted → samples/preview.json"

# 4. 造语料(学员 D1 产出 1 的另一半)
fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --out reports/corpus_report.html
# 期望:PII 脱敏条数 → 去重+质量门淘汰数 → "✅ Corpus forged: N real + M synthetic = T total"
#       + 覆盖缺口列表 + "📊 Report → reports/corpus_report.html"(同时生成 corpus_report.json)
# 打开报告:在文件管理器(访达 / 资源管理器)里双击 reports/corpus_report.html
#          —— 会自动用浏览器打开(报告是网页文件,不用装任何东西)

# 5. 控制台(可选但强烈建议)
fde-scope web
# 期望:🚀 Launching http://127.0.0.1:8080 —— 浏览器打开即可

必做:为后续所有练习准备示例数据(D1 的 blocker 截图、D2 的案例研读、D4 的 KPI 都靠它):

python examples/seed_mock_engagements.py

会向 .fde_scope/engagements 写入 10 个完全虚构的客户案例(脚本内附免责声明),可在 Web 控制台里浏览门禁记录、现场记录与技能库;重复执行安全(幂等)。

造完之后马上验一次(这一步顺便帮你确认数据目录找对了):

COLUMNS=200 fde-scope engage list
# 期望:10 行,id 形如 eng-teaverse-ticket-seed01 / eng-adnova-ticket-seed06 …

⚠ 两个小坑,先知道了就不会慌:

  • 不加 COLUMNS=200,id 列会被截断成 eng-adnova-t…,看着像坏了,其实只是终端宽度不够。
  • 必须在仓库根目录跑。数据目录靠"当前目录下有没有 .fde_scope/"定位;在别的目录跑不会报错,只会显示 No engagements yet.——遇到这句先 cd 回仓库根目录,而不是重新 seed。

10 个档案分别适合练什么,见 12 §3.2「拿来就能抄的档案 id」。

到此为止 = 环境全部就绪。 后面所有天的内容都只用到上述命令的变体。

3.2 故障排查表

90% 的问题在下表里。按"现象"对号入座;处理完仍不行 → §3.3 环境急诊室。

# 现象 最可能原因 处置
1 command not found: fde-scope 虚拟环境没激活 重新执行 §2.3 的激活命令(提示符应出现 (.venv))
2 No module named fde_scope 装到了别的 Python 环境 激活 venv 后重跑 pip install -e ".[dev]";用 python -m fde_scope.cli 验证是否指向了当前环境
3 No such file or directory: examples/... 不在仓库根目录 cd 回仓库根目录(ls 能看到 pyproject.toml)
4 pip: command not found pip 不在 PATH 用 python3 -m pip install -e ".[dev]"
5 error: externally-managed-environment 系统 Python 受保护(macOS Homebrew / Ubuntu 新版) 不要加 --break-system-packages;回到 §2.3 建 venv
6 pip install 超时 / SSL 报错 网络到 PyPI 不通 换国内镜像源:python -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple,重试;公司网络见 §5.2
7 Windows 终端中文乱码 / UnicodeEncodeError 终端编码不是 UTF-8 PowerShell:$env:PYTHONUTF8="1";CMD:set PYTHONUTF8=1;或 chcp 65001
8 报错里有 docker / agentscope 字样 混入了进阶路径 课程路径不需要它们;逐字比对 §3.1 的命令重跑
9 fde-scope web 启动失败:端口被占用 8080 被别的程序占了 换端口:fde-scope web --port 8081
10 Web UI needs the 'web' extra 装的是精简版 pip install -e ".[web]"([dev] 里已含,重装 [dev] 也行)
11 Refusing to bind non-loopback host 想把控制台开给局域网看 默认只绑本机是安全设计;确需局域网演示见 §6.5
12 任何 Python 版本 < 3.11 的报错 装的是旧 Python 回 §2.1 装新版本,再重建 venv
13 fde-scope engage list 显示 No engagements yet.(什么错都没报) 不在仓库根目录——数据目录按"当前目录有没有 .fde_scope/"定位,换目录就找不到了 cd 回仓库根目录(seed 过的档案就回来了,不用重新 seed);或从别处用 FDE_SCOPE_HOME=<仓库绝对路径> fde-scope …
14 engage list 的 id 带省略号(eng-adnova-t…) 终端宽度不够,表格列被截断 命令前加 COLUMNS=200:COLUMNS=200 fde-scope engage list
15 跑 gate check / advance 后凭空多出一张 skill-xxxx 草稿卡 设计如此:门禁阻塞被自动沉淀成知识(飞轮) 预期行为,不是污染。fde-scope skill review 看待审队列,fde-scope skill archive <skill-id> 清掉不想要的

通用三步自救法:① 读报错最后一行(原因永远在最后一行);② 逐字比对 §3.1 命令(路径/拼写);③ 确认 (.venv) + 仓库根目录这两个前提同时成立。

3.3 环境急诊室(三级求助,与 06 §7 一致)

Level 0 · 自助     → §3.2 排查表 + 逐字比对命令
Level 1 · 同学     → 群内提问(带 06 §7 四要素:想问什么/试了什么/期望什么/实际报错+截图)
Level 2 · 助教 1v1 → 仍未解决 → 进"环境急诊室"分组
Level 3 · 保底方案 → 助教共享屏幕代跑、你口头指挥 —— 照样算你完成,不影响门禁

底线:环境问题绝不劝退。 课程所有门禁只考"你理解了什么",不考"你电脑多干净"。


4. 零 key 路径与 LLM 可选配置

4.1 默认:零 key 规则路径

不配置任何环境变量时,所有核心功能照常工作,走确定性规则路径:

能力 零 key 时的行为
数据体检(connect) ✅ 完整可用
语料锻造(corpus) ✅ 完整可用(规则合成 + 规则质量评分)
评估(eval --agent mock) ✅ 完整可用(规则回复器)
Runbook / 交接(handoff) ✅ 模板路径可用
Web 控制台(web) ✅ 完整可用(含看板、门禁、报告浏览)

所以:没有 API key 完全不影响你过 G0–G8。 这是本课程相对其他 AI 课的底气——现场客户经常不给外网,FDE 必须习惯"规则先行"。

4.2 什么时候才需要 key

只有三个入口在无 key 时会明确报错(exit 2)并提示你配置,其余命令静默走规则模式:

  • corpus --llm(LLM 合成补盲样本)
  • eval --agent mimo(用 LLM 充当被评测的客服 Agent)
  • handoff --llm(LLM 生成 Runbook 初稿)

课程中这三项都是可选演示,不是任何门禁的必需项。

💡 先别急着配 key:8 天里你不需要任何 key 就能拿满 G0–G8。 只有讲师演示 LLM 加成、或你自己想听"真模型"的声音时才需要——到那时 由带教在课上统一发放一个仅限本期演示用的临时 token(不找讲师私下要, 也不要用自己公司的 key 练手)。所以 §4.3 现在跳过也没关系,标记一下 待 D4 演示前再回来看即可。

4.3 两种配置方式(任选其一)

方式 A · 小米 MiMo Token Plan(讲师在课上发放,仅教学演示用):

export FDE_SCOPE_MIMO_API_KEY="tp-..."     # tp- 前缀,与按量付费 sk- 不通用
# 以下两项可省略(已是默认值):
export FDE_SCOPE_MIMO_BASE_URL="https://token-plan-cn.xiaomimimo.com/v1"
export FDE_SCOPE_MIMO_MODEL="mimo-v2.5-pro"

方式 B · 任意 OpenAI 兼容端点(vLLM / OpenAI / DeepSeek / 本地 Ollama…):

export FDE_SCOPE_LLM_BASE_URL="http://localhost:11434/v1"
export FDE_SCOPE_LLM_API_KEY="sk-..."
export FDE_SCOPE_LLM_MODEL="qwen3:14b"     # 可省略,默认 gpt-4o-mini

两种都配时,方式 B 优先。

Windows 上把 export X=Y 换成:PowerShell $env:X="Y";CMD set X=Y(仅当前窗口有效)。

4.4 凭据纪律(红线,与仓库 AGENTS.md 一致)

  1. key 只从环境变量读——不要写进任何文件(包括 .env、笔记、YAML)、不截图、不进录屏、不进群。
  2. 报告、清单、engagement JSON、日志里永远不会有 key(工具本身也不会写)——如果哪天你在文件里看到了 key,那一定是手写进去的,立刻删掉并检查有没有提交到 git。
  3. 公司环境里用 key:先确认公司允许把哪类数据发往该端点(§6.6)。

4.5 失败自动回退

配了 key 也不怕坏:所有 LLM 入口都是失败自动回退规则路径——网络错误、坏 JSON、额度用尽都不会中断流水线,最多是"这次没有 LLM 加成"。现场演示前建议主动拔网线跑一遍,感受降级行为(面试 Q14 会考)。

4.6 验证 key 是否生效

fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --llm --out reports/corpus_report_llm.html
  • 生效:输出里合成样本量明显多于纯规则路径,报告 JSON 中 trace 可区分来源(synthesize:llm)。
  • 未生效:LLM disabled ... falling back to rule-based mode——回 §4.3 检查变量名拼写与终端窗口(新开窗口需重新 export)。

5. 按人群的环境方案

5.1 个人学习(默认方案)

照 §2 走一遍即可。建议开营前 3 天装完,留出排错余量。

5.2 公司电脑(受限环境)

限制 对策
无管理员权限 §2.3 的 venv 装在用户目录,不需要管理员权限
必须走公司代理 pip install --proxy http://<代理地址>:<端口> -e ".[dev]";或让 IT 配好 pip config
内网镜像源 python -m pip config set global.index-url <公司镜像地址>(找 IT 要)
完全离线(air-gap) 提前 3 天找助教要离线安装包:在有网机器上 pip download "./.[dev]" -d wheelhouse,拷贝到目标机后 pip install --no-index --find-links=wheelhouse -e ".[dev]"。⚠ 别开营当天试
公司安全软件拦截 报错截图发群;必要时走 §3.3 保底方案

5.3 企业内训(团队采购)

  • 统一镜像 / 统一 Python 版本 / 统一镜像源,由 IT 或助教提前部署;
  • 建议开营前一周发本文件给学员自查,收集"已装好"接龙(08 §3 T-1 清单);
  • 现场备 2–3 台预装好的备用机——环境事故不能占用课堂时间。

5.4 讲师环境(提前 24 小时冻结)

  • 在干净环境完整跑一遍 D1 冒烟链路(本文件 §2–§3 全部命令);
  • 冻结演示环境:关掉自动更新、固定窗口布局、清空历史记录与可疑数据;
  • 按 05 §1 的清单逐项过;演示数据只用虚构案例(examples/seed_mock_engagements.py)。

6. 数据合规与 PII 红线(不可协商)

本节与 03 §7 第 4 条、08 §11 同源。D2 开课 10 分钟内会逐条讲;违规 = 数据合规事故(03 §8 一票否决项)。

6.1 三条红线

  1. 只用两类数据:课程自带虚构数据,或你自己已脱敏并经公司同意的数据。
  2. 真实客户名与 PII 不进群、不上传——包括作业、截图、提问里的粘贴内容。
  3. 不进任何第三方工具——在线标注平台、在线 JSON 格式化、网盘、聊天机器人,一律不发。

6.2 PII 识别清单(练习前过一遍)

姓名 / 手机号 / 邮箱 / 身份证号 / 地址 / 车牌 / 银行卡 / 订单号 / 设备序列号 / 门禁记录 / 聊天记录里的可定位信息……

判断标准一句话:这条信息能不能定位到具体某个人? 能 → 按 PII 处理。

6.3 工具怎么帮你兜底

  • connect 输出的 schema 表有 PII? 列,可疑字段标 ⚠;
  • corpus 报告显示 PII entities masked 条数——别把这当免罪符:自动脱敏是辅助,判断责任在你。

6.4 脱敏四步法(自用数据时)

步 动作 例
1 拿掉 与任务无关的 PII 直接删列 客户表里的身份证列
2 替换 保持格式、换掉内容 张伟→客户A,138****1234→13800000001
3 哈希 需要保留关联性时 用户ID → u_3f9a…(同人同哈希)
4 保真 分布、长度、语言风格不变 脱敏后仍能被质量门正常处理

6.5 上传与展示边界

  • fde-scope web 默认只绑本机 127.0.0.1,这是安全设计;
  • 需要局域网演示(给同事看):必须两步同时做——FDE_SCOPE_ALLOW_REMOTE=1 + 设置 FDE_SCOPE_API_TOKEN(控制台 API 的访问令牌,只从环境变量读,不落文件/日志/响应);演示完立即关掉;
  • 截图前 3 秒检查:有没有真实姓名 / 客户 logo / 域名 / 工单编号露在画面里。

6.6 LLM 边界

  • 使用 --llm 时样本内容会发往你配置的端点——脱敏之后才可以;
  • 公司数据未经许可不得发往任何外部端点(含 MiMo / OpenAI / 在线大模型);
  • 客户只要 air-gap → 直接走 §4.1 零 key 规则路径,全链路不受影响。

6.7 违规处置(与 08 §11 第 3 条一致)

群内一旦出现真实客户名 / PII → 立即撤回 + 私聊 + 记录合规日志;该学员产出退回、替换为脱敏数据重做。情节严重者记入证书备注。

6.8 提交前自检五问

  1. 这份产出里的数据,我能说出"它是虚构的"或"它脱敏过且公司同意"吗?
  2. 截图里有没有任何能定位真人的信息?
  3. 群里发的报错原文,有没有粘贴到真实数据?
  4. 用 --llm 之前,样本脱敏了吗?公司允许发这个端点吗?
  5. 本地演示暴露面(--host)恢复默认了吗?

7. FAQ

问 答
没有 API key 能学吗? 能,而且推荐先无 key 学。全链路零 key 可跑;D4 会对比有/无 key 的差别与回退行为
Python 装 3.13 行不行? 行,只要 ≥ 3.11。课程与仓库在 3.11/3.12 上验证最充分
用 WSL 行不行? 行,按 Linux 步骤走
装完占多大空间? 几百 MB(venv 目录),删除 .venv 即完全卸载
公司电脑装不了怎么办? 先走 §5.2;仍不行 → §3.3 保底方案(助教代跑,口头指挥),不影响过门禁
装坏了我能重来吗? 能。删掉 .venv 目录,从 §2.3 重来——整个过程可反复、无副作用
为什么要用虚拟环境而不是直接 pip install? 不污染系统 Python、不需要管理员权限、卸载干净(删目录即可)
fde-scope 和 python -m fde_scope.cli 有区别吗? 没有,等价。前者是命令入口,后者在 PATH 出问题时更稳
课程会用到 Docker / AgentScope 吗? 不会。它们是仓库里部署与运行时层的进阶能力,不在 G0–G8 任何一条里
我可以拿公司真实项目练吗? 必须先脱敏并经公司同意(§6.1);拿不准私聊讲师走豁免

下一步:环境就绪后回 06-学员手册与作业包.md 从 Day 1 任务卡开始。 术语不认识 → 12-附录-术语表与模板库.md 速查。

12 · 附录:术语表与模板库

12

course-level-1/12-附录-术语表与模板库.md

用途:全课程唯一真相源(Single Source of Truth)的查询页。遇到三种情况翻这里—— ① 听到一个英文缩写不懂 → §1 术语表;② 要交东西但不知道格式 → §2 模板库(复制即用); ③ 知道要干什么但不知道敲什么命令 → §3 概念→命令映射。

配套:06 是执行步骤("今天做什么"),本文件是查字典("这是什么、长什么样")。 关联:00 历史·原理·方法论底稿(§1.7 收录其专有词)· 03 门禁判分表 · 11 环境与合规 · 10 变现与结营包。

诚实提示:本文件全部模板中的客户名、数字均为虚构演示(与 examples/seed_mock_engagements.py 一致)。 真实使用时请替换为你自己的场景,禁止填入真实客户名与真实 PII(红线见 11 §6)。


0. 怎么用这份附录(30 秒版)

你的处境 去哪个
"客户在说什么?我该出什么?" §1.1 角色与干系人 + §2.1 委托单
"数据给了我,第一件事做什么?" §2.2 数据体检报告
"老板/客户听不懂我在说什么" §2.3 客户话术(≤200 字,零术语)
"怎么证明它真的变好了?" §2.4 测试集 + §2.5 bad case + §2.6 验证记录
"上线了谁值班?挂了怎么办?" §2.7 SLO 卡 + §2.8 Runbook + §2.9 值班交接卡
"怎么把东西交出去、然后我撤?" §2.10 交接包 + §2.11 验收清单 + §2.12 退场计划
"8 天了,我怎么讲出去?" §2.13 技能卡 + §2.14 作品集索引 + §2.15 D8 四件套
"这个命令到底怎么敲?" §3 概念→命令映射
"面试官问我'为什么是现在',我答不上来" §1.7 历史与原理词 + 00 §5 常见追问 8 条
"这个词是 FDE 独有的吗?谁发明的?" §1.7(标注了每个词在 00 里的出处)

1. 中英术语表

每条给三样东西:英文(客户和外企面试会这么说)、白话解释(说给非技术同事听)、课程位置(在哪天学到)。 学会术语不是为了显摆——是为了不被术语骗。凡是只给英文缩写不给白话解释的供应商,先打个问号。

1.0 电脑基础词(完全没碰过命令行也能看懂)

这一节是给零基础同学的。学过就用不着,卡住了回来查。 后面所有章节出现的这些词,含义以本表为准。

词 白话解释 在本课哪里会遇到
终端 / Terminal / 命令行 一个只能打字、不能点鼠标的黑窗口。你在里面敲一行指令,电脑执行完把结果打回给你 D1 起,全程
命令 / Command 你在终端里敲的那一行字。如 fde-scope connect ...。一行就是一件事 全程
参数 / 选项 / Flag 命令后面那些 --source、--out 开头的部分。它们是"这道指令的附加说明",比如数据在哪、结果存哪 全程
工作目录 / 当前目录 终端"此刻站在哪个文件夹里"。同一行命令,站的位置不同,结果可能不同 D1 装环境;见下方"路径"
cd change directory,换工作目录。cd fde-scope = 进入 fde-scope 这个文件夹 D1 装环境
路径 / Path 一个文件或文件夹的完整地址。examples/quickstart_csv/sample_tickets.csv 就是一条路径 全程
绝对路径 / 相对路径 绝对路径从根 / 写起(/Users/你的名字/fde-scope),走到哪都不会错;相对路径从当前位置写起(examples/...),换了位置就找不到 §3.2 与 §3.5 的"找不到数据"问题都源于此
PATH 一个系统环境变量,里面记着"敲命令时去哪些文件夹里找程序"。fde-scope: command not found 十有八九是它没包含你的虚拟环境 11 §3.2 第 1–2 行
虚拟环境 / venv 一个独立的 Python 小盒子:盒子里的软件包和系统其他部分互不干扰。装错了、装乱了,删掉盒子重来即可 11 §2.3
CSV 一种最朴素的表格文件:纯文本,逗号分隔,第一行是列名,之后一行是一条记录。用 Excel 也能打开 D3 数据体检
JSON 一种结构化的文本格式,用 {"键": 值} 的写法表达数据。本课的报告文件(corpus_report.json)就是它 D4 起
JSONL 一行一个 JSON 的变体(JSON Lines)。不用整个文件包成一个大数组,读到坏行也不影响其他行——所以测试集/语料用它 D4 语料、D5 测试集
Markdown / .md 用纯文本记格式的写法:# 是标题、**粗体** 是加粗。本课程全部文档、以及你的作品集说明都是它 D1 起
文本编辑器 / 记事本 用来写 .md、.jsonl 这类纯文本文件的工具:Windows 自带「记事本」,macOS 自带「文本编辑」,装过 VS Code 更顺手。保存时有两个坑:扩展名别丢(见 §2.4 提醒)、文件存到命令能找到的位置 D5 造测试集
文件管理器 / 访达 / 资源管理器 平时"翻文件夹、双击打开文件"的那个窗口(macOS 叫访达,Windows 叫资源管理器)。本课生成的 HTML 报告就在里面双击打开——会自动用浏览器显示 D1 起
截图 把屏幕画面存成图片(作业证据反复要用):macOS ⌘ + Shift + 4 框选(自动存桌面),Windows Win + Shift + S 框选(进剪贴板,直接粘贴到聊天窗口) D1 起,全程
API key 一串调用外部 AI 服务的通行证。本课程全流程不需要它(默认走规则路径);只有想开 LLM 增强时才找教练要 11 §4.3
127.0.0.1 / 端口 127.0.0.1 = 本机自己(不是外网);端口(如 8080)像房门号。所以 http://127.0.0.1:8080 = "打开我自己电脑上的 8080 号门" D1 起,fde-scope web

📌 复制粘贴三条纪律(终端里最容易吃亏的地方):

  1. 粘贴前先看:确认你粘的是完整一行,尤其别漏了开头的 fde-scope 或结尾的路径。
  2. 别敲回车去"试试看":终端不认"差不多",拼错一个字母就是报错。
  3. 报错先读最后一行:原因几乎总在最后一行(见 §3.5)。

1.1 角色与干系人

中文 English 白话解释 课程位置
前向部署工程师 FDE / Forward Deployed Engineer 不坐办公室写代码,而是驻到客户现场,把"客户的一句话需求"变成"能跑能验收的系统"的人。既要懂技术,也要懂业务和沟通 D1 全程
交付项目 Engagement 一次完整的"从接触到撤出"的客户交付。不是"一个需求",是一整个有开始有结束的项目 D1 / D2
现场走访 Gemba Walk 源自丰田:去事情真实发生的地方站着看。不要听汇报,去客服工位坐一小时,看真实工单长什么样 D2
资格判断 Qualification 判断这个客户"值不值得做":有没有真问题、有没有预算、有没有发起人、愿不愿意给数据。判断"不做"也是本事 D2 / 10 §6
发起人 Sponsor 客户方有预算权、能拍板的人。他说"继续"项目才能继续 D2
执行发起人 Executive Sponsor 最高层那位发起人。签预算、扛政治压力的人 D2
第二发起人 Second Sponsor 第二个能拍板的人。防的是"唯一发起人离职/调岗 = 项目当场死亡"——这是 FDE 最经典的反模式之一(Sponsor Collapse) D2
把关人 Gatekeeper 不推项目前进、但能一票否决的人:IT、安全、法务、工会、车间主任。他不在你的动员名单里,就在你的风险清单里 D2
干系人地图 Stakeholder Map 一页纸画出:谁在乎什么、谁支持、谁反对、谁沉默但有毒。四类必标:执行发起人 / 第二发起人 / 一线使用者 / IT·安全把关人 D2 / 12 §2.1
一线使用者 End User / Frontline User 真正每天点你系统的人。他的"麻烦"往往和老板的 KPI 不是一个东西 D2
内部拥护者 Champion 客户内部主动帮你推的人(很多是一线主管)。没有 Champion 的项目,落地率腰斩 D2

1.2 流程与交付

中文 English 白话解释 课程位置
范围 Scope 你答应做什么、以及明确不做什么。不写"不做什么",范围就无限膨胀 D2
界定范围 Scoping 开工前把"做什么/不做什么/什么算做完"谈清楚的过程。这是 FDE 最值钱的能力,也是"定边界工作坊"卖的东西 D2 / 10 §6
范围蔓延 Scope Creep 需求一点点加、工期一点点拖,最后变成一个谁也不认得的项目。反制手段:时间盒 + 书面委托单 + 每加一项就砍一项 D2 / 10 §10
时间盒 Time Box 给每件事封死的期限。课程时间盒:≤14 天完成集成、≤90 天上线、≤120 天交接完毕 D2
可度量成功标准 Measurable Success Criteria 带数字和时间的验收标准。"提升体验"是废话,"意图准确率从 78% 到 91%"才是标准。课程要求 ≥3 条 D2 / G2
放弃标准 Disengagement Criteria 事先写好"什么情况下我们体面退出"。写不出放弃标准的人,会被无限试点拖死 D2
无限试点 Infinite Pilot 永远在试点、永远不验收、永远不付款。反制:先定义 done D2 / 10 §10
门禁 Gate 每一阶段出口的硬检查点:不通过不许往下走。门禁是工程,不是清单——它由代码强制,不是靠自觉。⚠️ 本词有两个所指:课程进度门禁 G0–G8 与工具里的 10 个阶段门禁,对照见 03 §1.1 D1 起每天
强制推进 --force 工具允许你绕过门禁,但依然会评估并留下记录。课程里的"补交"就是 --force 的课程版:24 小时内补齐正常;超过 24 小时算"延期通过"并记入证书备注 03 §5
阻塞项 / 警告项 Blocker / Warning 门禁里的两种判定:blocker 不过就停;warning 记录但不拦。不要为了好看把 blocker 降级 03 §4
交接 Handoff 把你的系统、知识、责任正式移交给客户团队。交付的终点不是"上线",是"客户能自己跑" D7
交接四件套 Handoff Package Runbook + 评估报告 + SLO 卡 + 培训材料。四件缺一不算交接 D7 / G7
退场计划 Disengagement Plan 写清楚"我什么时候走、走了以后 30/60 天谁支持什么、什么条件下一刀切断"。没有退场计划的交付 = 永久售后 D7 / 10 §10
推广 Rollout 从"一个团队能用"到"全公司能用"。课程教你先证明再推广,不做大爆炸上线 D5 / D7
冷启动 Cold Start 系统刚上线、还没积累数据/反馈的阶段。此时表现最差是正常的,关键是别在冷启动期下"没用"的结论 D5
人机协作 HITL / Human-in-the-Loop 关键决策让人来拍板,AI 只给建议。客服、医疗、工业场景必须有 D6 / 07 案例 B
升级路径 Escalation Path 处理不了的时候,按什么顺序找谁。Runbook 里每类事件都要写 D6
回滚 Rollback 出问题时退回上一个已知好状态的具体操作步骤。Runbook 里没有回滚步骤 = 没有 Runbook D6 / G6
影子模式 Shadow Mode 新系统先"跟着跑"不生效:AI 给建议、人做决策、记录差异。上线前最安全的一步棋 D5
验收 Acceptance / UAT 客户正式确认"这东西符合我们约定的标准"。要有签字人,不能是口头"挺好的" D7 / G7
出厂验收 / 现场验收 FAT / SAT 工业专有:FAT = 在工厂里验(Factory Acceptance Test),SAT = 装到现场后验(Site Acceptance Test)。制造业客户必问 07 案例 C
物理隔离 Air-gap 网络与互联网物理断开的环境(军工、部分工厂)。此时不能调外部大模型,必须走本地/规则路径 11 §6.6
工会共决 Works Council 德国等地区:涉及员工监控的系统需工会审批(BetrVG §87)。这是把关人,不是流程障碍 07 案例 C
功能安全 Functional Safety 工业机器人场景:不通过安全等级验证不许上产线(ISO 13849 / IEC 61508 / ISO 10218)。工业 FDE 的硬门禁 07 案例 C
价值冲刺 Value Sprint 课程方法论:把交付切成 ≤14 天的可交付小段,每段都产生可被看见的价值,而不是等三个月给一个大惊喜 01 §4

1.3 数据与语料

中文 English 白话解释 课程位置
原始数据 Raw Data 客户直接给你的、没洗过的东西。真实世界的数据永远比 demo 脏 D3
数据体检 Data Health Check 拿到数据第一件事:看字段、看缺失、看重复、看 PII、看覆盖度。产出一页报告,回答"这数据能不能做这件事" D3 / G3
字段 Field / Column 表格的一列。要写清类型(文本/数字/时间)和缺失率 D3
数据源连接器 Connector 把数据从客户系统(CSV / 工单系统 / 数据库)取出来的适配器。课程里先只用 CSV D3 / 11 §3.1
覆盖率 / 覆盖盲区 Coverage / Coverage Gap 你的数据里这类情况有多少条、缺哪几类。盲区比总量重要:3 万条里没有一条"退款"数据,那退款场景必炸 D4 / G4
长尾 Long Tail 出现次数少但种类极多的那部分情况(各种方言、冷门问题)。模型效果差,八成死在长尾上 D4
语料 Corpus 洗干净、标注好、可以直接拿去训练/评估的数据集合。不是"数据",是"弹药" D4
语料锻造 Corpus Forge 课程核心动作:把原始数据 → 去重 → 质量门 → PII 脱敏 → 补盲 → 产出可用语料,并给出一份可审计报告 D4
个人信息 PII / Personally Identifiable Information 能定位到具体个人的信息:姓名、手机、身份证、地址、车牌、银行卡。碰 PII 前先读 11 §6 D3 起每天
脱敏 De-identification / Masking 把 PII 换成占位符(如 <PHONE>)。四步法:拿掉 / 替换 / 哈希 / 保真(见 11 §6.4) D3 / 11 §6.4
合成数据 Synthetic Data 用规则或 AI 生成的补盲数据,用来补真实数据够不到的角落。必须如实标注比例,不许冒充真实数据 D4 / G4
质量门 Quality Gate 给每条候选语料打分(长度、完整度、语言、重复度),不达标的淘汰。淘汰了多少条也要写进报告 D4
去重 Dedup "在吗""你好"这类无信息量重复项的清理。去重日志要有数字:去掉了多少、为什么 D4
标注 Labeling / Annotation 给数据打上正确答案(这条工单属于"退款咨询")。标准不统一,评估就全是噪音 D4 / D5
本体 / 概念体系 Ontology / Taxonomy 把业务概念理成一张有层级的关系网(退款 → 部分退款 → 超时退款),让覆盖度检查能按概念而非关键词做 D4(--ontology)
数据漂移 Data Drift 客户的业务变了,数据分布跟着变,模型悄悄失效。没人监控的 AI 100% 会漂 D6

1.4 评估与指标

中文 English 白话解释 课程位置
基线 Baseline 改动之前的真实水平。没有基线的提升都是玄学。课程用 78% 之类的数字做基线 D5 / G5
测试集 / 金标集 Test Set / Golden Set 一套固定的、有人工标注答案的题目。同一套题反复跑,才看得出真实变化 D5
准确率 Accuracy 做对的占总数的比例。课程主指标。但要看它和什么比(vs 基线) D5
离题率 / 幻觉 Hallucination / Off-topic Rate AI 一本正经胡说。要单列一条指标盯它,别混进总分 D5
坏案 Bad Case 做错的那些样本。坏案比总分值钱:它告诉你下一步该干什么。课程要求给 Top3 每条附动作 D5 / G5
一级解决率 FCR / First Contact Resolution 一次接触就解决的问题比例。客服场景核心业务指标 D5
处理时长 Handle Time 处理一次要多久。课程基线取人工 8 分钟(480 秒) D5
客户满意度 CSAT / Customer Satisfaction Score 客户打分(通常 1–5)。样本少时不要拿它当主指标 D5
转人工率 Escalation Rate 多少比例的问题得找人。太低说明硬扛(有风险),太高说明没省下事 D5
数据飞轮 Data Flywheel 线上使用 → 收集坏案 → 补语料 → 重新评估 → 变好 → 更多人用。没有飞轮,上线就是开始退化 D6
概率性退化 Probabilistic Degradation 反模式:系统不是"坏了",是悄悄变差了,而没人监控、没人发现 D6 / 10 §10
服务等级目标 SLO / Service Level Objective 你承诺的"正常水平",例:"95% 请求 2 秒内响应"。要有目标值 + 测量方式 D6 / G6
错误预算 Error Budget 允许失败的那部分额度(SLO 99% 意味着每月可失败约 7 小时)。烧完就停止新功能、先修稳定性 D6 / G6
告警路由 Alert Routing 出事了谁、通过什么渠道、多久内响应。三要素缺一 = 没人管 D6 / G6
运维手册 Runbook 一页页写清楚"这类事件怎么判断、怎么处理、怎么回滚、找谁升级"。判断标准:同事照着能做 D6 / G6
凌晨 2 点盲测 2 AM Test 课程考核法:找没参与的同学,只给 Runbook,让他独立处理一次事件。盲测通过才算 Runbook 合格 D6 / G6
监控指标 KPI 客户业务层面的数字(工单下降 30%、拦截率 60%)。和 SLO(技术稳定性)是两回事,汇报时别混 D6 / fde-scope kpi
值班交接 Shift Handover 多班次生产环境:上一班必须把状态、待办、风险交接给下一班。工业场景的硬门禁 D6 / 07 案例 C

1.5 工程与平台

中文 English 白话解释 课程位置
门户(主页) Portal 对外讲清"是什么 / 给谁用 / 怎么收费 / 怎么联系"的入口页。≠ 控制台:门户是"门",fde-scope web 是"台" 招生 / 开营前
平台层 Platform Layer 本课程用的自研 FDE 工具与流程平台:CLI(17 条命令)+ Web 控制台 + Python 库,底座是 18 阶段状态机 + 10 门禁 D1 起每天
工具分工 Tool Division of Labor 不要求客户换工具:编码 / 办公 Agent 用客户自带的,fde-scope 只叠"流程 / 门禁 / 留痕层" D1 / 01 §6.4
智能体 Agent 会调用工具、能做多步决策的 AI 程序。不只是"聊天" D5 起
大模型 LLM / Large Language Model 底座模型(如 MiMo、GPT)。FDE 一般不训练它,而是用它 + 语料 + 工具做系统 D1 / 11 §4
提示词 Prompt 给模型的指令。调 Prompt 是最后手段,先修语料和数据 D4 / D5
工具调用 Tool Calling 让模型能真的"做事"(查库、下单),而不只是说话 D5
权限引擎 Permission Engine 决定"哪些工具能自动执行、哪些必须人确认"。课程铁律:只有规则授权是权限通道 D6
沙箱 Sandbox 每个客户/任务跑在隔离环境里,互不污染。多租户第三层隔离 D6
多租户 Multi-tenancy 一套系统服务多个客户,数据互相看不见。三层隔离:沙箱 + 数据集合 + 权限引擎 D6
幂等 Idempotent 同样的操作跑两遍,结果和跑一遍一样。数据写入类工具必须幂等,否则重试就是灾难 D6
降级路径 Fallback / Degradation Path 大模型不可用时自动退回规则路径,功能变弱但不中断。课程工具链全部 fail-safe 11 §4
规则路径 Rule Path 不调用大模型、纯逻辑判断的实现。零 key 也能跑全流程——这是教学与离线场景的保底 11 §4.1
冒烟测试 Smoke Test 装完环境先跑几条命令,确认"没坏"。五分钟省三小时 G0 / 11 §3.1
环境变量 Environment Variable 存放密钥等配置的运行时变量。密钥只能放这里,不许进文件、日志、截图 11 §4.4

1.6 十二大反模式速查(FDE 专属"避坑清单")

来源:docs/fde_sop_full.md §"12 大反模式"。面试与答辩高频考点——被问"你遇到最大的坑是什么",答反模式比答"加班太多"强一百倍。

# 反模式 一句话症状 反制动作(课程教的)
1 Consulting Trap 咨询陷阱 FDE 越做越像定制外包,产品永远长不出来 每做完一个项目必须沉淀技能卡(skill add)
2 Snowflake-Per-Customer 一客一版 每个客户一套代码,维护成本爆炸 优先复用已有模式与模板
3 Hero Engineer 英雄工程师 全靠一个牛人扛,他一休假就瘫 交接四件套 + 盲测
4 Demo-Debt Spiral 演示债 demo 演的东西平台根本做不到 在真实脏数据上做原型,不搭布景
5 Sponsor Collapse 发起人崩塌 唯一发起人离职,项目当周死亡 干系人地图必标 ≥2 位发起人(G2 硬门槛)
6 Burnout Death Spiral 燃尽螺旋 最能干的人先离职 时间盒 + 明确放弃标准
7 Probabilistic Degradation 概率性退化 系统悄悄变差,无人发现 SLO + 告警路由 + 数据飞轮
8 Infinite Pilots 无限试点 永远试点、永远不定义 done 委托单写死 done 与时间盒
9 Data Quality Surprises 数据质量惊吓 假设"数据已经治理好了" 开工先做数据体检(G3)
10 Scope Creep 范围蔓延 需求只加不减,工期只拖不缩 每加一项,砍一项;委托单 ≤1 页
11 No HITL 无人机协作 AI 直接对外说话,没人兜底 关键决策留人确认
12 Safety Incidents 安全事故 没做危险分析就动产线 工业 profile 的功能安全门禁

1.7 历史与原理词(来自 00 底稿)

这一节的词不在 D1 的 3 个新概念额度里,平时用不到。 它们的用武之地只有两个:D8 模拟面试、客户/领导追问"为什么是现在"。 每个词都标了在 00 里的出处,需要展开时直接翻过去。

中文 English 白话解释 课程位置
本体 Ontology Palantir 的核心抽象:把客户业务里的对象、属性、关系显式建模成一层语义底座,让上层应用/AI 复用同一套语义。没有这层,AI 只能停在问答和摘要 00 §1.3
对象 / 属性 / 媒体 / 链接 Objects / Properties / Media / Links 本体的四种原语。四原语 + 三层结构(语义层 / 动势层 / 动态层)构成了 Palantir 毛利率 82% 的技术底座 00 §1.3
范式转移 Paradigm Shift 商业模式从"卖软件席位"转向"卖持续产生效果的系统"。前者一锤子买卖,后者看 LTV——FDE 因此从"可选项"变成"必需品" 00 §2.1
三道成本门槛 Three Cost Barriers 行业知识蒸馏 / 定制开发 / 复合型人才供给——三者同时高企,构成 FDE 存在的经济学理由 00 §2.2
机制链条 Mechanism Chain 需求异质化 → 必须做可运行 Demo 验证 → 售前交付能力前置 → AI 降低原型成本 → FDE 成为可行组织形态。五级因果,缺一环链条就断 00 §2.3
80 / 95 / 99 规律 The 80/95/99 Rule AI 把"做到 80 分"变便宜了,但客户买的是 99 分。FDE 干的正是 80% → 99% 这段(工程经济学的最优解:AI 覆盖可规模化的 99%,人守住不可自动化的 1%) 00 §2.4
能力-采用剪刀差 Capability-Adoption Gap 尝试 AI 的组织 >70%,但停在试点的 >60%——中间那道沟就是 FDE 的饭碗 00 §2.5
前线学习机制 Frontline Learning Loop ToB 重交付的根本矛盾:交付必须足够重才有效果,太重又算不过账。解法是三步闭环(重新定义客户问题 → 交付验证 → 把现场经验带回来);缺第三步,FDE 就退化成高端外包 00 §2.6
回声 / 增量 Echo / Delta Echo = 客户知识回流到厂商、变成可复用资产;Delta = 厂商靠 Echo 产出的产品改进、反哺下一次交付。两者合成飞轮 00 §2.6
双向蒸馏 Bidirectional Distillation 从现场知识里同时蒸馏两份东西:面向客户的(专属解决方案)+ 面向厂商的(可复用能力)。只做前者 = 咨询;只做后者 = 不懂现场 00 §2.6
延迟收益与规模效应 Delayed Payoff & Scale Effect 头几个客户几乎不赚钱(全在积累本体),做到第七八个客户,本体基本趋向稳定——此后边际交付成本骤降 00 §2.6
FDE 试金石 The FDE Litmus Test 四级判据:能不能自己上现场 → 能不能独立定义问题 → 能不能对结果负责 → 能不能把经验带回组织。逐级升高,第四级才是分水岭 00 §2.6
知识沉淀载体 Knowledge Carrier Evolution 承载 FDE 现场知识的形态演变:知识图谱 → 工作流编排 → Multi-Agent → Skill + 连接器(当下)。看懂这条线,就知道"技能卡"沉淀的下一步在哪 00 §2.6
能力模型 40 / 30 / 30 40/30/30 Capability Model FDE 能力的权重划分:工程 40% + 业务 30% + 解决方案 30%。它是一张自评表,不是招聘要求——用来找自己最缺的那块 00 §3.6
事实核查纪律 Fact-Check Discipline 引用任何市场/薪资数字时必须连来源与日期一起说;两来源冲突时标 ⚠ 而不是擅自定论。见 00 §1.6 的待办清单与 §6 的 5 条引用纪律 00 §6 / 10 §8

2. 模板库(复制即用)

用法:直接复制代码块内容,把 <尖括号> 里的东西换成你自己的。 每个模板标注了 ⭐ 门禁(对应 03)与 📅 产出日。 需要命令行产出物时,命令写在模板末尾的"工具路径"里,细节见 §3。

2.0 入学自评雷达 + 学习契约(⭐G0 · 📅开营前)

谁要交:每一位学员,开营前填好发群或交给助教。 为什么填:① 讲师按它强弱搭配分组结对;② 你自己知道该把精力放哪;③ 结营时对照看进步。 ⚠ 不是考试——填低不会被拒之门外,如实填才有用(这是本课"诚实标注"价值观的第一次实践)。

# 入学自评雷达 · <你的名字/昵称> · <日期>

## 一、四维自评(每维 1–5 分,选一个数圈出来)

| 维度 | 1 分 | 3 分 | 5 分 | 我的分数 |
|---|---|---|---|---|
| 技术 | 没写过代码、没用过命令行 | 能复制粘贴命令、看懂报错大意 | 能独立写小脚本、会用 git | <1–5> |
| 业务 | 没接触过客户/需求 | 参加过需求会、知道什么叫干系人 | 独立谈过需求、写过方案 | <1–5> |
| 沟通 | 怕讲、一听术语就懵 | 敢在群里提问、能复述别人观点 | 能对客户讲清技术方案 | <1–5> |
| 交付 | 没交付过任何东西给别人用 | 交过作业/文档并被他人使用过 | 独立负责过上线或对客交付 | <1–5> |

## 二、三句实话(各写 1 句,不写"无")
- 我最怕的一件事:<例:怕在群里问蠢问题>
- 我每天最可能被打断的时段:<例:21:00 后要带娃>
- 我想在 8 天里拿到的一件东西:<例:一份能放进简历的交付作品>

## 三、期望管理(勾选,即视为已读)
- ☐ 我已知悉:D1 全天 6 小时、D2–D8 每天约 2.25 小时(合计**约 22 小时**),作业按【门禁】验收
- ☐ 我已知悉:本课**不承诺就业、不承诺收入**;所有案例为虚构演示数据
- ☐ 我已知悉:练习中**不得使用真实客户名与真实 PII**(见 `08` §11)
- ☐ 我已知悉:作品集对外展示需本人**书面授权**

签名:<你的名字>        日期:<日期>

工具路径:无。这份模板没有命令行——手写/复制到 Markdown 或在线文档,开营前交即可; 完成后去 06 §2 的自检表第 5 行打勾。

讲师怎么用这份雷达(学员可跳过):

  • 技术 ≤2 且业务 ≥3 → 编入"业务强组",配技术搭档;
  • 四维均 ≤2 → 主动结对并在 D1 前单独确认环境自检通过;
  • 任一维 5 分 → 候选小组长(负责催交与答疑)。

2.1 客户委托单(⭐G2 · 📅D2)

一页纸,不许超。 这是你和客户之间唯一的"合同"——不含价格,含范围与边界。

# 客户委托单 · <客户名> · <日期> · v<版本>

## 1. 业务画像(这个客户是谁)
- 行业/规模:<例:新茶饮连锁,420 家门店>
- 场景:<例:客服工单意图分类与自动回复>
- 现状痛点(客户原话):<"高峰期 60% 工单是重复问题,客服扛不住">

## 2. 干系人地图(谁在乎什么)
| 角色 | 姓名/化名 | 在乎什么 | 支持度 | 备注 |
|---|---|---|---|---|
| 执行发起人 | <赵总·运营VP> | <人力成本下降、客诉率> | 强支持 | 预算权 |
| 第二发起人 | <孙经理·客服总监> | <客服排班压力、落地速度> | 支持 | ⚠ 必须≥2位发起人 |
| 一线使用者 | <客服组长> | <少点重复劳动、别增加操作> | 中立 | 需早期参与 |
| IT/安全把关人 | <IT 负责人> | <数据不出内网、权限可控> | 谨慎 | 一票否决权 |
| 潜在阻力 | <区域经理> | <怕被考核指标追责> | 反对 | 需单独沟通 |

## 3. 成功标准(全部可度量,≥3 条)
| # | 指标 | 基线 | 目标 | 时间 | 怎么测 |
|---|---|---|---|---|---|
| 1 | 意图分类准确率 | 78% | ≥91% | ≤90d | 固定测试集(≥200 条) |
| 2 | 重复工单占比 | 60% | ≤42% | ≤90d | 客服系统周报 |
| 3 | 平均处理时长 | 8 分钟 | ≤5 分钟 | ≤90d | 工单系统导出 |

## 4. 时间盒
- 集成完成:≤14 天(<日期>)
- 上线:≤90 天(<日期>)
- 交接完成:≤120 天(<日期>)
- 每周同步:<周几 + 时长 + 谁参加>

## 5. 范围(做什么 / 不做什么)
- ✅ 做:意图分类 + Top5 高频问题自动回复建议
- ❌ 不做:全量自动回复、多语言、电话语音、跟订单系统对接写操作
- 🔄 变更规则:新需求进来 → 从 ✅ 里砍掉等量的一项,或顺延时间盒

## 6. 放弃标准(什么情况下体面退出)
- <例:若 30 天内无法获得 ≥500 条真实标注数据,暂停并重新评估>
- <例:若 IT 安全评审否决数据不出内网方案且无替代,终止>

## 7. 已知风险
| 风险 | 影响 | 缓解动作 | 责任人 |
|---|---|---|---|
| <唯一发起人风险> | <项目停摆> | <已发展第二发起人> | <我方> |
| <数据质量未知> | <效果不达标> | <D3 先做体检,结论前置> | <我方> |

---
签署:客户方 <姓名/角色> ______  交付方 <姓名> ______  日期 ______

工具路径:fde-scope engage init --customer "<客户名>" --profile ticket 建档 → 门禁自检 fde-scope gate check <id> --gate success_criteria (这一步查的是工具里"边界阶段"的门禁,与课程门禁 G2 是两套,见 03 §1.1)


2.2 数据体检报告(⭐G3 · 📅D3)

一页半。结论必须明确:能做 / 不能做 / 有条件能做——不许写"建议进一步分析"。

# 数据体检报告 · <客户名> · <日期>

## 0. 一句话结论
**<有条件能做>**:<现有 32,400 条工单可支撑意图分类,但退款类样本仅 12 条,
需在 D4 补盲 ≥200 条,否则该场景不纳入验收范围。>

## 1. 数据源概况
| 数据源 | 位置 | 类型 | 记录数 | 时间范围 | 获取方式 |
|---|---|---|---|---|---|
| <客服工单导出> | <客户提供 CSV> | 结构化 | 32,400 | <2024-01~2026-08> | <手动导出> |

## 2. 字段清单与质量
| 字段 | 类型 | 缺失率 | 问题 | 处置建议 |
|---|---|---|---|---|
| <工单ID> | 字符串 | 0% | 主键,唯一 | 保留 |
| <问题描述> | 文本 | 3.2% | 空值、含大量"在吗" | 去重 + 长度过滤 |
| <分类标签> | 枚举 | 21% | 缺失严重、口径不统一 | 仅用有标注部分做测试集 |
| <客户手机> | 字符串 | 0% | ⚠ PII | 脱敏后使用 |

## 3. PII 清单与处置
| PII 类型 | 出现量级 | 位置 | 处置方式 |
|---|---|---|---|
| <手机号> | <8,900 条> | <问题描述字段内嵌> | <正则替换为 <PHONE>> |
| <姓名> | <约 2,100 条> | <描述 + 备注> | <替换为 <NAME>> |
> 处置动作:<已用 `fde-scope corpus` 脱敏,报告显示 masked=11,000>
> ⚠ 提醒:<该数据不得上传任何第三方平台,演示需用脱敏样本>

## 4. 覆盖度观察
| 类别 | 现有条数 | 判断 |
|---|---|---|
| <退款/售后> | <12> | ⚠ 严重不足(长尾盲区) |
| <物流查询> | <9,800> | ✅ 充足 |
| <门店投诉> | <4,300> | ✅ 充足 |
| <会员/积分> | <45> | ⚠ 不足 |
| <退换货> | <58> | ⚠ 不足 |

## 5. 质量风险(≥3 条)
1. <21% 标签缺失 → 测试集规模受限,需人工补标 ≥200 条>
2. <方言与口语化表达占比高 → 已知局限,预期影响准确率>
3. <同一工单存在跨月重复 → 需去重,否则高估数据量>

## 6. 下一步建议
- <D4:补盲 3 类(退款/会员/退换货),合成比例预计 ≤12% 并如实标注>
- <需客户在 <日期> 前确认:能否提供标注人力 / 是否接受合成数据>

工具路径:fde-scope connect --type csv --source <路径> 看字段与 PII 字段名标记(只按列名判,自由文本列不会被标,需逐条看样本值)→ fde-scope corpus --input <路径> --out reports/corpus_report.html 出语料报告


2.3 客户话术(⭐G4 · 📅D4)

≤200 字,零术语。 说给客户业务方听的,不是给技术人看的。 禁用词表:语料 覆盖度 合成数据 去重 准确率(裸用) 模型 推理 向量 embedding token

三句骨架:① 能用多少 → ② 补了什么 → ③ 为什么可信

# 客户话术(≤200 字)

<我们从 32,400 条工单里,筛出了 21,800 条能直接用的问答记录,
覆盖了物流、投诉、门店服务等主要场景。
>
<发现"退款""会员积分""退换货"这 3 类记录太少,我们按你们的业务规则
补充了约 2,600 条模拟问答,并做了标注,保证这 3 类也能被正确处理。
>
<所有数字都可以在报告里逐条追溯,随时欢迎你们抽查任意一条。>

自检:字数 ≤200?术语零出现?念给非技术同事听,他能不能复述出"用了多少、补了什么、可信在哪"?


2.4 评估测试集模板(⭐G5 · 📅D5)

复制成 test_set.jsonl(一行一条 JSON),然后 fde-scope eval --agent mock --test-set test_set.jsonl。 字段与工具内部模型一致,多余字段可省;id 与 input 必填。 建议 ≥200 条,且必须包含长尾类(哪怕只有 20 条)。

📌 零基础三步存成文件:① 打开文本编辑器(记事本 / 文本编辑 / VS Code 都行),把下面的行粘进去; ② 另存为 test_set.jsonl——Windows 记事本要把"保存类型"改成"所有文件",否则会存成 test_set.jsonl.txt,命令会报"文件不存在";③ 存到仓库根目录(和 pyproject.toml 同级), 因为命令里用的是相对路径。

⚠ 先选版本,再复制:下面给了两版,复制错版本会得到 0.000 的假分数。

版本 A · 零 key 跑通流程用(D5 默认就用这版,前 5 行起步) ——不含 expected_category,intent_accuracy 记 1.0(= 无信号),流程照跑:

{"id": "c-001", "input": "我要退货,怎么操作?", "category": "退款售后", "expected_output": "指导退货流程", "baseline_handle_time_seconds": 480.0}
{"id": "c-002", "input": "我的快递到哪了", "category": "物流查询", "expected_output": "查询物流状态", "baseline_handle_time_seconds": 480.0}
{"id": "c-003", "input": "这家店的服务太差了!我要投诉", "category": "门店投诉", "expected_output": "记录投诉并升级", "escalated": true, "baseline_handle_time_seconds": 480.0}
{"id": "c-004", "input": "积分怎么兑换", "category": "会员积分", "expected_output": "说明积分规则", "baseline_handle_time_seconds": 480.0}
{"id": "c-005", "input": "我要退货咯,咋个弄嘞", "category": "退款售后", "expected_output": "指导退货流程", "baseline_handle_time_seconds": 480.0}

版本 B · 完整字段示范(含 expected_category,只在用 --agent mimo 或接自己 Agent 时才加回去):

{"id": "c-001", "input": "我要退货,怎么操作?", "category": "退款售后", "expected_category": "退款售后", "expected_output": "指导退货流程", "baseline_handle_time_seconds": 480.0}
{"id": "c-002", "input": "我的快递到哪了", "category": "物流查询", "expected_category": "物流查询", "expected_output": "查询物流状态", "baseline_handle_time_seconds": 480.0}
{"id": "c-003", "input": "这家店的服务太差了!我要投诉", "category": "门店投诉", "expected_category": "门店投诉", "expected_output": "记录投诉并升级", "escalated": true, "baseline_handle_time_seconds": 480.0}
{"id": "c-004", "input": "积分怎么兑换", "category": "会员积分", "expected_category": "会员积分", "expected_output": "说明积分规则", "baseline_handle_time_seconds": 480.0}

🟡 为什么用 --agent mock 时必须删 expected_category:mock 的回复只含用户原话、不带类别名, 而打分是子串匹配——只要你填了这一列,intent_accuracy 就恒为 0.000。这不是你写错了(详见下方「为什么是 0.000」)。

字段说明(可省字段用默认值)

字段 类型 默认 含义
id string 必填 样本唯一 id
input string 必填 用户输入
category string uncategorized 本条的实际类别
expected_category string|null null 期望 AI 判定的类别(打分依据)
expected_output string|null null 期望回复要点
agent_reply string "" 通常留空,跑评估时由 Agent 填入;仅在验证打分逻辑时才手写(见下)
adopted bool|null null 人工是否采纳
escalated bool false 是否需转人工
resolved_first_contact bool true 是否一次解决
handle_time_seconds float 0.0 实际处理时长
baseline_handle_time_seconds float 480.0 人工基线(8 分钟)
csat float|null null 满意度
metadata object {} 自定义附加信息

工具路径:

fde-scope eval --agent mock --test-set test_set.jsonl      # 规则路径,零 key
fde-scope eval --agent mimo --test-set test_set.jsonl      # 真模型,需 key(见 11 §4)

⚠ 读表前必看:哪几个数字是真信号,哪几个只是"没填数据"

eval 打出 10 行指标,只有你亲手填进样本的字段才是真信号,其余是"没数据时的默认值"。把默认值当成绩写进作品集,等于编数据(违反 README.md 诚实边界)。

指标 没数据时它会显示 真实含义
intent_accuracy 填了 expected_category → 0.000
没填 → 1.000
见下方「为什么是 0.000」
reply_adoption_rate 1.000 adopted 留空 = 默认算采纳,不是实测 100%
escalation_rate 0.000 ✅ 真信号:样本里 escalated: true 的条数占比
first_contact_resolve 1.000 resolved_first_contact 默认 true,不是实测
avg_handle_time 0.000 没有数据(没填 handle_time_seconds),不是"0 秒搞定"
customer_satisfaction 3.000 没填 csat 时的 1–5 中性中点,不是实测 3 分
cost_per_ticket 1.000 没时长数据时按"与人工基线持平"记,不是"成本没降"
corpus_coverage / corpus_quality_avg / corpus_diversity 0.000 没接语料报告(corpus 阶段产物),不是"覆盖率 0"

为什么 intent_accuracy 是 0.000?

打分口径是子串匹配:expected_category 这串字必须原样出现在 AI 回复里才算命中(fde_scope/eval/metrics.py 的 score_intent_accuracy)。 而 --agent mock 的回复只含用户原话——已为您处理:<input 前 30 字>…(mock 回复),不带类别名。所以只要你填了 expected_category,mock 就恒为 0.000。这不是你写错了。

三种正确用法:

你想干什么 怎么做
只想跑通流程、看 bad case 挖掘与语料建议 删掉 expected_category(该条记 1.0 = 无信号),流程照跑
想验证「打分逻辑本身」通不通 像 tests/test_eval.py 那样在样本里直接写 agent_reply:{"expected_category": "退款", "agent_reply": "已为您处理:退款"} —— 这样才有区分度
要真实的准确率数字 用 --agent mimo 或接你自己的 Agent:agent_reply 由 Agent 填,expected_category 才真正生效

--accuracy(默认 0.9)只决定 mock 回哪句套话(另有 10% 回"抱歉,我不太理解"),不改变判分口径。 ⚠ 这条口径对真模型同样成立:MiMoReplyFn 的 prompt 并不要求它输出类别名,所以 expected_category 照样可能命中不了。真要量化,就在 Agent 的输出格式里约定带上类别标签。 别把 mock 跑出来的任何数字写进作品集。


2.5 Bad Case 清单(⭐G5 · 📅D5)

Top3 起步。每条必须有一句"下一步动作"——没有动作的 bad case 清单是废纸。

# Bad Case 清单 · <客户名> · <日期>

共评估 <200> 条,错 <18> 条,准确率 <91%>(基线 <78%>)。

## Top1 · <方言表达未识别>(错误 7 条)
- **现象**:<"我要退货咯,咋个弄嘞" 被判为"闲聊">
- **根因假设**:<训练数据以普通话书面语为主,方言样本近乎为零>
- **下一步动作**:<D6 前补 60 条方言改写样本,重跑同一测试集对比>
- **预计改善**:<该类错误 7 条 → ≤2 条>

## Top2 · <多意图混淆>(错误 6 条)
- **现象**:<"退款并投诉门店" 只判出"退款">
- **根因假设**:<标注口径为单标签,测试集未定义多意图处理规则>
- **下一步动作**:<与客户确认多意图口径;若需支持,改为多标签评估>
- **预计改善**:<待口径确认后重新评估>

## Top3 · <长文本截断>(错误 5 条)
- **现象**:<超过 500 字的描述,关键诉求在末尾被截断>
- **根因假设**:<输入截断阈值设得过小>
- **下一步动作**:<调整为分段摘要后送入;重跑验证是否影响其他类别>
- **预计改善**:<长文本类错误 5 条 → 0 条,需确认延迟不劣化>

2.6 验证记录(⭐G5 · 📅D5)

一页。证明"我不是自说自话"——有人看过、有人提过需求、有人被拒绝过。

# 验证记录 · <客户名> · <日期>

| # | 时间 | 对象(角色) | 形式 | 对方反馈 | 我方处置 | 结果 |
|---|---|---|---|---|---|---|
| 1 | <D4> | <客服组长> | 现场演示 20min | <"回复太正式,不像我们说话"> | 采纳:调整话术风格 | 已改 |
| 2 | <D4> | <IT 负责人> | 邮件确认 | <"数据不许出内网"> | 采纳:改用内网部署 | 已改 |
| 3 | <D5> | <运营 VP> | 汇报 15min | <"能不能顺便做电话语音?"> | **拒绝**:超出范围,建议二期 | 记入范围外 |
| 4 | <D5> | <未参与的同事> | 盲测 Runbook | <按文档独立处理成功> | 通过 | ✅ |

## 汇总
- 演示 <3> 次,覆盖 <3> 类角色
- 接受需求 <2> 项,**拒绝 <1> 项**(拒绝理由:超出委托单范围,见 §2.1 第 5 节)
- 未决事项:<1> 项(<多意图口径待客户确认>)

💡 被拒绝的需求要写进来。答辩评分表里"边界感"一项,看的就是你敢不敢写"我拒绝了什么"。


2.7 SLO 卡(⭐G6 · 📅D6)

三条起。每条必须有目标值 + 测量方式,否则不是 SLO,是口号。

# SLO 卡 · <客户名> · <日期>

## 服务等级目标
| # | 指标 | 目标值 | 测量方式 | 数据来源 | 覆盖时段 |
|---|---|---|---|---|---|
| 1 | 可用性 | ≥99.5%/月 | 健康检查成功率 | <探针日志> | 7×24 |
| 2 | 响应延迟 | P95 ≤ 2s | 请求耗时直方图 | <服务日志> | 7×24 |
| 3 | 分类准确率 | ≥91%(周抽样 200 条) | 每周固定测试集重跑 | <评估报告> | 每周 |

## 错误预算
- 可用性 99.5%/月 ≈ 每月允许不可用 **<3.6> 小时**
- 预算烧完(>100%)→ **暂停新功能,优先修稳定性**
- 预算消耗看板:<链接/路径>

## 告警路由(谁 / 渠道 / 多久)
| 严重度 | 触发条件 | 通知谁 | 渠道 | 响应时限 |
|---|---|---|---|---|
| P0 | 服务不可用 >5min | <值班工程师 + 我方> | <电话 + 群> | 15 分钟 |
| P1 | 延迟 P95 >5s 持续 10min | <值班工程师> | <群> | 1 小时 |
| P2 | 准确率周环比跌 >5pt | <项目负责人> | <邮件> | 1 个工作日 |

## 已知不覆盖
- <非工作时段(20:00–09:00)仅告警不承诺响应,见退场计划>

2.8 Runbook(⭐G6 · 📅D6)

五类事件,每类四段:判断信号 → 处置步骤 → 回滚步骤 → 升级路径。 合格标准:没参与过的同事,只照文档能独立处理(凌晨 2 点盲测)。

# Runbook · <客户名> · <日期> · v<版本>

> 前置:值班人员需具备 <终端操作 + 看日志> 能力,无需懂模型。

## 事件 1 · 服务不可用
- **判断信号**:健康检查连续 3 次失败;用户报"打不开"
- **处置步骤**:
  1. 确认范围:`curl <健康检查地址>` — 是全部不可用还是部分?
  2. 看最近变更:<最近 24h 是否有发布/配置改动>
  3. 重启服务:<具体命令>
  4. 观察 5 分钟:健康检查是否恢复
- **回滚步骤**:<退回上一版本的具体命令 / 恢复配置备份路径>
- **升级路径**:<15 分钟未恢复 → 通知 <值班工程师> → 30 分钟未恢复 → 通知 <我方联系人>>

## 事件 2 · 指标暴跌
- **判断信号**:准确率周环比跌 >5pt;或坏案率突增
- **处置步骤**:
  1. 取最近 <200> 条真实请求,跑固定测试集:`fde-scope eval --agent mock --test-set <路径>`
  2. 对比 Top3 坏案类别,判断是"数据变了"还是"代码/配置变了"
  3. 若是数据漂移 → 记录样本,提交补语料需求(走飞轮)
- **回滚步骤**:<若是上次发布导致 → 回滚到上一版本;数据问题不回滚,走补语料>
- **升级路径**:<P2,1 个工作日内响应;连续两周下滑 → 升级为 P1>

## 事件 3 · 数据异常
- **判断信号**:<输入量骤降/骤增 >50%;<出现大量空字段>
- **处置步骤**:
  1. 检查上游数据源是否正常(<数据源健康页/联系接口人>)
  2. 检查是否客户业务变更(大促、停业、系统升级)
  3. 若是上游故障 → 启用降级:<返回兜底话术/转人工>
- **回滚步骤**:<上游恢复后,重放积压数据的具体命令>
- **升级路径**:<联系客户数据接口人 <姓名>;2 小时未恢复 → 升级>

## 事件 4 · 权限或配额
- **判断信号**:<权限拒绝日志增多>;<配额使用 >80%>
- **处置步骤**:
  1. 确认是哪一类权限被拒:`<日志过滤命令>`
  2. 核对最近是否有账号/角色变更
  3. 配额告警 → 提前扩容或限流:<具体操作>
- **回滚步骤**:<撤销最近的权限变更,恢复备份的权限配置>
- **升级路径**:<安全负责人 <姓名>;P1,1 小时内响应>

## 事件 5 · 上游依赖挂
- **判断信号**:<模型接口连续超时>;<数据库连接失败>
- **处置步骤**:
  1. 确认是哪个依赖:`<逐个探测命令>`
  2. 启用降级路径:<切规则模式(无需 key)>
  3. 记录不可用时段,用于事后 SLO 核算
- **回滚步骤**:<依赖恢复后切回主路径的具体命令;回放降级期间积压请求>
- **升级路径**:<依赖方接口人 + 我方;P0 若影响全部用户>

## 变更记录
| 日期 | 版本 | 改了什么 | 谁改的 |
|---|---|---|---|
| <D6> | v1 | 初版 | <姓名> |

工具路径:fde-scope handoff <id> --accept 会自动生成 reports/runbook_<id>.md 骨架(规则路径零 key;加 --llm 用模型起草)


2.9 值班交接卡(⭐G6 · 📅D6)

多班次场景(工业、7×24 客服)必用。一页,换班前 5 分钟填完。

# 值班交接卡 · <班次> · <日期 时间>

## 当前状态
- 服务状态:<正常 / 降级 / 部分不可用>
- 本班处理事件:<2 起(P2×2,均已闭环)>
- SLO 本周消耗:<可用性预算用掉 38%>

## 待办(下一班注意)
| # | 事项 | 优先级 | 下一步 | 截止 |
|---|---|---|---|---|
| 1 | <上游数据源延迟偏高,观察中> | 中 | <继续观察,>2h 未恢复按事件 3 处理> | <本班结束> |

## 已知风险
- <明早 09:00 客户有大促,请求量预计翻 3 倍>
- <模型配额剩余 42%,大促期间可能触顶>

## 联系人
| 角色 | 姓名 | 联系方式 | 适用场景 |
|---|---|---|---|
| 客户接口人 | <姓名> | <电话> | 业务类问题 |
| 我方值班 | <姓名> | <电话> | 技术类、需回滚时 |
| 依赖方 | <姓名> | <电话> | 上游故障 |

交接人 ______  接班确认 ______  时间 ______

2.10 交接包清单(⭐G7 · 📅D7)

四件套缺一不算交接。 由 fde-scope handoff 装配,明细见下。

# 交接包清单 · <客户名> · <日期>

## 四件套核对
| # | 交付物 | 内容要求 | 路径 | 状态 |
|---|---|---|---|---|
| 1 | Runbook | 5 类事件 × 四段(信号/处置/回滚/升级) | reports/runbook_<id>.md | ☐ |
| 2 | 评估报告 | 主指标 + 基线对比 + Bad Case Top3(附动作) | <路径> | ☐ |
| 3 | SLO 卡 | ≥3 条 SLO + 错误预算 + 告警路由 | <路径> | ☐ |
| 4 | 培训材料 | 题纲 + 练习 + 自测题(能让客户自己再教别人) | <路径> | ☐ |

## 附加(建议但非硬性)
| # | 交付物 | 说明 | 状态 |
|---|---|---|---|
| 5 | 值班交接卡 | 有多班次则必需 | ☐ |
| 6 | 退场计划 | 见 §2.12 | ☐ |
| 7 | 技能卡 | 见 §2.13 | ☐ |
| 8 | 数据与配置清单 | 数据在哪、密钥怎么配、环境怎么重建 | ☐ |

## 知识转移验证
- ☐ 客户方 <姓名> 已能独立执行:重启 / 回滚 / 看告警
- ☐ 客户方 <姓名> 已能独立重跑评估并解读结果
- ☐ **盲测通过**:未参与项目的同事,仅凭 Runbook 完成一次事件处置

## 签字
客户方验收人 ______  日期 ______  我方 ______  日期 ______

工具路径:

fde-scope handoff <id> --eval-report <报告路径> --training-material <材料路径> --accept

2.11 验收清单(⭐G7 · 📅D7)

对应委托单第 3 节"成功标准"。逐条对照,不许新加标准,也不许悄悄放宽。

# 验收清单 · <客户名> · <日期>

| # | 委托单原定标准 | 实测值 | 是否达标 | 证据位置 |
|---|---|---|---|---|
| 1 | 意图分类准确率 78% → ≥91% | <91.5%> | ✅ | <评估报告 §2> |
| 2 | 重复工单占比 60% → ≤42% | <44%> | ⚠ 未达标 | <工单系统周报> |
| 3 | 平均处理时长 8min → ≤5min | <4.7min> | ✅ | <工单系统导出> |

## 未达标项处置
- **第 2 项**:实测 44%,差 2pt。原因:<改动上线仅 3 周,样本窗口不足>
- 处置方案:<延期 2 周复测;若仍不达标,按委托单变更规则重新评估范围>
- **客户是否接受**:<是 / 否>  客户意见:<"认可,同意延期复测">

## 验收结论
- ☐ 达标项由客户确认(口头/邮件/会议纪要均可,需记录)
- ☐ 未达标项已书面说明并有处置方案
- ☐ 系统已移交,客户可直接使用

## 签字
客户方验收人(姓名/角色):__________  签字/确认:__________  日期:__________
交付方:__________________________  日期:__________

2.12 退场计划(⭐G7 · 📅D7)

没有退场计划的交付 = 无限售后。 写清楚"我什么时候走、走了以后怎么办"。

# 退场计划 · <客户名> · <日期>

## 1. 移交范围
- 移交内容:<系统代码/配置/数据/文档/账号权限>
- 接收方:<客户 IT 团队,负责人 <姓名>>
- 移交方式:<仓库权限转移 / 部署脚本 + 环境说明会>

## 2. 支持安排(阶梯式递减)
| 阶段 | 时间 | 我方承诺 | 响应时限 | 渠道 |
|---|---|---|---|---|
| 密集支持 | 0–30 天 | 工作日在线,参与周会 | P0:1h / P1:4h | <群 + 电话> |
| 过渡支持 | 31–60 天 | 每周一次固定同步 | P0:4h / P1:1 个工作日 | <群> |
| 收尾 | 61–90 天 | 仅重大故障(P0)支持 | 1 个工作日 | <电话> |

## 3. 终止条件(什么时候彻底结束)
- <例:连续 30 天无 P0/P1 事件,且客户累计独立处理 ≥3 次事件>
- <例:客户已完成全套 Runbook 盲测,且自建值班表>
- <例:我方支持联系人变更为"仅重大问题"模式>

## 4. 知识资产归属
- 代码/配置/文档:<归客户所有>
- 方法论沉淀(脱敏后):<归我方,用于技能库>
- **客户数据**:<不带走任何真实数据;仅保留脱敏统计结果,需客户书面同意>

## 5. 未决事项与风险
| 事项 | 状态 | 谁负责 | 何时关闭 |
|---|---|---|---|
| <多意图口径未决> | 开放 | 客户产品 | <日期> |
| <长尾准确率仍偏低> | 已知局限 | 客户 | 走客户自有飞轮迭代 |

## 6. 复购/续约触发条件(可选)
- <若客户二期扩展到"退换货全流程",可重新评估>
- <提前接入第二场景可复用 70% 现有语料与评估集>

签字:客户方 ______  我方 ______  日期 ______

2.13 技能卡(⭐G7 · 📅D7)

FDE 的复利资产。每做完一个项目,把可复用的东西写成卡,存进技能库。 五要素:场景 → 问题 → 做法 → 证据 → 适用边界。最后一条最重要——不写边界的技能卡是坑人。

# 技能卡 · <标题:客服场景长尾类别补盲>

## 场景
<新茶饮连锁客服工单意图分类;数据以物流查询为主,退款/会员/退换货类样本近乎为零。>

## 问题
<长尾类别准确率仅 61%,整体被拖累;客户不允许更换模型。>

## 做法
<1. 用本体概念清单做概念级覆盖度检查,而非关键词匹配;
2. 对覆盖不足的概念,按业务规则枚举模板 + 少量真实样本改写,生成 <4,000> 条候选;
3. 全部候选过同一质量门(长度/完整度/语言/重复度),淘汰 <35%>(保留约 <2,600> 条进语料);
4. 合成比例如实标注在报告中,不混入真实计数。>

## 证据
<- 合成后长尾类别准确率 61% → 88%(同一测试集 <200> 条)
- 报告路径:<reports/corpus_report.html>
- 复现命令:`fde-scope corpus --input <路径> --ontology --out <报告>`>

## 适用边界(⚠ 必填)
<- 适用:规则明确、可枚举的封闭业务场景(退款规则、会员等级)
- 不适用:开放式创意类、强合规场景(医疗诊断、法律意见)
- 前提:必须有 ≥20 条真实种子样本;零种子时纯合成不可信
- 副作用:合成比例 >20% 时,需额外人工抽检,成本上升>

工具路径:

fde-scope skill add --title "客服长尾类别补盲" --category methodology \
  --tags "corpus,synthetic,longtail" --body-file card.md \
  --phase corpus            # --phase 用真实阶段 slug,见 §3.4
fde-scope skill publish <skill-id>                       # 发布进团队技能库
fde-scope skill review                                   # 助教审核(课程内)
fde-scope skill export <skill-id> --format agentscope    # 导出成可复用格式

--category 四选一:research / implementation / optimization / methodology(技能卡用 methodology)。 --phase / --gate 填真实 slug(见 §3.4 与 §3.2)——填错的卡能被创建,但 skill list --phase/--gate 检索不到。


2.14 作品集索引页(⭐G8 · 📅D8)

第一屏。面试官/老板只看一页的时候,看到的是这张表,不是你的过程。 八件产出,每件一行:产出 / 日期 / 证据链接 / 一句话价值(含数字)。

# 作品集索引 · <你的名字> · <日期>

> 全部产出基于虚构演示场景(茶饮连锁客服),数据与客户名均为虚构。
> 完整详版与模板说明见 `10-变现路径与结营包.md` §2。

| # | 产出(与 [`README`](README.md) §3 官方 8 件同源) | 交付区 | 日期 | 证据链接 | 一句话价值(含数字) |
|---|---|---|---|---|---|
| 1 | 迷你链路跑通证据 + FDE 一页纸世界观 | 入门日 | D1 | <路径/链接> | 跑通 connect→corpus 全链路,报告 N 条记录;能 3 行白话讲清做了什么 |
| 2 | 客户委托单 Engagement Charter(画像 / 干系人地图 / 成功标准) | A · 定边界 | D2 | <路径/链接> | 干系人 5 类含 2 位发起人,成功标准 3 条全部可度量,防住 Sponsor Collapse |
| 3 | 数据体检报告(字段 / 缺失 / PII / 分布) | B · 接数据 | D3 | <路径/链接> | 32,400 条原始记录 → 识别 8,900 条 PII 候选与 3 类覆盖盲区,结论"有条件能做" |
| 4 | 语料锻造报告 + 对客户的话术 | B · 造语料 | D4 | <路径/链接> | 32,400 → 21,800 条可用语料,补 3 类盲区;话术约 150 字零术语 |
| 5 | 可演示原型 + 评估结果 + 3 个 bad case | B · 验证与评估 | D5 | <路径/链接> | 准确率 78% → 91%;坏案 Top3 均附"根因假设 + 下一步动作";含一页验证记录 |
| 6 | Runbook + SLO 卡 + 值班交接卡 | C · 稳得住 | D6 | <路径/链接> | 3 条 SLO 含错误预算;Runbook 覆盖 5 类事件含回滚,凌晨 2 点盲测通过 |
| 7 | 交接包 Handoff Package + 1 条技能沉淀 | D · 交得出去 | D7 | <路径/链接> | 四件套齐全含签字人;退场计划含 30/60/90 天阶梯与终止条件 |
| 8 | 作品集三套包装(求职版 / 内部汇报版 / 接单版) | 变现日 | D8 | <路径/链接> | 三套包装共用同一证据链;答辩评分 <A/B/C> |

## 我的一句话总结
<8 天里我把一个虚构茶饮客服场景,从 32,400 条脏数据做成了可交接的系统,
关键指标 78% → 91%,并且写清楚了它适用什么、不适用什么。>

2.15 D8 四件套速用骨架

这里是速用版(填空骨架)。完整说明、示例与纪律要求以 10 §3–§6 为准。 凡本小节与 10 不一致,以 10 为准。

① 简历段落(3–5 行)

在 <场景> 中,为 <客户类型> 完成 <端到端交付>:从 <N 条脏数据> 锻造出 <M 条可用语料>,
<指标> 从 <X> 提升到 <Y>,并以 <Runbook/SLO> 支撑 <上线/交接>;交付 <件数> 件可验证产出。

三条纪律:① 每个数字能在作品集里指到出处;② 没跑过的数字不写;③"演示/虚构案例"标注不许删。

② STAR 故事(成功 / 失败 / 取舍 各一)

S 场景:<虚构客户 + 一句话业务背景>(1 句)
T 任务:<你要定义/交付什么,成功标准是什么>(1 句)
A 行动:<你做了什么关键决策,为什么这么决策>(2 句)
R 结果:<数字结果 + 证据在哪 + 如果重来会改什么>(2 句)

失败故事句式(不许甩锅环境/客户):"我当时假设了 <X>,证据显示 <Y>,代价是 <Z>,现在的我会先 <做法>。"

③ 一页纸汇报(内部汇报版)

# <项目名> 一页纸 · <日期>
## 价值(客户得到什么)
- <一句话结论,含 1 个业务口径数字>
## 证据(凭什么信)
- 主指标 + 基线对比:__ → __(证据:<链接/路径>)
- bad case 收敛:__ 条 → __ 条(Top3 已附动作)
- 验证记录:向 <角色> 演示 <N> 次,接受 <N> / 拒绝 <N>(理由见附件)
## 下一步要什么(明确 request)
- 决策请求:<继续投入 / 扩大范围 / 进入交接>,需要 <角色> 在 <时间> 前拍板
- 已知风险与不确定项:<如实列出,含缓解动作>

④ 服务清单(接单版)— 六个服务项与"不适用"信号见 10 §6 表格。

一条纪律:先报"不适用"再报"适用"——敢劝退的乙方才有议价权。 红线:不得使用真实客户名、真实数据;不得把课程内部资料作为交付物转售。


3. 概念 → 命令映射

左边是你想干的事(白话),右边是敲什么。全部命令在仓库根目录、已激活虚拟环境下执行。 环境准备见 11 §2;命令报错见 11 §3.2。

3.1 按"我想干什么"查

我想…… 命令
看看系统支持哪些行业配置 fde-scope profiles
看看客户数据长什么样、哪些字段名像 PII fde-scope connect --type csv --source <路径>
不想真跑,只想看会发生什么 4 个命令支持 --dry-run:connect / corpus / deploy / flywheel(其余命令加 --dry-run 会报 No such option)
把脏数据锻造成可用语料,出报告 fde-scope corpus --input <路径> --out reports/corpus_report.html
语料里补长尾盲区(用概念体系检查覆盖) fde-scope corpus --input <路径> --ontology --out <报告>
用大模型生成补盲样本(需 key) fde-scope corpus --input <路径> --llm --out <报告>
评估效果(练流程,零 key) fde-scope eval --agent mock --test-set <test_set.jsonl>
评估效果(真模型,需 key) fde-scope eval --agent mimo --test-set <test_set.jsonl>
算客户业务指标(工单下降、拦截率) fde-scope kpi <engagement-id> --samples <样本.jsonl>
采集线上坏案、喂回语料(飞轮) fde-scope flywheel --agent <agent-id> --events <事件.json>
装配交接包(Runbook 等) fde-scope handoff <engagement-id> --accept
生成 Runbook 时让模型起草 fde-scope handoff <engagement-id> --llm --accept
用图形界面看客户档案与门禁 fde-scope web(默认 http://127.0.0.1:8080)
换端口(8080 被占用) fde-scope web --port 8081
造一批演示数据(10 个虚构客户) python examples/seed_mock_engagements.py

3.2 交付项目与门禁

我想…… 命令
新建客户交付档案 fde-scope engage init --customer "<客户名>" --profile ticket
指定档案 id fde-scope engage init --customer "<客户名>" --profile ticket --id <自定义id>
看当前在哪个阶段、门禁状态 fde-scope engage status <id>
推进到下一阶段(门禁自动重评) fde-scope engage advance <id>
门禁没过但必须推进(会留下记录) fde-scope engage advance <id> --force
退回到之前某阶段 fde-scope engage rollback <id> --to <phase>
列出所有进行中的档案 COLUMNS=200 fde-scope engage list(不加 COLUMNS 时 id 列会被截断,抄不全)
记一条现场笔记 fde-scope engage journal <id> --kind research --note "<记录内容>"
查看现场笔记 fde-scope engage journal <id>
记笔记时关联技能卡 fde-scope engage journal <id> --note "<内容>" --link-skill <skill-id>
看系统里全部 10 个门禁 fde-scope gate list(两个 profile 都印全部 10 行,不是少印几行;第 3 列 industrial_only 用 🏭 / 🏢 标出哪些是工业专属。--profile 只改标题那一行)
查某个档案的全部门禁结论 fde-scope gate check <id>
只查某一关 fde-scope gate check <id> --gate <gate-slug>

--kind 三选一:research(调研)/ implementation(实施)/ optimization(调优)。

--gate 可用的 slug(共 10 个):success_criteria · slo · handoff_signoff(通用 3 个); site_survey · fat_sat · functional_safety · conformity · works_council · air_gap · shift_handover(工业专属 7 个,见 gate list 第 3 列的 🏭)。 填错 slug 会直接报 Unknown gate——故意不静默放过。

⚠️ 一个要命的坑:在 ticket 档案上手动 gate check <id> --gate site_survey,你会看到 ✅ PASS—— 那是"没有可检查的数据"的空过,不是你通过了工业门。别把这个 ✅ 当成证据写进作品集 (ticket 档案根本走不到工业阶段,03 §3 的门禁表里也没有这 7 关)。 同理 gate check <id>(不带 --gate)在 qualification 阶段会直接说 Phase 'qualification' has no gate.——这是正常输出,不是报错。 判断"我该过哪几关"只认 03 §3 的 G0–G8 课程门禁,那是本课程自己的一套, 与工具里的 10 个门禁同名不同源——两套门禁的对照表见 03 §1.1。

拿来就能抄的档案 id(不用自己编)

上表里的 <id> 不是让你现编一个。11 §3.1 那条 python examples/seed_mock_engagements.py 已经在本机造好了 10 个虚构档案(全部虚构,脚本内附免责声明)。跑过 seed 之后,直接抄下表第二列的 id 就能用:

# ⚠ 必须加 COLUMNS=200:默认终端宽度下 id 列会被截断成 eng-adnova-t…
COLUMNS=200 fde-scope engage list
id(可直接复制) 客户(虚构) profile 当前阶段 门禁 适合拿来练什么
eng-teaverse-ticket-seed01 茶语万象(Teaverse) ticket disengage(终点) ✅3 "跑完长什么样":三个通用门禁全绿,交接档案最全(13 条现场记录)
eng-adnova-ticket-seed06 星澜科技(Adnova) ticket success_criteria ❌1 "被门禁拦住长什么样":advance 会被拒(只有 1 个发起人)
eng-southbay-manufacturing-seed03 南湾汽车集团(Southbay Motors) manufacturing deploy ✅3 ❌3 工业 profile 的 18 阶段 + 工业门禁(fat_sat / functional_safety / conformity 未过)
eng-aurora-manufacturing-seed07 奥罗拉汽车(Aurora Motors) manufacturing change_mgmt_training ✅8 ❌1 工业线走得最远的一个(仅 conformity 未过)
eng-atlas-manufacturing-seed02 亚特联汽车(Atlas Auto Alliance) manufacturing runbook ✅9 门禁全绿的工业样本,适合对着抄材料
eng-horizon-manufacturing-seed08 宏途汽车(Horizon Auto) manufacturing connect ✅3 早期阶段的工业档案
eng-northern-ticket-seed04 北疆汽车集团(Northern Auto) ticket flywheel_productization ✅2 运营区的 ticket 档(看飞轮/技能沉淀)
eng-whitelake-ticket-seed10 白湖乳业(Whitelake Dairy) ticket slo_sla ✅3 slo 门禁刚过,看 SLO 卡长什么样
eng-riverbend-ticket-seed09 河湾酒业(Riverbend Spirits) ticket corpus ✅1 正卡在语料阶段,适合练 corpus
eng-swift-ticket-seed05 迅捷出行(Swift Ride) ticket prototype_real_data ✅1 正卡在原型阶段(防 Demo-Debt)

推荐第一条练习(把"看状态"这件小事变成一次完整的观察):

COLUMNS=200 fde-scope engage list                          # 先看到 10 个 id
fde-scope engage status eng-teaverse-ticket-seed01          # 看"做完的"长什么样
fde-scope engage status eng-adnova-ticket-seed06            # 看"被拦住的"长什么样
fde-scope gate check eng-adnova-ticket-seed06               # 看门禁到底在抱怨什么

💡 两个预期行为,不是 bug:

  1. 表里 id 列窄了会截断成 eng-adnova-t…——加 COLUMNS=200 即可(或把终端窗口拉宽)。
  2. gate check / advance 在门禁被阻塞时会自动把这次阻塞沉淀成一张草稿技能卡(提示 💡 已把这次阻塞沉淀为草稿 skill-xxxxxxxx)。这是飞轮设计:阻塞本身就是知识。多跑几次会攒下几张草稿,用 fde-scope skill review 看待审队列,或用 fde-scope skill archive <skill-id> 清掉不想留的。

⚠ 必须在仓库根目录运行。数据目录按"当前目录有没有 .fde_scope/"来定位:换到别的目录再执行,命令不报错但会显示 No engagements yet.(看着像 seed 失效,其实只是找错地方)。从别处运行的话用 FDE_SCOPE_HOME=<仓库绝对路径> fde-scope …。

3.3 技能卡与知识沉淀

我想…… 命令
新建技能卡(正文从文件读) fde-scope skill add --title "<标题>" --category methodology --body-file card.md
新建技能卡(正文直接写) fde-scope skill add --title "<标题>" --category methodology --body "<正文>"
带标签与关联 fde-scope skill add --title "<标题>" --category methodology --tags "corpus,longtail" --engagement <id> --gate <slug>
看技能卡列表 fde-scope skill list
按阶段/门禁/标签检索 fde-scope skill list --phase corpus --tag longtail
全文搜索 fde-scope skill list --search "补盲"
看某张卡 fde-scope skill show <skill-id>
改一张卡的标题/标签/正文 fde-scope skill edit <skill-id> --title "<新标题>" --tags "a,b" --body "<新正文>"
发布进团队库 fde-scope skill publish <skill-id>
看待审草稿队列 fde-scope skill review
归档 fde-scope skill archive <skill-id>
导出成 AgentScope / QwenPaw 格式 fde-scope skill export <skill-id> --format agentscope

⚠ 技能卡 id 由系统生成,不能自己指定(schema 层已封死)。 ✅ skill list --status 可筛 published / draft / archived。

3.4 概念 → 阶段映射(18 阶段全表)

18 阶段按四区划分(A 定边界 / B 造出来 / C 稳得住 / D 交得出去)。 标 ⚙ 的 3 个是工业专有阶段:--profile ticket 下自动跳过,所以 ticket 走 15 阶段。

# 区 阶段 slug(--phase 用这个) 白话 你在这里产出
1 A qualification 值不值得做? 资格判断结论
2 A site_survey ⚙ 去现场看真实业务(Gemba walk) 现场笔记(engage journal)
3 A stakeholder_map 认清谁在乎什么 干系人地图(委托单 §2.1 第 2 节)
4 A success_criteria 把"做完"谈清楚 成功标准 + 放弃标准(委托单 §2.1 第 3/6 节)
5 B connect 数据接进来 字段预览 + PII 字段名标记
6 B corpus 把数据洗成能用的语料 数据体检 §2.2 + 语料报告与话术 §2.3
7 B prototype_real_data 在真实脏数据上做原型 原型 + 落差记录(防 Demo-Debt)
8 B validate 拿给真实干系人看 验证记录 §2.6
9 B deploy ⚙ 装上产线(工业走 FAT→SAT) 上线确认
10 B eval 用数字证明有效 测试集 §2.4 + Bad Case §2.5
11 C slo_sla 定稳定性承诺与值班 SLO 卡 §2.7
12 C runbook 写清出事怎么办 Runbook §2.8 + 值班交接卡 §2.9
13 C monitoring_drift 盯住"悄悄变差" 监控与漂移看板
14 C change_mgmt_training ⚙ 培训 + 工会共决 培训材料
15 C flywheel_productization 让经验回流、越用越好 技能卡 §2.13
16 D ops_handoff 运维责任移交 交接包 §2.10
17 D knowledge_transfer 知识交出去 培训材料 + 文档包
18 D disengage 体面撤退 验收清单 §2.11 + 退场计划 §2.12

查当前阶段的命令:fde-scope engage status <id>(会显示当前阶段 slug 与门禁状态) 查某 profile 的完整阶段序列:fde-scope engage init --customer "tmp" --profile ticket 建一个临时档案—— ⚠ id 不是你起的名字:--customer "tmp" 生成的 id 是 eng-tmp-ticket,不是 tmp。 建完先 COLUMNS=200 fde-scope engage list 确认 id,再 fde-scope engage status eng-tmp-ticket、逐级 advance 观察; 方法论文档见 docs/fde_sop_full.md。

3.5 出错时的含义(速查)

现象 含义 怎么办
fde-scope: command not found 虚拟环境没激活,或装错环境 见 11 §3.2 第 1–2 行
命令退出码 2 + 提示缺 key 该命令需要 LLM(corpus --llm / eval --agent mimo / handoff --llm) 去掉 --llm/改用 mock 走规则路径,或按 11 §4.3 配 key
门禁 blocker 不过,advance 被拒 门禁在正常工作 补齐材料重跑 gate check;确认无法补齐再用 --force(留记录)
Refusing to bind non-loopback web 默认拒绝对外暴露(安全设计) 见 11 §6.5:局域网演示需两步同时做,演示完关掉
网络错误但流程继续跑 LLM 自动降级到规则路径(设计如此) 检查报告里的来源标记;要真实模型结果需配 key
engage list 显示 No engagements yet.(没报错) 你不在仓库根目录。数据目录靠"当前目录下有没有 .fde_scope/"定位,换目录后就找不到了 cd 回仓库根目录;或从别处用 FDE_SCOPE_HOME=<仓库绝对路径> fde-scope …,见 §3.2
engage list 的 id 是 eng-adnova-t… 这种带省略号的 终端宽度不够,Rich 把列截断了(不是数据损坏) 命令前加 COLUMNS=200:COLUMNS=200 fde-scope engage list
跑完 gate check / advance 后技能卡多了一张 skill-xxxx 草稿 飞轮设计:门禁阻塞被自动沉淀成知识 预期行为。想看就 fde-scope skill review,不想要就 fde-scope skill archive <skill-id>
eval 的 intent_accuracy 恒为 0.000 判分是子串匹配,而 mock 回复里没有类别名 不是 bug:先删掉 expected_category 或改用 --agent mimo,见 §2.4
eval 指标是 3.000 / 1.000 / 0.000 这类整数 没填对应字段,这是默认值不是实测值 对照 §2.4「读表前必看」那张表,别把默认值写进作品集

4. 门禁速查一览(G0–G8)

判定语义(blocker/warning)见 03 §3,明细判分标准见 §4。 此表用于快速定位:"这一关我要交什么、怎么生成"。

门 时间 核心 blocker(必须过) 模板 关键命令
G0 入学门 开营前 环境自检通过(契约与雷达是 warning,可开营后补) 11 §3.1 python3 --version / fde-scope --help
G1 冒烟门 D1 connect + corpus 跑通且报告存在;能白话解释做了什么 — fde-scope connect … → fde-scope corpus …
G2 边界门 D2 成功标准 ≥3 条全可度量;干系人含 ≥2 位发起人 §2.1 委托单 fde-scope engage init … / gate check
G3 数据门 D3 字段清单含类型/缺失率;PII 清单与处置;明确结论 §2.2 体检报告 fde-scope connect …
G4 语料门 D4 报告数字与实际一致;覆盖盲区说明与补盲策略;话术 ≤200 字零术语 §2.3 客户话术 fde-scope corpus … [--ontology/--llm]
G5 证据门 D5 评估可复现(同命令同结果);Bad Case Top3 各附下一步动作 §2.4 / §2.5 / §2.6 fde-scope eval --agent mock --test-set …
G6 稳运门 D6 Runbook 5 类事件每类含回滚;SLO 卡含错误预算;通过凌晨 2 点盲测 §2.7 / §2.8 / §2.9 fde-scope handoff <id>(生成骨架)
G7 交接门 D7 交接包四件套齐全;验收清单含签字人 §2.10 / §2.11 / §2.12 / §2.13 fde-scope handoff <id> --accept / skill add
G8 结业门 D8 G1–G7 至少 6 关通过;作品集 8 件完整;完成答辩与等级判定 §2.14 / §2.15 —(人工评审,见 03 §5)

权重提醒:作品集 60% + 答辩 25% + 互助出勤 15%(03 §2)。 等级:判定条件以 03 §6 为唯一口径——A 级 = 8 件齐全 + 平均分 ≥9/12 + 无未达项;B 级 = 8 件齐全 + 平均分 ≥7/12;C 级 = 缺 ≤2 件或平均分 <7/12(发完课证明,非证书)。 诚实边界:本课程不承诺就业、不承诺收入;证书只证明"你在课程内完成了什么"(03 §6、08 §11)。


5. 找不到答案时

问题类型 去处
"今天要交什么?" 06 当日任务卡
"这个门禁怎么判分?" 03 §4
"环境/装包/报错/合规" 11
"这个概念到底啥意思?" 回到本文件 §1
"答辩会被问什么?" 10 §7(20 题题库)
"案例里的客户是谁?" 07(全部虚构)
"方法论原文在哪?" docs/fde_sop_full.md · docs/fde_playbook.md

三条纪律(与 10 §3 一致):① 每个数字能指到出处;② 没跑过的数字不写;③"演示/虚构"标注不许删。

13 · GTM 页面与竞品对比

13

course-level-1/13-GTM页面与竞品对比.md

本文件回答两个问题:对外怎么讲(§1–§3、§7,可直接粘贴的招生页)+ 和网上已有的 FDE 课程比,好在哪、差在哪(§4–§6 横向对比)。 交付形态与成本算法 → 04|招生话术纪律 → 08 §2.1 / §11|"变现"口径 → 10 §1、§8


0. 怎么用这份文件,以及引用纪律

内容 纪律
§1–§3、§7(我们自己的说法) 可直接粘贴到招生页 / 公众号 / 私聊。限制语不得改动("不承诺就业/收入""案例均为虚构")
§4–§6、§8(竞品情报) 每个数字都带来源与查证日期;拉不到就写"未取回",不许估;源间冲突标 ⚠ 不定论

为什么这么严:这门课自己就在教证据链(00 §6 引用纪律)。 招生页上的每个竞品数字,学员都会去核对——一句话吹牛,整门课的诚实人设就没了。

来源等级(沿用认证中心 /certification 页的标注惯例):

等级 含义
官方 机构自己页面上的原话
媒体转述 第三方报道,未见机构页面确认
广告稿 自曝为推广 / 招商内容,只作线索不作证据
未取回 页面 403 / 500 / 证书错误,正文未读到

查证基准日:2026-09-30。价格与时长变得最快,超过 90 天建议整表重核。


1. GTM 页(可直接粘贴)

1.1 一句话

这门课不解释 FDE,只炼金——8 天,把 4 区 18 阶段的交付链路亲手走一遍,带走 8 件拿得出手的产出。

1.2 电梯稿(30 秒版)

市面上的 FDE 内容大多停在"概念解释":FDE 是 Palantir 发明的、薪资很高、要懂技术又懂业务。
这些话没错,但解释不等于会用。

这门课用 8 天,让你亲手跑通一条完整的交付链路:
定边界 → 接数据 → 造语料 → 验证评估 → 运维化 → 交接沉淀 → 变现。

每天一道门禁,每天交一件老板和客户看得懂的产出。
第 8 天你手里不是笔记,是一套作品集,和一套话术。

不需要会写 Python,不需要 API key,也不需要换掉你现在用的工具。

1.3 三条卖点(每条都能当场验证)

  1. 门禁是工程,不是清单。 通关不是"看完了、考过了",而是产出物过机器校验 + 讲师按量表打分。 线上可当场演示:推进阶段时门禁实时复评,条件不满足就 blocked——不是靠自觉。
  2. 零门槛、零 key。 全链路核心证据不需要 API key、不需要 Docker、不需要 GPU,本机可跑; LLM 只是可选加速(关掉它整条链路照样走通)。对照:多数认证课要求 Python / 云基础先修。
  3. 交出去的是作品集,不是结业证。 8 件产出里有 Runbook、SLO 卡、值班交接卡、交接包—— 是接手的人真正要读的东西,不是"我学过"的证明。

三条都能被验证,而"验证方式"本身写进了课程: 03 §4 评分量表、11 §4.1 无 key 路径。

1.4 时间承诺(只说能核对的口径)

以 02 的逐日时长为准(可逐条核对):

天 投入 形态
D1 入门日 6 小时(上午 3h + 下午 3h) 线上直播
D2–D8(每天) 直播 90 分钟 + 自练 45 分钟 = 2.25 小时 直播 + 任务卡
整期合计 约 22 小时 8 天

排期与形态(连续 8 天 / 隔天 2 周 / 4 周自学 / 企业 3 天压缩)→ 04 §2。

✅ 口径已统一:早期 README 开头的"16–20 小时"是按均值粗估的口径, 现已改为与 02 一致的约 22 小时(D1 = 6 小时 + D2–D8 每天 2.25 小时)。 对外一律用本表的逐日口径——它能被逐条核对,而"16–20 小时"不能。

1.5 价格与档位(按 04 §1.2)

四档,其中一档真免费——这是 2026-09 起对外可以说的话:

档位 形态 包含什么 对外怎么报价
L0 免费公开版 B 的公开子集 网页版全部课文 + 工具链 + 自学路径 ¥0,永久免费;不设名额、不用报名。可以写进招生页
L1 标准档 A. 线上直播训练营(默认) 8 天直播 + 助教 1:15–20 + 每日门禁 + 答辩评级 + 证书 + 结营包 按 04 §1.1 的公式逐期算;对外说"档位 + 预约沟通"
L2 影子项目档 D. 影子项目(加档) L1 全部 + 真实小场景准入 + 导师 ≤1:3 + 脱敏双签产出 一例一议;对外说"需先完成 L1 且通过准入四件套"
L3 企业内训档 C. 企业内训 3 天集中 + 1 周作业 + 客户脱敏场景 + 内训考核对接 + 对公发票 项目制报价;对外说"按人天费率 × 人数 + 定制案例人时"

对外话术的三条边界:

  1. L0 的数字可以直接说(¥0),因为它不依赖任何未定变量。
  2. L1–L3 只说结构,不说数字——成本公式逐期不同,写死会变成承诺(算法见 04 §1.1)。
  3. 不说"起价"。"¥X 起"仍然是数字,仍然会被当成承诺,仍然要逐期兑现。

这一条已经从劣势变成部分补齐:竞品多数明码标价(见 §4.4),我们现在能公开 L0 的价格、 四档的包含项与不包含项、以及每期招生页必须给出的三件事(04 §1.2)。 仍未补齐的部分:L1–L3 没有公开数字。已记入 §6 第 6 项。


2. 适合谁 / 不适合谁

适合 不适合
刚入职 / 即将入职的 FDE、交付工程师(企业内训尤佳) 想学模型训练、微调、算法竞赛的人
想转型的技术人:测试、运维、前端、数据、后端 完全不碰电脑、不愿敲命令行的人
想进 AI 交付赛道的应届生、产品经理、售前、实施 只想听概念、不做作业的人
已在客户现场、但总在"救火"没有章法的工程师 期待"包就业 / 包涨薪"的人

先修要求(很低):能装软件、能复制粘贴命令行、能读懂表格。不需要会写 Python。


3. 学完拿走什么

8 件产出(作品集):迷你链路证据 + 世界观 → 客户委托单 → 数据体检报告 → 语料报告 + 话术 → Demo + bad case → Runbook + SLO + 值班交接卡 → 交接包 + 技能卡 → 作品集三套包装。

9 道门禁(G0–G8):每道门禁 = 产出物 + 证据 + 讲师按 03 §4 量表打分; "诚实标注"得 0 分一票否决,用真实客户数据练习也一票否决(作品失效 + 证书取消)。

结业等级:A / B / C 三档,按产出完整度与平均分评定,标准见 03 §6。


4. 横向对比

4.1 用这五个维度比

选维度比"比谁家内容多"有用。买 FDE 课的人真正要判断的是这五件事:

  1. 投入——能不能排进我的日程(几小时 vs 几个月)
  2. 动手程度——听讲 / 看视频 / 交作业 / 亲手跑通一条链路
  3. 产出物——学完手里有什么(笔记?证书?能演示的东西?)
  4. 评估方式——怎么证明学会了(看完?考试?产出过校验?)
  5. 背书——发不发第三方证书、雇主认不认

外加一个价格维度,因为它是唯一的硬数字。

4.2 国际课程

课程 提供方 形式与时长 评估 / 证书 价格 来源等级
Certified Forward Deployed Engineer (CFDE) ADaSci 30 小时 · 7 模块 · 自定进度 60 题监考考试 · 终身有效 US$164.99 官方
Certified FDE GSDC 9 模块(第三方汇总记 13 ⚠)· 自定进度 + 直播 40 题 / 90 分钟 / 65% 通过 · 5 年有效 US$0–500 ⚠ 官方
Forward Deployed Engineering Bootcamp Maven(Hamza Farooq) 4 周 · 直播班 未提及认证 未取回 官方
Forward Deployed AI Engineering DeVenture Academy 140–180 小时 · 在线自定进度 未提及认证 免费起步 / Pro US$29 每月 官方
FDE AI Training NovelVista 80 小时 · 直播训练营 作品集 + 小组评估认证 未取回 官方
FDE Course School of Core AI 6 个月 · 讲师带班 未提及认证 未取回 媒体转述
Advanced FDE Program(含 8 个月 PGP) FDE Academy 冲刺 / 队列 招聘池对接 "最大投资"(未公开标价) 媒体转述
AI FDE Bootcamp Krish Naik 5 个月 · 直播 未提及认证 ₹10,000 官方
AI for Forward Deployed Engineers Maven 3 小时 · 直播工作坊 无 未取回 官方
Forward Deployed Engineer for AI Systems Educative 交互式文本课 无 未取回 媒体转述
Certified FDE (CFDE) AIU 在线班 · 三级 入学前技能检查 未取回 媒体转述
Forward Deployed Engineering in the Age of AI LinkedIn Learning 在线课 无 未取回 媒体转述
FDE Mastery / FDE 2026 / Forward Deployed AI Engineer Udemy(多门) 自定进度视频 无 未取回(站点 403 反爬) 未取回

读这张表要注意的三件事:

  • ⚠ ADaSci 价格源间冲突:官网标 US$164.99;AIM 榜单记 US$249。以官网为准,不定论(另有更高档 "CFDE Pro",价格未在页面显示)。
  • ⚠ GSDC 模块数冲突:官网页记 9 模块,第三方汇总记 13 模块。以官网为准。
  • "未取回"不是"没有":是页面拉不到(403 / 反爬 / 未公开标价)。不代表免费或昂贵。

4.3 国内 · 政府与院校侧

项目 主办 时间 对象与规模 来源等级
上海首期 FDE 专题培训 市委组织部、市经信工作党委、市经信委、市教委、市委党校、上海创智学院 2025-12 开讲、2025-12-21 收官 目标是"快速提升对 FDE 模式的战略认知与规划布局能力" 官方
全国首个 FDE 培训班 上海(创智学院) 2026-01 报道 年内培养 200 名 媒体转述(标题所述,正文未取回)
徐汇首期 FDE 专题培训 徐汇区 · 创智学院 2026-02 媒体报道称"打造 AI 落地'特种兵'" 官方
上海市企业技术中心 FDE 通识班(第一期) 上海市产业技术创新促进会、上海市人工智能行业协会 2026-09-22 开班 逾 30 家企业技术中心负责人;目标"培养 FDE 骨干人才" 官方
山东省首期 FDE 培训班 国家超级计算济南中心 2026-07 报道 — 未取回(TLS 证书错误)

通识班首日 5 场课程(公开报道口径,列出四门主题课): 《生成式人工智能应用与 FDE 导论:从 AI 能力走向真实业务问题》、 《AI 时代生产方式变革与一线作战能力升级》、 《企业大模型落地之道与典型场景应用实践》、 《从场景到价值:企业级 AI 落地的实践路径与案例专题》。

这张表对我们的意义:官办项目目前主要解决"认知与布局"(对象是企业技术中心负责人、组织部长线), 我们解决"手上会不会做"(对象是干活的工程师,交付物是 8 件产出)。 两者不是竞品关系,是上下游——这恰好是 §5 第 8 条优势,也是企业内训(形态 C)的天然话术。

4.4 国内 · 商业培训侧

机构 课程 时长 价格 证书 来源等级
职坐标 AI FDE 前沿部署工程师 4–5 个月 ¥5,000–29,000 未列明 广告稿
开课吧 未列明 未列明 未列明 未列明 广告稿
华为云培训中心 未列明 未列明 未列明 未列明 广告稿
赛迪教育 未列明 未列明 未列明 未列明 广告稿
达内教育 未列明 未列明 未列明 未列明 广告稿
苏州瑞塔 未列明 未列明 ¥3,800–15,800 工信部教育与考试中心 媒体转述
三维天地 × 大连理工大学 企业 FDE 转型与智能体工程交付实战培训班 5 天 未取回 大连理工大学 媒体转述
uml.org.cn AI Agent 开发 10–12 天 未取回 未列明 媒体转述

⚠ 这张表的证据强度明显低于 §4.2,必须说清楚:

  • 那份"5 家机构推荐"清单自曝是广告稿(推广职坐标),5 家里只有 1 家写了课程名和价格,其余 4 家只有一句目标人群。不能当市场行情用。
  • 苏州瑞塔、三维天地、uml 三家的价格拉不到,只有时长和证书信息。
  • 所以:"国内 FDE 培训多少钱"目前没有可靠答案。我们能公开说的是"有 ¥3,800 起的、也有 ¥29,000 的",而不是"市场价是 X"。

4.5 一张矩阵看结论

维度 多数国际课 国内官办 国内商业培训 本课(Level 1)
投入 30 小时 – 6 个月 数天(专题班) 5 天 – 5 个月 8 天 · 约 22 小时
动手程度 看视频 / 做练习 听讲 + 现场教学 直播 + 项目 亲手跑通全链路
产出物 结业证 / 无 认知与规划 结业证 / 项目 8 件作品集产出
评估方式 选择题考试 出勤 作业 / 考试 产出过机器校验 + 量表打分
第三方背书 ADaSci / GSDC 政府主办 工信部 / 大连理工 无(自评 + 讲师评级)
价格 US$0–500 多为组织方承担 ¥3,800 起 档位 + 预约沟通
中文 / 工业语境 否 是 是 是(含 7 个工业门禁)

结论一句话:我们在"动手程度 / 产出物 / 评估方式"三件上明显更强, 在"第三方背书 / 价格透明度 / 时长纵深"三件上明显更弱。不假装全面领先。


5. 优势(诚实版,每条落在一个可核对的事实上)

  1. 门禁是工程,不是清单。 通关靠产出物过校验,不靠自觉或选择题。可现场演示 engage advance 被 blocked。03 §1.1
  2. 产出覆盖完整交付链,不是单点技能。 8 件里有 Runbook、SLO 卡、值班交接卡、交接包、合规六件套—— 多数竞品止步于"做出一个 RAG / Agent demo"。
  3. 零门槛、零 key、不换工具。 不需要 Python,不需要 API key,不要求替换你现有的编码 / 办公 Agent; 课程只叠"流程与门禁层"。01 §6.4、11 §4.1
  4. 平台层开源可审计。 教学依托的 fde-scope 代码在仓库里,不是 PPT——学员可以自己读实现。
  5. 工业场景纵深。 7 个工业门禁(site_survey / fat_sat / functional_safety / conformity / works_council / air_gap / shift_handover)在上表所有竞品里没有一个覆盖。
  6. 把诚实当评分维度。 "诚实标注"得 0 分一票否决;用真实客户数据练习一票否决(03 §4、§8)。 竞品普遍不惩罚夸大,我们直接把夸大判死。
  7. 课程自身可复制。 25 份文档 = 一整套可开办的教案包(讲师手册 / 运营手册 / 指标复盘 / 剧本案例库 / 模板库)。 多数课程是黑盒交付,我们连"怎么开第二期"都给了。
  8. 与官办项目同频而非对立。 官办解决"认知与布局"(企业负责人),我们解决"手上会不会做"(工程师)—— 可与政府 / 协会 / 企业大学的项目串成一条线(§4.3)。

6. 劣势与不适用场景(诚实版)

不写这一节就没有可信度。以下都是真的。

每一项的状态(2026-09 复核;「补齐」= 仓库里已有对应章节,不是说问题消失了):

# 劣势 状态 现在由谁承载
1 深度:8 天 vs 4–6 个月 🟡 部分补 14 课后 90 天纵深路线
2 无第三方认证 🟡 部分补 15 §2(三条认证路径 + 叠加顺序)
3 没有真实客户项目 🟡 部分补 14 §3 形态 D 影子项目
4 没有就业服务 🟡 部分补 10 §9.1 求职包三件套、§9.2 内推池规则
5 没有学员结果数据 ⛔ 结构上仍缺 15 §3–§5:指标与纪律已定,数字要等第一期
6 价格不透明 🟡 部分补 04 §1.2 四档:L0 定价 ¥0 已可公开;L1–L3 仍只给结构
7 工业纵深未经教学验证 ⛔ 结构上仍缺 15 §4 已列为待补行,须等真实班级
8 交付人力重 🟡 部分补 04 §3.1 助教三级阶梯 + 四条减人手段
9 仅中文 🟡 部分补 en/README.md 英文快速入门(快速入门 ≠ 课文翻译)
10 国内市场不只我们一家 🟡 部分补 08 §2.1 禁用句清单(把"首个"这类话术钉死)

两个 ⛔ 都不靠写字解决。 第 5 项要真实班级跑完一期,第 7 项要工业场景的班级跑过一遍。 在那之前,这两条只能空着——把设计推导的基线当实测数据发出去,就是造假(15 §3 发布纪律)。

逐条展开:

  1. 深度:8 天 vs 4–6 个月。 我们不教模型训练、微调、多 Agent 深入、连接器底层。 对照:Maven 4 周、NovelVista 80 小时、School of Core AI 6 个月、Krish Naik 5 个月、职坐标 4–5 个月。 适合入门与转型,不适合深造。 结营后的纵深路线见 14 §2—— 那是"接下来 90 天自己走",不是"本课改成了 4 个月"。
  2. 无第三方认证。 我们发的是本课证书 + 作品集评级。对照 ADaSci / GSDC / 工信部教育与考试中心 / 大连理工大学。 雇主认不认,取决于学员能否用作品集自证。不能拿"认证"当卖点。 想叠加第三方认证的三条路径与顺序见 15 §2;注意"教你考证"和"发证"是两件事。
  3. 没有真实客户项目。 全部为虚构案例(07)——这是"真实数据禁入"规则的代价。 只有企业内训形态 C 才可能用客户自己的脱敏场景;加档形态 D 把这条做成了产品(14 §3), 代价是每期最多 3 人、导师 ≤1:3、产出脱敏双签。
  4. 没有就业服务。 对照职坐标含猎头服务、FDE Academy 有招聘池。我们不承诺就业、不承诺收入(10 §8)。 §9.1 的求职包与 §9.2 的内推池是学员之间的互助,不是我们的业务,也不收费。
  5. 没有学员结果数据。 目前没有历史班级的完课率 / NPS / 薪资样本; 09 里的指标线是设计推导的基线,不是实测。第一期的数据出来之前,这一项只能空着。 15 §3 定了要收哪五项、§4 是待填的表、§5 是补齐清单——表是空的,这是故意的。
  6. 价格不透明。 按 04 §1.1 我们只给算法不给数字 → 现在 04 §1.2 公开四档的包含项与不包含项,且 L0 = ¥0 永久免费可以写进招生页。 竞品有 US$164.99 / US$0–500 / ¥5,000–29,000 明码标价;L1–L3 仍不公开数字(逐期成本不同,写死即承诺), 所以这条只是部分补齐——在比价场景仍是实打实的劣势。
  7. 工业纵深未经教学验证。 7 个工业门禁是工具已有能力,但作为课程内容还没在真实班级跑过。 15 §4 给它留了一行「工业纵深验证」,空着到有班级为止。
  8. 交付人力重。 需要试讲 ≥8/10 的讲师 + 1 : 15–20 的助教配比(04 §3、§7), 自助开班门槛不低。§3.1 把助教拆成三级阶梯、列了四条减人手段—— 省的是重复劳动,不是判断,所以门槛降了但没消失。
  9. 仅中文。 课文为中文母稿;英文页面只译壳与章节名,不译正文(页面已明说"served as authored")。 en/README.md 提供英文快速入门(语言策略 / 8 天弧线 / 零 key 命令 / 诚实边界 / L0–L3), 并用一整节列出仍缺什么——包括"课堂产出物本身是中文优先"。快速入门不等于能上课。
  10. 国内市场也不只我们一家在讲。 国内官办与商业培训已在快速铺开(§4.3、§4.4), "首个"这类话术很快会过期——不要用"国内首个"做卖点。 08 §2.1 的禁用句清单已把这类话术连同"包就业 / 保涨薪 / 学完年薪 X 万"一起钉死。

7. 招生 FAQ

问题 答(可直接粘贴)
学完能涨薪 / 接单吗? 不承诺。 本课交付的是"能力 + 作品集 + 话术",不承诺就业、不承诺收入(10 §8)。
需要会写 Python 吗? 不需要。所有命令都有可复制版本,代码细节是 Level 2 的事。
需要买 API key 吗? 不需要。全链路零 key 可跑;LLM 只是可选加速。
没有编程基础能学吗? 能——只要能装软件、复制命令行、读表格。装不上有"急诊室"预案(04 §6)。
和 ADaSci / GSDC 认证冲突吗? 不冲突,是两件事:他们是认证,我们是训练营 + 作品集。可以叠加(§4.2)。
和企业内训什么关系? 企业版=形态 C,3 天集中 + 1 周作业,可用客户自己的脱敏场景(04 §1)。
能用我公司的真实数据练吗? 不行。 练习数据必须虚构或脱敏;真实客户名 / PII 禁入仓库、群聊与第三方工具(08 §11)。
8 天能学会吗? 8 天学到"能独立跑通一条链路 + 手里有 8 件产出"。学到"资深"要靠后面在真实项目里练。
可以自学吗? 可以(形态 B)。但不要跳过 D5 的坏例子复盘,那是全课最值钱的一步。
下一期什么时候? Level 1 是完整一门课;Level 2 / 3 在规划中,尚未设计,不写时间表(01 §8)。

8. 来源清单与查证记录

查证日期:2026-09-30(全部条目)。等级见 §0。

# 来源 用途 等级
1 adasci.org/certifications/certified-forward-deployed-engineer-cfde CFDE:$164.99 / 30h / 7 模块 / 60 题监考 / 终身 官方
2 adasci.org/certifications/cfde-pro 存在更高档 CFDE Pro(价格未显示,2026-09-07 更新) 官方
3 gsdcouncil.org/certification-program/forward-deployed-engineer-jobs GSDC:9 模块 / 40 题 90 分钟 / 65% / 5 年 / $0–500 官方
4 analyticsindiamag.com/ai-highlights/top-10-forward-deployed-engineering-courses-in-2026 国际课横向汇总(2026-08-17) 媒体转述
5 maven.com/boring-bot/ai-system-design Maven FDE Bootcamp 4 周 官方
6 maven.com/p/fe9a81/forward-deployed-engineering-masterclass Maven Masterclass(3 小时工作坊) 官方
7 devenventureacademy.com/courses/forward-deployed-ai-engineering DeVenture:140–180h / $29 每月 / 需先修 官方
8 novelvista.com/corporate/forward-deployed-engineer-ai-training NovelVista:80h 直播 官方
9 krishnaik.in/liveclasses Krish Naik 直播班 官方
10 linkedin.com/learning/forward-deployed-engineering-in-the-age-of-ai LinkedIn Learning 课程存在 媒体转述
11 sii.edu.cn/2025/1221/c60a635/page.htm 上海首期 FDE 专题培训收官 + 主办单位 官方
12 shanghai.gov.cn/nw15343/20260213/... 徐汇首期 FDE 专题培训 官方
13 shanghai.gov.cn/nw31406/20260924/... 市企业技术中心 FDE 通识班:9-22 开班 / 逾 30 家 / 四门主题课 官方
14 wap.eastmoney.com/a/202601153620304511.html "全国首个" + "年内培养 200 名"(正文未取回,仅标题) 未取回
15 sdas.org/2026/0708/c8574a280983/page.htm 山东省首期 FDE 培训班线索 未取回(TLS 证书错误)
16 csdn.net/article/2026-09-15/165478288 国内 5 家机构清单 广告稿
17 ft.com/content/91002071-... "The new hot job in AI: forward deployed engineers"(2025-11-01) 媒体转述
18 sohu.com 江浙沪机构盘点 苏州瑞塔 ¥3,800–15,800 / 工信部证书(2026-09-19) 媒体转述
19 ifeng.com 三维天地 × 大连理工 5 天培训 / 大连理工证书(2026-09-04) 媒体转述
20 uml.org.cn AI Agent 开发 10–12 天 媒体转述
21 zhuanlan.zhihu.com/p/2062942824052560009 知乎 FDE 训练营(403,正文未取回) 未取回

未取回正文的站点(不得当作"没有该课程",也不得引用其细节): Udemy(403 反爬,多门课价格未取回)、zhihu.com(403)、sdas.org(TLS 证书错误)、 getsimul.com(403)、wap.eastmoney.com(正文与标题不符,仅采信标题)。

已知不一致 / 待办:

  • ⚠ ADaSci 价格:官网 $164.99 ↔ AIM $249 → 以官网为准,不定论。
  • ⚠ GSDC 模块数:官网 9 ↔ 第三方汇总 13 → 以官网为准。
  • ✅ 课程总时长口径:已统一为约 22 小时(D1 = 6h + D2–D8 每天直播 90 min + 自练 45 min ≈ 2.25h)。README、02、本页 §1.4 三处一致。
  • ⚠ 上海"200 名/年"仅见于媒体标题,正文未取回,不得作为已核实的规模数据引用。

9. 发布前合规自查(逐条打钩)

  • ☐ 全文没有"包就业 / 包涨薪 / 保证接单 / 承诺收入"类表述(08 §11、10 §8)
  • ☐ 全文没有出现真实客户名称、真实人名、PII;案例均为虚构(07)
  • ☐ 全文没有出现任何 API key / token / 口令;凭据只在环境变量(架构不变量 3)
  • ☐ 竞品数字每条都有来源 + 查证日期;拉不到的写"未取回",没有一个数字是估的
  • ☐ 源间冲突一律标 ⚠ 且不定论
  • ☐ 没有使用"国内首个 / 唯一 / 第一"等时效性易过期或不可验证的最高级表述(§6 第 10 条)
  • ☐ 提到的第三方产品名(Qoder / Trae / CodeBuddy / 豆包 / 千问 等)仅作示例,未暗示合作、授权或背书
  • ☐ 认证机构名称与证书名称照抄官方写法,未夸大其效力范围
  • ☐ 课程时长/门禁数/产出数与 02、03 一致
  • ☐ 报价环节已按 04 §1.1 的公式 + §1.2 的四档定义与三条禁止过一遍,L0 之外只说结构不说数字,未在群里"随口报价"
  • ☐ 文档总数表述已同步(15 → 25 份):README §5 / §8、01 §8、fde_scope/web/course.py、tests/test_web.py、docs/features.md、docs/features-en.md

10. 过期提醒

本页是唯一会过期的一章。竞品的价格、时长、主办方随时在变。

触发 动作
每 90 天 重核 §4.2 / §4.4 的价格与时长;把"未取回"的再拉一次
每次招生开营前 过一遍 §9 自查表
竞品出现重大变化(新课程 / 改价 / 官办新增城市) 更新对应行 + 记新的查证日期
README 时长口径统一后 删掉 §1.4 的 ⚠ 对内提示

14 · 课后纵深与影子项目

14

course-level-1/14-课后纵深与影子项目.md

一句话:8 天只够把链路走通一遍,能力长在课后的 90 天里。 本章回答两个问题:课后怎么练才不散(§1–§2、§5),想碰真实场景怎么碰才不越线(§3–§4)。 对症 13 §6 的三条短板:#1 深度、#3 没有真实客户项目、#7 工业纵深未经教学验证。


0. 先把账认清楚:这一章补哪三条短板

13 §6 的短板 本章的补法 补到什么程度 补不到的部分(照样认账)
#1 深度:我们 8 天 vs 竞品 4–6 个月 §1–§2 的 90 天路线图与三个复评点;§5 的七个工业门禁沙盘 把"入门"延长成一条有终点、可自检的 90 天练习线 仍然不教模型训练、微调、多 Agent 深入——那是 Level 2 及以后的事
#3 没有真实客户项目:案例全虚构 §3 影子项目(形态 D)SOP——给一条真能碰真实场景的合规通道;§4 无项目时的三条替代轨道 把"真实"从"不可能"变成"有准入、有边界、可中止" 影子项目不承诺交付、不承诺收入、不保证每期都有——开不开取决于客户,不取决于你
#7 工业纵深未经教学验证:7 个工业门禁只是工具能力 §5 把 7 关逐个沙盘化,用虚构档案把每一关亲手过一遍 从"工具里有"变成"学员练过" 沙盘 ≠ 现场(§5.4);第一次开班跑完之前,本章的时长与配比一律是设计口径,不是实测

⚠ 本章不发明数字。凡是时长、人数、配比,都写明是设计口径;凡是还没有实测的地方, 明确写「待验证」,而不是填一个好看的数——这条纪律与 13 §7、 09 §10 一致。


1. 90 天路线图:12 周练习 + 1 周缓冲

1.1 为什么给 90 天,而不是"回去多练练"

"回去多练练"是一句没有终点的话,等于没有布置作业。所以这一章给的是一个有日期、有交付物、 有复评点的 90 天:13 周 × 每周 2–2.5 小时 ≈ 26–32 小时(设计口径), 终点就是 D+90 的等级复评(§6)。

它也是我们对应竞品长周期课程的诚实答案:竞品用 4–6 个月讲完体系,我们用 8 天把链路走通一遍, 再用 90 天把"走过"变成"练过"。想深造的仍然要去学模型与工程底层——那是另一条路 (13 §6 #1 这条短板我们不打算靠话术抹平)。

1.2 13 周总表

阶段 周次 主题 每周投入 交付物 复评点
复跑 W1–W2 把 8 天重走一遍(W1 用 seed 档案对照,W2 从零建自己的第二个档案) 2–3 h 差异清单("我当时漏了什么")+ 第二个档案跑到 success_criteria 且门禁通过 ✅ D+14
A/B 区纵深 W3–W5 现场与干系人 → 语料 → 真实脏数据原型 2–3 h 现场卡片 / 语料报告 / 原型 + 落差记录
C 区纵深 W6–W7 稳定性承诺与值班:SLO → runbook → 监控漂移 2–3 h SLO 卡 + Runbook + 值班交接卡 ✅ D+45
工业纵深 W8–W11 七个工业门禁沙盘(§5),每周两关 2–3 h 七份沙盘材料(含"被拦一次"的记录)
综合与缓冲 W12–W13 综合走一遍 manufacturing 全流程 + 作品化 + 缓冲 2–3 h 90 天纵深包(见 §2.1) ✅ D+90

W1 的起点命令(在仓库根目录执行):

python examples/seed_mock_engagements.py   # 幂等;重复跑=把 10 个虚构档案恢复原样
COLUMNS=200 fde-scope engage list          # 看 10 个 id(不加 COLUMNS 会截断 id 列)
fde-scope engage status eng-teaverse-ticket-seed01   # 看"跑完的"长什么样(✅3)
fde-scope engage status eng-adnova-ticket-seed06     # 看"被拦住的"长什么样(❌1)

若 python 不可用,用 python3 或 .venv/bin/python——三者等价(11 §3.2)。 10 个档案各自适合练什么,见 12 §3.2 的表。

⚠ W2 的坑:第二个档案请自己新建(fde-scope engage init ...),别去改 seed 档案—— seed 档案是"参考答案",改坏了虽然重跑一次 seed 就能恢复,但你会失去对照基线。


2. 三个复评点:D+14 / D+45 / D+90

2.1 复评点交什么、怎么判

复评点 交什么(提交物) 判定方式 判不过怎么办
D+14 复跑记录:差异清单(≥5 条"我当时漏了/做错了什么")+ 第二个档案的门禁记录截图 自评 + 社群互评(同一期学员两两交换看) 不是"淘汰"——把差异清单补齐即可,复评点不是门禁
D+45 C 区材料包:SLO 卡 + Runbook + 值班交接卡 自评 + 助教抽检(抽检比例是设计口径,第一期结束后回填) 同上;C 区材料是结业等级复评的硬材料,缺了会挡住升级
D+90 90 天纵深包:① 第二个档案全流程的门禁记录;② C 区材料包;③ 工业沙盘材料(若第一个档案是 manufacturing);④ 一页"这 90 天我改掉了什么习惯" 必须导师参与(因为要发等级复评结论) 等级维持原状(不是降级),可申请下一期复评

💡 复评 ≠ 门禁。课程门禁(03 §3 的 G0–G8)决定你能不能往下一步走, 复评决定的是结业等级要不要动(C→B→A)。复评没过不丢人,隐瞒不交才丢人。

2.2 D+90 的长期跟踪口径

D+90 复评用的三个跟踪问题与 09 §11 的长期跟踪是同一套—— 运营侧问的是"课程有没有用",学员回答的顺便就是自己的复评材料。别重复填两遍: 第一次填完,把副本留给自己,D+90 复评直接交它。


3. 影子项目(形态 D)SOP:什么时候能碰真实场景

3.1 形态 D 是什么、不是什么

是 不是
在客户书面同意的前提下,学员在导师 ≤1:3 的监护下参与一个范围极小的真实场景 不是实习、不是外包、不是"免费劳动力换经验"
练的是"真实约束下做判断":真实脏数据、真实干系人、真实截止时间 不承诺客户会采纳你的产出
产出是方法与骨架,以及(可选、经双签的)脱敏摘要 不承诺收入、不承诺就业、不承诺下一期一定有

形态 D 与 04 §1 的 A/B/C 三形态并列,是在 A 之后、面向少数人的加档, 不是默认产品。它的存在理由只有一个:把 13 §6 #3"没有真实客户项目"从"结构性缺失" 变成"有条件可得"。

3.2 客户侧准入四件套(缺一不可)

  1. 书面同意书:范围、数据范围、签字人、退出机制,四样都写进同一份文件。
  2. 场景边界说明书:一句话问题定义(客户的问题,不是平台能力)+ 明确不做什么。
  3. 数据最小化声明:只要必需字段;能匿名就不假名化,能假名化就不带标识。
  4. 退出/中止条款:任一方可随时中止,并写明中止后的数据处置时限。

3.3 数据边界:真实数据不出客户环境

这是形态 D 最硬的一条纪律,也是它"贵"的原因——所有环节都得加一层隔离。

规则 具体做法
数据不出客户边界 在客户环境(或其指定的隔离环境)内处理;学员带走的是方法结果与脱敏摘要,不是原始数据
仓库只放虚构 仓库、群聊、作业包、截图、录屏里永不出现真实客户名、真实工单文本、真实个人信息
凭据只走环境变量 API key / 数据库口令一律从环境变量注入,绝不落进 engagement JSON、报告、日志、截图、群聊
离开必过双签 任何要离开客户环境的样本,先过 §3.4 的双签

3.4 脱敏双签:两道签名,一个验收标准

  • 签谁:客户数据负责人 + 我方导师。两名自然人各签一次,不能代签。
  • 签什么:脱敏规则清单(哪些字段删除 / 掩码 / 泛化)+ 实际执行记录(对样本逐项勾)。
  • 验收标准(记住这一条就够):把样本给一个不认识该客户的人看,他说不出客户是谁、 也认不出任何一个自然人。做不到就再脱一遍,不要"差不多就行"。
  • 留档:签字件留在客户侧;我们这边只留一份"已双签"的记录——不含数据本身。

3.5 权限与凭据

  • 只读优先。任何写权限必须双人复核 + 有回滚路径。
  • 凭据只从环境变量读(这是本仓库的不变量之一,写在 AGENTS.md)。
  • 生产环境默认不碰。要在生产验证,先问一句:"有没有影子环境?"

3.6 交付确认:措辞纪律(这一条最容易吹)

✅ 允许写 ❌ 禁止写
已按约定范围完成 X 的输出物 已为客户创造 N 万元效益
客户侧联系人已收到并确认收件 客户已验收 / 已上线
在 X 场景内取得 Y 结果(附口径与样本量) 显著提升 / 大幅优化

原因很简单:把"处理过"说成"验收过",是作品集里最容易被一眼看穿的夸大, 而 10 §8 的"不承诺"纪律同样约束描述而不只是承诺。

3.7 中止与退出:中止不丢人,隐瞒才丢人

  • 触发:客户撤回同意 / 导师判断越界 / 学员判断做不下去 / 出现数据风险。
  • 动作:立即停止接触数据 → 24 小时内通知双方 → 按约定期限销毁并留销毁凭证 → 记入「中止档案」。
  • 中止档案怎么写:如实写"因 X 中止",照样可以进作品集(写清你学到了什么)。 藏起来当没发生过才是反模式(§7)。

3.8 导师配比与现实(接着认账)

  • 影子项目导师配比 ≤1:3,而训练营的助教配比是 1:15–20(04 §1)。 差一个量级,因为它碰真实数据。
  • 现实:这条很重,它正是 13 §6 #8"交付人力重"的直接来源—— 我们靠收窄规模来换合规,不靠省略步骤来换便宜。
  • 因此执行顺序是:先做 §4 的替代轨道 → 攒到 3 个以上学员到 B 级 → 每期影子项目最多 3 人。

4. 没有影子项目怎么办:三条替代轨道

影子项目不是默认产品(§3.1)。绝大多数人走的是下面三条轨道——它们不是次等品, 只要在作品集里如实标注性质,一样能拿 A 级。

轨道 怎么做 能拿到的证据 缺什么
虚构档案全链路 自己建第 3、第 4 个档案,把 18 阶段走完(engage init + 逐级 advance) 完整门禁记录 + 作品集 8 件 真实约束:真实脏数据、真实的人、真实的截止
公开数据集 用公开数据集(注明来源与许可)做 connect → corpus → prototype → eval 真实脏数据的处理方法与落差记录 仍然没有客户与干系人
身边小场景 自己的/朋友的非敏感小场景(如社团报名表整理、自家小店的排班表) 真实干系人(哪怕只有一个) 规模小——别包装成"企业项目"

⚠ 三条轨道都必须在作品集里标注性质(虚构 / 公开数据 / 真实小场景)。 标注本身就是 03 §7 的"诚实标注"评分维度;不标 = 送分题反向做。


5. 七个工业门禁教学沙盘

这一节是 13 §6 #7"工业纵深未经教学验证"的答卷: 把 7 个工业门禁逐个变成一道可批改的练习。工具侧的证据要求来自 fde_scope/engagement/guided.py 与 fde_scope/engagement/gates/*.py,命令都实测过。

5.1 统一跑法

# 0) 前提:仓库根目录 + 环境就绪(11 §3.1)
python examples/seed_mock_engagements.py     # 幂等

# 1) 看工业档案走到哪、哪一关被拦
COLUMNS=200 fde-scope engage list
fde-scope engage status eng-southbay-manufacturing-seed03

# 2) 只看某关为什么被拦(带 --gate 指名单关;不带则查当前阶段)
fde-scope gate check eng-southbay-manufacturing-seed03
#   ❌ BLOCKED · gate=fat_sat
#     🚫 SAT (Site Acceptance Test) 未执行或未记录
#   💡 已把这次阻塞沉淀为草稿 skill-…(阻塞本身就是知识,见 12 §3.2)

# 3) 照参考答案:读一个"材料齐全"的档案里那一关要写什么
python - <<'PY'
import json, pathlib
p = pathlib.Path(".fde_scope/engagements/eng-aurora-manufacturing-seed07.json")
print(json.dumps(json.loads(p.read_text())["assets"]["air_gap_plan"],
                 ensure_ascii=False, indent=2))
PY

读完参考答案,写进你自己的档案(别改 seed 档案,改坏了要重新 seed):

fde-scope engage init --customer "沙盘练习" --profile manufacturing
# 然后(把 <id> 换成上一步生成的 id,通常是 eng-沙盘练习-manufacturing)
python - <<'PY'
import json, pathlib
from fde_scope import paths
from fde_scope.engagement import Engagement, EngagementContext

eid = "<id>"
f = paths.engagements_dir() / f"{eid}.json"
eng = Engagement(EngagementContext.load(f))
eng.ctx.assets["shift_handover"] = {
    "digital_log_integrated": True,
    "per_shift_runbook": True,
}
eng.ctx.save(f)            # 原子写入(fsutil.atomic_write_text)
print("written:", f)
PY

⚠ 不适用 ≠ 通过——这是整个沙盘最重要的一条。7 关里有 4 关是"情境性"的: 情境字段没打开时,它们会返回 PASS 并附一句"本 gate 不适用"。那不是你通过了工业门, 是那道门根本没被考到(12 §3.2 里"要命的坑"的机理解释):

门禁 情境开关(开在现场卡片 / 安全卡片里) 开关关着时的行为
site_survey · fat_sat 工业档案(--profile manufacturing)必过,无开关 —
functional_safety 无开关;但缺 PLr/SIL 要求时只给 warning 不阻断 值不写全 = 门被绕过(最隐蔽的一关)
conformity safety.eu_ai_act_high_risk false 时 CE marking 只是 warning,不阻断
works_council site.works_council_represented false → PASS +「现场无 works council 代表,本 gate 不适用」
air_gap site.air_gapped false → PASS +「非 air-gapped 现场,本 gate 不适用」
shift_handover site.shift_count > 1 ≤1 → PASS +「单班次现场,shift handover 不适用」

所以每个沙盘的练法是两步:先把情境字段按工业真实值填上(让门真的会拦人), 再把材料写齐(让它真的通过)。只做第二步 = 练了个"不适用"。

5.2 七个沙盘

# 门禁 情境怎么打开 要写齐的材料(工具侧证据) 参考档案
1 site_survey 工业档案必过 现场卡片:地点 / 班次数 / 网络拓扑;资产清单(每台关键设备的 name·type·vendor·protocol·criticality);OT/IT 隔离与气隙状态;工会在场与否 eng-horizon-manufacturing-seed08(早期阶段)→ eng-southbay-manufacturing-seed03
2 fat_sat 工业档案必过 assets.fat = {passed, signed_off_by, notes} 和 assets.sat = {…};SAT 必须现场执行且带客户签字(缺签字只 warning,未通过直接拦) eng-southbay-manufacturing-seed03(有 FAT 无 SAT → 被拦);eng-atlas-manufacturing-seed02(齐全)
3 functional_safety 把 PLr / PL、SIL 要求与达成值都填上 safety.hazard_analysis_done(STPA / HAZOP-lite 是前提)+ required_plr/achieved_pl(达成 < 要求 → 拦)+ sil_required/sil_achieved + iso10218_assessed eng-atlas-manufacturing-seed02(PL d/d、SIL 2/2)
4 conformity eu_ai_act_high_risk = true safety.ce_marking_done + assets.technical_construction_file(EU AI Act Annex IV 技术构造文件)+ hazard_analysis_done eng-aurora-manufacturing-seed07(只差这一件 → 全档唯一 ❌)
5 works_council works_council_represented = true assets.works_council_approval = {status, signed_off_by};status="denied" → 拦(需重新协商);"pending" → warning eng-atlas-manufacturing-seed02
6 air_gap air_gapped = true assets.air_gap_plan:edge_hardware(机型与数量)、offline_model_update(介质·校验·回滚)、telemetry_egress_allowed 必须为 false、local_storage(日志/语料/审计的本地持久化) eng-aurora-manufacturing-seed07
7 shift_handover shift_count > 1(如 3) assets.shift_handover = {digital_log_integrated, per_shift_runbook};每班次要有一份 runbook 与应急联系人 eng-atlas-manufacturing-seed02

建议的练习次序:1 → 2 → 7 → 6 → 5 → 3 → 4。 前两关先建立"现场感",shift_handover/air_gap 材料最短(先拿一个成功), works_council 需要写协商过程,functional_safety/conformity 最贵(要动安全与法规判断,放最后)。

5.3 材料骨架:以 air_gap 为例

抄骨架、换成你自己场景的数字,别照抄 seed 的数值(那是虚构演示值):

字段 写什么 自查问题
edge_hardware 机型 + 数量 + 摆在哪 断网它还能推理吗?
offline_model_update 介质 + 清单 + 校验 + 回滚 + 谁在场 出新模型时,怎么保证不把产线搞停?
telemetry_egress_allowed 必须是 false 有没有任何"偷偷 phone home"的默认开关没关?
local_storage 容量 + 保留期 + 谁有权限 审计要回看 180 天,存得下吗?

5.4 沙盘 ≠ 现场:这一节自己的诚实标注

沙盘能练到「材料怎么写、门怎么拦、缺什么」,练不到三件事:

  1. 真实的脏数据——seed 档案是干净的结构化演示值,现场数据不会这么客气。
  2. 真实的签字压力——SAT 的客户签字、工会的共决,沙盘里是字符串,现场是政治。
  3. 真实的停机成本——沙盘里 advance 被拒只损失一次命令,现场被拒可能损失一班产能。

所以本章不会因此在 13 §6 #7 上写"已验证"。正确的说法是: 7 关已可教学、可批改;是否真的补齐了工业纵深,要等第一期跑完、拿到 D+90 复评数据才算数 (回填位置见 15 §4 的结果度量表)。


6. 等级复评与 Level 2 门槛

6.1 C→B→A 复评通道

结业等级的定义在 03 §6(A = 8 件产出齐全 + 均分 ≥9/12 + 无未达项 + 无延期; B = ≥7/12;C = 缺 ≤2 件或 <7/12)。D+90 复评是升级通道:

方向 条件 结果
C → B 补齐缺件 + 90 天纵深包完整 换发 B 级电子证书
B → A 补齐 8 件 + 90 天纵深包 + 一份"改掉了什么习惯"的说明 换发 A 级证书 + 徽章;讲师签名表现信需另行评估(不是内推)
维持 纵深包未交或未过 等级维持原状,不降级;可申请下一期复评

⚠ 复评换发的证书与原证书同一编号、带复评日期——不新发编号,避免出现"两张证书"的歧义。 有效期与申诉口径见 15 §1。

6.2 Level 2 入学门槛(设计口径,待开课)

Level 2 目前没有开设。先把门槛写出来,是为了让你在 90 天里有明确的靶子:

  1. 结业等级 B 及以上;
  2. 独立跑完 ≥2 个档案且门禁全绿(不是"跟着抄");
  3. D+90 复评通过;
  4. 工业方向加一条:§5 的 7 份沙盘材料齐全。

⚠ 这四条是门槛设计,不是招生承诺。Level 2 的开课时间、形态与价格都还没定—— 在 13 §9 的过期提醒机制里登记了这一项,一旦变动先改那里。


7. 反模式:这六种练法等于没练

  1. 把 seed 数据当真项目写进简历——虚构档案在简历里叫"编造项目经历",一票否决级别的问题。
  2. 影子项目写成"主导交付"——10 §8 与 §3.6 的措辞纪律;写"参与并完成 X 输出物"不丢人。
  3. 打卡式刷量:90 天里建了 20 个档案全卡在 qualification——数量不是纵深,跑完全链路的 2 个胜过 20 个半截。
  4. 只写材料不打开情境开关——练出来的全是"不适用"(§5.1),等于没练。
  5. 没有客户书面同意就动数据——这是红线,不是"先做着看";触发即中止(§3.7)。
  6. 给"待补"的表格填数字——15 §4 的结果度量表在第一批数据出来前必须留空,编数是自毁公信力。

8. 一页速查

我想…… 去哪
知道课后 90 天每周练什么 §1.2 的 13 周总表
知道 D+14 / D+45 / D+90 交什么 §2.1
判断能不能开影子项目 §3.1 + §3.8(先替代轨道,攒到 3 个 B 级)
查数据能不能带出客户环境 §3.3(默认不能)+ §3.4 双签
查交付确认怎么写 §3.6 的允许/禁止对照表
练 7 个工业门禁 §5.1 的命令 + §5.2 的表
搞清"不适用"和"通过"的区别 §5.1 的 ⚠ 与情境开关表
申请等级复评 §6.1
看证书有效期 / 申诉 / 第三方认证 15

D+90 纵深包自查:

  • ☐ 第二个档案:从 qualification 跑到 disengage,门禁记录齐全
  • ☐ 差异清单:≥5 条"我当时漏了什么"
  • ☐ C 区材料包:SLO 卡 + Runbook + 值班交接卡
  • ☐ 工业沙盘(仅 manufacturing):§5.2 的 7 份材料 + 每一次"被拦"的记录
  • ☐ 作品集标注:每一件都写清是虚构 / 公开数据 / 真实小场景
  • ☐ 一页说明:这 90 天我改掉了什么习惯(具体到一个动作,不写"提升了认知")

上一章:13 GTM 页面与竞品对比|下一章:15 公信力与结果度量 相关:03 评估体系与通关门禁 · 04 交付实施手册 · 09 运营指标与复盘

15 · 公信力与结果度量

15

course-level-1/15-公信力与结果度量.md

一句话:这一章管的是"我们说的话,凭什么让人信"——证书的边界、第三方认证怎么叠加, 以及那句现在还没资格说的话("效果如何")该用什么数字、什么时候才有资格说。 对症 13 §6 的两条短板:#2 无第三方认证、#5 没有学员结果数据。


0. 先把账认清楚:这一章补哪两条短板

13 §6 的短板 本章的补法 补到什么程度 补不到的部分(照样认账)
#2 无第三方认证:我们发的证没有外部背书 §1 把本课证书的边界、编号、有效期、申诉写死;§2 给出三条学员可自行叠加的第三方路径与措辞纪律 从"我们发个证"变成"一张边界清晰、可核验、可申诉、会过期的证 + 三条自己花钱能走的叠加路线" 我们不会因此变成"官方认证";第三方的证要自己考;与任何机构没有互认;13 §6 #2 那句"不能拿认证当卖点"仍然有效
#5 没有学员结果数据:指标线是设计推演,不是实测 §3 把结果度量做成可执行工具(5 项指标 + 固定口径 + 采集时点 + 发布门槛);§4 给出对外发布表与回填规则 从"我们设计了一组指标"变成"第一期结束 48 小时内就能填的一张表,且填表规则先于数据写死" 数字仍然没有。 截至 2026-09-30 是 0 期;§4 的表格在第一期数据出来前必须留空——编数不是"先占位",是自毁公信力

⚠ 本章三条铁律,贯穿全章: ① 不发明数字——没有实测的地方写「待补」,不写 0、不写"数据整理中"; ② 不换算——D+90 问卷里没有"就业率 / 涨薪率 / 平均薪资"这些字段,任何换算都是编造(09 §11); ③ 不承诺——不承诺就业、不承诺收入(10 §8),这一条不因为有了数据就松动。


1. 我们发的证书:是什么、不是什么

1.1 边界表

等级判定(A / B / C)的规则在 03 §6。本节只回答一件事: 这张纸证明什么、不证明什么。

维度 ✅ 是 ❌ 不是
性质 本训练营的结业证书(电子版),含 A / B / C 等级 不是职业资格证、不是职业技能等级证书、不是任何机构的"认证"
证明内容 你完成了哪些产出、通过了哪些门禁(事实陈述,可回溯到原件) 不证明"你能胜任 FDE 岗位"、不证明任何薪资水平
依据 门禁记录 + 评分量表(03 §4)+ 结营答辩记录 不做分数排名、不发"优秀率"
署名 课程负责人 + 主讲讲师(电子签) 不冒用任何机构或部委名义
备注栏 如实记录补交 / 延期 / 豁免项(与门禁"留痕"原则一致,03 §6) 不隐藏补交历史
归属 证书与作品集归学员所有 对外展示需本人书面授权(03 §8)

一句话:这是一张"我做过什么"的证,不是一张"我行不行"的证。 后者只有作品集和面试能回答。

1.2 编号规则与核验

项 规则
编号格式 <期次>-<等级>-<顺序号>,例:L1-2026Q4-B-007
一人一号 编号终身唯一。等级换发(C→B→A,14 §6.1)、信息纠错、到期续期,全部是同一编号上的记录,永不新发编号
不编码个人信息 编号内不含姓名拼音、手机号、身份证号——编号泄露不构成 PII 泄露(03 §8)
核验方式 通过课程官方联系渠道(与招生咨询同一入口)提交编号,课程方 3 个工作日内回执:等级 / 期次 / 状态 / 发证与到期日期。当前为人工核验;在线核验页见 §5 待办
核验不提供 不出具"推荐信""能力评价"式的额外背书——核验只复述事实

⚠ 两件别做的事:① 把编号写进简历却不附核验入口说明(对方查不到,反而减分); ② 自己编造/伪造编号格式——编号一旦开始被伪造,所有人的证一起贬值,这是公地悲剧。

1.3 有效期 2 年,以及"过期 ≠ 作废"

有效期 2 年,自发证日起算。为什么是 2 年而不是终身:FDE 的工具链迭代很快, 一份两年前的"能独立部署"记录,对雇主的参考价值本来就该衰减——这不是谦辞,是对雇主的诚实。 (同类证书的常见档位也是 2 年,见 13 §4.2 的 ADaSci / GSDC 行。)

时间点 发生什么
到期前 60 天 向登记邮箱发一次到期提醒 + 复检包说明(只提醒一次,不追)
到期 状态变为 expired(已过期):核验如实回答"该编号的证书已于 <日期> 过期,最后等级为 B"
复检 提交复检包:90 天纵深包更新(14 §2.1)+ 一件近期产出的自评 + 一段"工具链变了,我补了什么"。通过 → 同一编号换发新有效期的证书(带复检日期)
不续期 证书不删除、不撤销,只标 expired。过期不等于作废——把这两件事混为一谈,是在给自己制造未来的投诉

唯一会"撤销"(revoked) 的情形是 03 §7 / §8 的两条一票否决: 诚实标注判 0 未改、数据合规事故(真实客户名 / PII 进练习)。核验回执写"已撤销 + 原因类别", 不公开细节、不公开点名——撤销针对的是资格,不是人。

1.4 申诉通道(三条,都留痕)

场景 走哪条 时限
觉得门禁 / 评分"判错了" 08 §10 的申诉三步:① 私聊班主任写清"哪一条 / 我认为应该是什么 / 证据";② 24h 内由未参与该次评分的人复核原件;③ 结果书面回执。对 G8 结业门结果仍有异议 → 班主任升级讲师,3 个工作日内终裁 24h 复核 / 3 工作日终裁
证书信息打错(姓名 / 等级 / 期次 / 编号) 纠错通道(与申诉分开):提交后 7 个工作日内换发同编号证书。纠错不计入申诉次数、不影响任何评价 7 个工作日
涉及两条一票否决(诚实标注、数据合规) 不走申诉豁免(03 §8 原文),但走复核:复核只确认"事实认定是否有误",不改变豁免规则 同 G8 终裁

申诉与投诉的共同纪律(08 §10):全程书面留痕、 不得在公开群讨论具体内容、不得因申诉降低对学员的评价。


2. 第三方认证:三条可自行叠加的路径

⚠ 先读这三句:① 本节是信息汇总,不是合作公告——我们与下列机构没有合作关系、没有互认协议 (截至 2026-09-30);② 它们认不认本课、我们认不认它们的证,都不是本课能决定的; ③ 13 §6 #2 的原话依然有效:不能拿"认证"当卖点。

2.1 三条路径

数字均引自 13 §4.2 / §4.3,查证日 2026-09-30。

路径 主办 形态 费用 与我们的关系 适合谁
CFDE ADaSci(国际) 30 小时 / 7 模块 / 自定进度 + 60 题监考 US$164.99(官网;另有更高档 CFDE Pro,价格未显示) 无合作,可叠加 想要一张国际渠道可查的认证、且能给英语监考考试留出时间的人
Certified FDE GSDC(国际) 9 模块 / 40 题 / 90 分钟 / 65% 通过 US$0–500(档位未取回全貌) 无合作,可叠加 同上;偏好 5 年有效期的人
机构培训 + 官办证书 苏州瑞塔 / 三维天地 × 大连理工等 培训 4–5 天 + 发证 ¥3,800–15,800 / 未取回 无合作;这是"再上一次课"的路线 需要体制内 / 国企可识别背书的人

读表纪律:价格与规格以主办方官网为准——13 §8 就记着两个源间冲突 (ADaSci 官网 $164.99 ↔ 媒体记 $249;GSDC 官网 9 模块 ↔ 第三方记 13 模块)。 本表不替你做等价性判断,也不做换算:比如"本课 22 小时 ≈ CFDE 30 小时的 73%"这种算法是伪科学—— 学时不是可比单位,考纲内容才是。

2.2 叠加的实操顺序(建议,不是规定)

  1. 先结课、先攒作品集。 认证是锦上添花,作品集才是你的证据(README §3 的八件产出)。
  2. 再挑一门考试。 复习素材就是你的 8 件产出:它与 CFDE 的 7 个模块有大面积重叠—— 但没有官方对照表,重叠到什么程度以你自己读考纲为准。本课不出"考点对照表"(出了就是代人言)。
  3. 简历 / 作品集怎么并列写(措辞纪律,与 10 §8 同源):
✅ FDE 训练营结业(A 级,8 件产出见作品集索引页)
✅ ADaSci Certified Forward Deployed Engineer (CFDE),2026
❌ 工信部认证 FDE —— 证不是从那个渠道拿的,就是虚假陈述
❌ 学完本课可直接通过 CFDE 考试 —— 我们没考过,这句话没有任何依据

2.3 我们不做的三件事

  1. 不办"包过班"、不代报名、不收返佣——若未来出现合作,会在本节明示合作范围与是否收费。
  2. 不声称"上完本课即可通过 XX 考试"。
  3. 不用第三方的 logo / 证书样张做招生页(未经授权使用他人标识是另一类合规问题,08 §11)。

3. 结果度量:把"设计基线"变成"可采集"

3.1 问题出在哪

09 §3 的合格线(完课率 ≥ 70%、作品集完整率 ≥ 60%、NPS ≥ 40)是设计推演的基线,不是实测—— 这一条我们自己写过(13 §6 #5)。真正的问题不是"数字难看", 而是"从没定义过怎么采":不定采集口径,第一期跑完只会得到一堆互相矛盾的数。

所以本节做三件事:定五项指标 → 定发布门槛 → 定填表规则。

3.2 五项对外指标(口径先写死,事后不许改)

# 指标 分子 ÷ 分母 采集时点 数据来源 对外发布门槛
1 作品集完整率(北极星) 8 件齐全人数 ÷ 实际开课人数 G8 结营日 门禁台账(08 §4) n ≥ 20
2 完课率 G1–G7 通过 ≥ 6 关人数 ÷ 实际开课人数 G8 门禁台账 n ≥ 20
3 NPS (推荐者 − 贬损者)÷ 回收份数 结营后 48h 结营问卷 n ≥ 20 且回收率 ≥ 60%
4 D+7 变现动作率 完成 ≥ 1 个变现动作人数 ÷ 结业人数 D+7 D+7 回访(04 §5) n ≥ 20
5 D+90「用上了」率 选"用在工作 / 求职 / 接单"人数 ÷ 有效回收人数 D+90 ± 7 天 09 §11 三题问卷 n ≥ 20 且回收率 ≥ 40%

分母定义:「实际开课人数」= D1 实际出席(≥ 一半时长)人数,与 09 §2 的漏斗口径一致。 任何一格比率都必须能回答"除以谁、什么时候采的"(09 §9 的口径纪律)。

3.3 对外发布四条纪律

  1. n < 20 只做定性,不做百分比。 小样本比率毫无意义(09 §11 对内的线是 8 人; 对外取更严的 20——因为对外引用没有机会解释口径)。
  2. 永远带分母与样本量: ✅「第 1 期:作品集完整率 63%(19 / 30,实际开课 30 人)」 ❌「作品集完整率 63%」
  3. 不挑期次。 有 ≥ 2 期数据后,对外必须连续展示(含表现差的那期);只发最好的一期 = 樱桃采摘(09 §10)。
  4. 差评与掉队同等发布。 每期对外页同时写明"这期没过哪条硬线"——与 09 §6 期报同口径, 不许对外只留半张脸。

3.4 反模式(本节自己不许犯)

反模式 为什么不行
拿"报名人数 / 群人数"当成绩 免费留资谁都能冲量(09 §10)
把 D+90「用上了」换算成"就业率 / 涨薪率 / 平均薪资" 问卷里没有这些字段,换算即编造(09 §11)
用"学员反馈热烈" 无法证伪的形容词(09 §10)
只摘一个好看的数字做海报 见 §3.3 第 2、3 条
把分母从"实际开课人数"悄悄换成"交作业的人数" 分母变小、数字变好看,属于改口径刷分(09 §9 明令禁止)

4. 结果度量表(第一批数据出来前,全部留空)

基准日 2026-09-30:Level 1 尚未开办第一期。 下表除「设计基线」列外一律「待补」—— 这就是 13 §6 #5 的兑现方式:不是把空格填满,而是先把空格与填法一起公开。

4.1 汇总表(对外发布用,整行引用)

指标 设计基线(09 §1 / §3) 第 1 期 第 2 期 第 3 期 跨期合计
实际开课人数(分母) — 待补 待补 待补 待补
作品集完整率 合格线 ≥ 60% 待补 待补 待补 待补
完课率(G1–G7 ≥ 6 关) 合格线 ≥ 70% 待补 待补 待补 待补
NPS / 回收率 合格线 ≥ 40 / 回收 ≥ 60% 待补 待补 待补 待补
D+7 变现动作率 ≥ 60% 待补 待补 待补 待补
D+90「用上了」率 不设目标(首期攒基线) 待补 待补 待补 待补
数据合规事故 = 0(一票否决) 待补 待补 待补 待补
本期未达标的硬线 —(如实列出哪条没过) 待补 待补 待补 待补

填表规则:

  1. 只有 09 §6 的期报冻结后(结营 48h 内)的数字才能填;
  2. 每格必须能回答"分母是谁、什么时候采的、谁采的";
  3. 空格写「待补」,不允许用 0、—、"数据整理中"糊弄;
  4. 对外引用整行引用(含分母、样本量、采集日期)。

4.2 工业纵深验证行(回填 14 §5.4)

14 §5.4 承诺过:"沙盘 ≠ 现场,7 关是否真的补齐了工业纵深,要等第一期跑完、拿到 D+90 数据"。 回填点就是下面这张表:

观测项 怎么采 判定"7 关已获教学验证"的条件(暂定,首期攒基线) 当前
90 天纵深包提交率(manufacturing 学员) 交件记录 ≥ 60% 待补
7 份沙盘材料完整率(14 §5.2) 交件清单 ≥ 60% 待补
「被拦一次」记录覆盖率 交件记录 100%(没有拦截记录 = 情境开关没打开 = 等于没练,14 §5.1) 待补
D+90 复评中工业方向的升级率 复评记录 记录观察,首期不设线 待补

使用规则:数据改话术,不是话术改数据。 只有上表第 2、3 行在第一批数据里达标, 才能在 13 §6 #7 旁标注"已获第一期教学验证";否则原话保留(14 §5.4)。

4.3 首期专项观察项(不对外,只进期报)

观察项 指向的改进
被拦最多的 gate(按 slug 统计) 02 的时间盒重排
"被拦 → 补交 → 通过"的平均轮次 门禁是否过严(09 §3 第 6 项)
申诉件数与改判率 08 §10 申诉通道的执行质量
证书纠错件数与耗时 §1.4 纠错通道是否可用

5. 公信力资产的待办清单(透明的 roadmap)

# 事项 状态 什么时候做
1 §4.1 汇总表的首批数据 待补 第一期结营 48h 后
2 工业纵深验证结论(§4.2) 待补 D+90 复评数据到位后
3 在线证书核验页 未建 编号体系跑通、第一批学员毕业后(先定编号再建页,避免返工)
4 第三方认证的叠加案例 待补 有学员真的去考了,且书面授权匿名分享
5 证书到期提醒与复检包的首次实操 未跑 第一批证书发出后第 60 天提醒触发时——流程本身也要先跑一次,才知道哪一步卡人

这张表故意把"还没做到的事"和"已经做到的事"放在同一页。 09 §10 说过:无法证伪的形容词是自欺。 别人的认证页不会告诉你他哪里没做,我们会。


6. 本章不改变的事实

  1. 不承诺就业、不承诺收入(10 §8 逐字有效)——有了数据也不改口。
  2. 不声称任何第三方互认或等价(§2)。
  3. 课文仍为中文母稿(13 §6 #9 仍成立);英文侧只有页面壳与仓库里的英文快速入门 (course-level-1/en/README.md,快速入门 ≠ 课文翻译),不译正文。
  4. 本课证书不是职业资格(§1.1)。
  5. 13 §6 #2 的"不能拿认证当卖点"仍逐字有效——叠加第三方认证是你个人的资产,不是本课的卖点。

7. 反模式:自毁公信力的六种写法

  1. 给「待补」填数字。 一个假数字毁掉的是整张表——包括那些真的数字。
  2. 小样本海报。 把 n = 5 的那期做成宣传图,等于承认其他期不敢发。
  3. 换算就业率 / 涨薪率。 问卷没问的问题,答案从哪来?
  4. 拿第三方认证做课程卖点。 那是人家的证;用人家的证给自己贴金,两头都不占理。
  5. 只发最好的一期。 见 §3.3 第 3 条。
  6. 把"过期"说成"作废"。 今天混淆这两个概念,明天就会混淆"撤销"和"没通过"。

8. 一页速查

我想…… 去哪
查证书证明什么、不证明什么 §1.1 边界表
查编号规则 / 怎么核验 §1.2
查有效期 / 到期怎么办 §1.3
觉得评分判错了 / 证书信息打错 §1.4(申诉三步 / 纠错通道)
找可叠加的第三方认证 §2.1 三条路径 + §2.2 顺序
查结果指标的口径与采集时点 §3.2(五项)
知道哪些数字现在能对外说 §3.3 四条纪律
看第一期的结果数据 §4.1(现在是「待补」)
看工业纵深的验证结论 §4.2(回填 14 §5.4)
看还没做到的公信力事项 §5 待办清单

发布前自查(任何对外带数字的材料,逐条过):

  • ☐ 每个比率都带了分母与样本量?
  • ☐ 样本 n ≥ 20?不到就只做定性描述?
  • ☐ 连续展示了所有期次,没有只挑最好的一期?
  • ☐ 没出现"就业率 / 涨薪率 / 平均薪资"这类问卷里没有的字段?
  • ☐ 同时写了这期没达标的硬线?
  • ☐ 引用的第三方价格 / 规格标了来源与查证日期(13 §8)?
  • ☐ 学员原声 / 作品集展示都拿到了书面授权?

上一章:14 课后纵深与影子项目|本章是本课程的最后一章 相关:03 评估体系与通关门禁 · 08 运营手册 · 09 运营指标与复盘 · 13 GTM 页面与竞品对比

16 · D1 逐节教案:入门日

16

course-level-1/16-D1逐节教案.md

本文件是 D1 六小时直播的逐节执行稿:每节课讲什么、怎么说、屏幕放什么、学员做什么、卡住怎么救、下一节怎么接。 上游时间盒:02-逐日教学大纲.md Day 1|通用骨架与控场:05-讲师手册.md §2 / §8 备课底料:00-FDE方法论历史与原理.md(讲师看、学员不看)|学员侧任务卡:06-学员手册与作业包.md D1 本日演示数据:examples/quickstart_csv/sample_tickets.csv(虚构工单)· 演示客户:茶语万象 / 星澜科技(Adnova)(全部虚构)


0. 今天的三条红线(全天不许破)

# 红线 怎么守
1 全天只出现 3 个新概念:交付链路 · 门禁 · 真实数据 任何时刻冒出第 4 个术语 → 写进"停车位"(白板角落),课后答疑再讲
2 必须"故意翻车"一次 M4 演示中先跑 corpus 再"想起"没定成功标准(脚本见 §4)
3 M1 只讲到"故事层" 起源时间线 + 40/30/30 + 一句"FDE 是做 80%→99% 那一段的活";原理见 00 §2,今天不展开

两个硬性休息:10:15–10:30(M1→M2)· 14:30(M4→M5 之间短休 10 分钟)

05 §3 规定 14:30 为第二个硬性休息点。本稿按"14:30 短休、M5 顺延到 14:40 开始、压到 50 分钟"执行;若现场准点,M5 可回到 60 分钟并把演示放慢。

为什么这么苛刻:D1 是全场唯一的 6 小时长直播。新手一天能吸收的新概念上限就是 3 个—— 宁可少讲一个原理,也要保证"他敢自己动手跑一遍"。

今日 8 节课总览

节 时间 一句话目标 学员产出 记忆锚点
S0 开营 09:00–09:30 立契约:这门课怎么上 —— "我最怕现场的那件事"
S1 M1 世界观 09:30–10:15 FDE 到底是干什么的 世界观笔记 FDE = 随队工程师
S2 M2 交付地铁图 10:30–11:30 一眼看全 4 区 18 阶段 手绘/数字地铁图 4 条线、每站要验票
S3 M3 三律 11:30–12:00 记死三句话 —— 先标准、真数据、可验证
S4 M4 工具箱开箱 13:30–14:30 亲手跑通第一条命令 冒烟证据 先看再装
S5 M5 看控制台 14:40–15:30 看见门禁真的会拦人 控制台截图 红色 blocker
S6 M6 迷你链路挑战 15:30–16:30 独立复现一遍 🎯 产出 1 "我刚才干了什么"
S7 门禁 G1 + 答疑 16:30–17:00 交作业、拿反馈 通过 G1 明天你是进场第一天

S0 · 开营(09:00–09:30 · 30 min)

本节定位:不讲课。只做三件事——让学员开口、让契约落地、让掉队风险提前暴露。

一句话目标(开场念):"今天结束时,你能用自己的话讲清 FDE 交付链路,并亲手跑通第一条迷你链路。"

分钟级时间盒

分钟 动作 目的
0–5 讲师自我介绍(带一个翻车故事)+ 今天不讲课先立规矩 建立"这里可以犯错"的安全感
5–16 学员接力自我介绍:30 秒/人 = 我是谁 + 我最怕现场哪件事 收集真实痛点,讲师现场归类
16–24 课程契约:D2–D8 每天 2.25h、门禁制、诚实边界、数据红线 防止"抽空看看"式报名
24–28 今天的三条红线 + 时间结构(含两个硬性休息) 降低认知焦虑
28–30 环境预警:现在就跑一次 python3 --version 把装环境失败提前到 M4 之前

讲稿要点

① 讲师自我介绍必须"带代价"(0–5 min) 不要说"我做过 N 个项目"。说一个具体的翻车:

"我曾经在一个项目里,第三周才发现客户说的'准确率'和我理解的不是一回事—— 他要的是'客服不用改一个字就能发出去',我做的是'分类对了就行'。 那天我回去把已经写好的两百行删了。今天这门课的第一条原则,就是那两百行换来的。"

要求:真实、脱敏、有代价。宁可少讲,不可编造(05 §1 铁律)。

② 学员自我介绍:30 秒/人,第二句是关键(5–16 min)

话术模板(投屏):

我是 <姓名>,我现在在 <公司/岗位>。
我最怕现场的一件事是:<一句话>。

讲师必须做一件事:把每个人"最怕的事"当场归类到 4 区,并写进白板/文档。

  • "怕客户不给我数据" → Zone A(定边界)——"D2 我们专门练这个"
  • "怕数据太脏" → Zone B(造物)——"D3 你会看到更脏的"
  • "怕上线了没人会用/出事没人管" → Zone C(稳运)——"D6 就是给你的"
  • "怕人走了东西没人接" → Zone D(交离)——"D7 教你交得出去"

这个动作本身就是教学内容:45 人 × 30 秒 = 22 分钟,看起来"浪费",实际上它同时完成了 ① 破冰 ② 痛点收集 ③ Zone A 干系人识别的现场演示("你们刚才说的每一句,都是我在做需求框定时要问的")。 人数 > 35 时压到 20 秒/人,或分两组由助教并行收。

③ 课程契约(16–24 min)——照 06 §1 念,不展开

五条要点(投屏,学员在群里回"已签署"):

  1. 时间:D1 全天 6 小时;D2–D8 每天约 2.25 小时(90 min 直播 + 45 min 自练),整期约 22 小时。
  2. 每天交一件产出,产出里必须有证据(命令、文件、截图)——没有证据 = 没交。
  3. 门禁制:当天产出不过关,暂时进不了下一关;补交可以,但留痕。
  4. 练习只用虚构数据或你自己已脱敏的数据;真实客户名与 PII 一律不进群、不上传。
  5. 鼓励用 AI 助手,但你得能脱稿讲清自己的关键决策(D8 答辩会抽查)。

④ 三条红线 + 时间结构(24–28 min) 直接念 §0 的表。特别说明第二条:"今天我会故意犯一个错,你们要抓住我——抓住的有加分。"

⑤ 环境预警(28–30 min) 让全体当场跑一次:

python3 --version      # 期望 ≥ 3.11

不达标的,现在就进"环境急诊室"(助教 1v1),不要等到 13:30 才开始装。

投屏·板书

  • 左:话术模板 + "我最怕的事 → 4 区"对照(实时填)
  • 右:三条红线 + 契约五条
  • 白板角落预留:停车位(Parking Lot)——今天所有跑题问题先记这里

互动设计

问题 期望答案 冷场备选
"你最怕现场哪件事?" 任何真实回答都接住,并归类到区 讲师先自曝一个,再点"第二位"(不点第一个举手的人)
"如果只能带走一句话,你想带走什么?" 无标准答案,收集期望用于 D8 回看 改成选择题:"A 会跑工具 / B 知道怎么定边界 / C 敢跟客户说不"——群里打字母

常见错误与纠偏

错误 纠偏
学员自我介绍变成"背简历"(讲 2 分钟) 讲师举牌 30 秒;"第二句才是重点,第一句我知道你是谁就够了"
有人不肯开口 不点名逼问;私聊补收,公开只说"还有两位同学我私下单独聊"
讲师自己讲太长挤掉学员时间 硬性:16 分钟必须开始收自我介绍;宁可少收 3 个人,也要准时进契约

承接语(最后 30 秒)

"好——你们刚才说的每一句'最怕',其实都在同一张地图上。接下来 45 分钟,我把那张地图给你们。"

学员笔记要点

  • 整期节奏:D1 全天 + D2–D8 每天约 2.25h,合计约 22h
  • 每天必须交一件带证据的产出
  • 数据红线:只用虚构/已脱敏数据,真实客户名与 PII 不上传
  • 今天三条红线:3 个新概念、一次故意翻车、M1 只讲故事

S1 · M1 世界观(09:30–10:15 · 45 min)

本节定位:全场唯一一段"讲故事"时间。目标是换世界观,不是传知识。

一节课的 KPI(很重要):下课时学员能说出这一句话 ——

"FDE 不是做从 0 到 80% 的活,是做从 80% 到 99% 的活。"

只要这一句记住了,本节就算成功。其余全忘掉都可以。

分钟级时间盒

分钟 动作 目的
0–5 收课前预读问题:"FDE 和售前 / 实施 / 外包差在哪?"——举手回答 让学员先输出,讲师后补充
5–15 三位前身 + "随队工程师"类比 用类比替代定义
15–24 时间线三锚点:2003 → 2023 → 2024–2026 建立"这不是网红岗位"的时间感
24–31 一句话对比:FDE vs 售前 / 实施 / 客户成功 解决最常见的混淆
31–38 40 / 30 / 30 能力模型 让学员知道 60% 要靠做中学
38–43 中国市场的三个特殊性(讲 3 个小故事,不讲报告) 校准"照搬硅谷"的错经验
43–45 收口一句话 KPI + 布置世界观笔记 留一个明确动作

讲稿要点

① 开场先收问题,不先给答案(0–5 min)

预读问题是 06 §0.5 布置的:"FDE 和售前、实施、外包到底差在哪?" 点名 2–3 人回答(先点举手的人,再点一个没举手的)。学员答什么都可以,讲师只做一件事:补齐缺失的那一块。

② 三位前身(5–15 min)——照着 00 §1.1 讲

前身 干什么 缺什么
解决方案架构师 / 售前 讲清方案能不能做 讲完就走,不负责跑起来
实施 / 交付工程师 把成熟产品装起来 只能"配方化"交付,产品不成熟就抓瞎
驻场外包 / 咨询顾问 客户要什么做什么 经验留在个人脑子里,不回产品

FDE = 三者的合体 + 一个新东西:把现场经验回流成产品能力。

逐字稿(可直接念):

"售前是试驾员——带你开一圈,签单就走。 实施是装车工——车是好的,他负责装起来;车要是不成熟,他就抓瞎。 外包是代驾——你说去哪儿他去哪儿,但你家的路他没记住,下次还得重新讲一遍。 FDE 是跟车队跑完整个赛季的随队工程师:既要开得动,又要把每一站的数据带回工厂改车。 ——最后这半句,是这条线里最值钱、也最容易被砍掉的一半。"

③ 时间线三锚点(15–24 min)——只讲三个锚点

锚点 讲什么 引用纪律
2003 Palantir 成立,工程师直接派进 CIA / FBI / 五角大楼现场;因为环境保密,没法"把需求带回去再开发",只能把人派进去 讲事实,不带数字
2023 AIP 推出,AI 能力层叠加到 Ontology 上——技术上准备好了 ——
2024–2026 全球 FDE 职位从约 600+ 条(2024-04)涨到 6000+ 条(2025-04),10 倍;Indeed 平台 2025-04→2026-04 从 643 → 5330 条,年增 >700%;国内 FDE 招聘增长 42 倍;OpenAI / Anthropic / Accenture + Microsoft 相继组建部署团队 必须连来源与日期一起说(00 §1.4 / §1.6,查证于 2026-09)

两个"比数字更有信息量"的观察(讲这两个,比念数字有效):

  • YC 旗下上百家创业公司在招 FDE,三年前几乎为零。
  • 采用 FDE 模式的 AI 公司,前 18 个月 ARR 增速平均比同行快 3 倍, 但客户成功团队规模只有同行的三分之一。 → 说明 FDE 不是在堆人,是在换组织形态。

反直觉事实(留一个"钩子"):Palantir 2025 财年毛利率约 82%,接近纯软件公司, 远高于传统咨询公司 30%–40%。 → "重交付"和"高毛利"可以同时成立——秘诀在 D7 讲(前线学习机制)。

引用纪律(讲师必读):00 §1.6 有两处来源冲突(如 OpenAI Deployment Company 成立时间), 讲到时照 00 说"两种说法,我们讲 2025–2026 年间",不要挑一个顺口的当定论。 所有市场数字都要连来源与日期一起讲——这是这门课"诚实"人设的第一块砖。

④ 一句话对比(24–31 min)

角色 交付的是 谁对结果负责
售前 方案与承诺 签单为止
实施 装好的产品 装完为止
客户成功 续约与满意度 关系为止
FDE 在客户现场跑起来的系统 + 回流产品的经验 从 80% 到 99%,直到能交出去

⑤ 40 / 30 / 30 能力模型(31–38 min)

能力 占比 内容
工程能力 40% 全栈开发、部署、调试、运维
业务能力 30% 理解客户业务、拆解需求、定义成功
解决方案能力 30% 架构设计、技术选型、风险控制

读法(逐字念):"40% 是入场券。这门课给你工程侧的起步 + 业务意识的种子; 后面 60% 才是区分水平的地方——而且其中一大半只能在做中学。 所以这门课的重点不是'教会你所有东西',是'给你一条能自己走下去的路'。"

⑥ 中国市场的三个特殊性(38–43 min)——讲成三个小故事

不是念报告,是把 00 §1.5 三条各讲成一句话故事:

  1. "我们缺的不是前身,缺的是闭环。" → "国内早有解决方案架构师、交付工程师、AI 售前——差异在于:很少形成'现场经验反哺产品'的闭环。 所以做 FDE,第一步是把闭环补上,不是把岗位名字改掉。"
  2. "美国是加装大脑,中国是对话驱动。" → "很多客户的流程不写在系统里,写在默契和人情里。 过去的软件要求客户先填表、画流程、配规则; AI 的入口是自然语言——所以在中国,'一边跑、一边修路'反而更容易起步。"
  3. "经济性约束是真实的。" → "硅谷高价值客户能撑六到七位数美元年合同;国内大量项目在十万到百万人民币量级。 所以中国 FDE 必须靠两件事活:用 AI 和平台压低交付成本 + 用技能卡/连接器/行业模板提高复用率。" → 这一条解释了本课程为什么反复强调"技能卡""交接包""留痕"——不是为了让档案好看, 是为了让一个人的现场经验变成可复用的资产,否则国内的项目经济性撑不住。

⑦ 收口(43–45 min)——把 KPI 钉在墙上

逐字念:

"今天记住一句话就够了: FDE 不是做从 0 到 80% 的活,是做从 80% 到 99% 的活。 会搭 Demo 的人很多;能把 Demo 变成生产线上稳定系统的人很少。 下午我会让你们亲手看到这句话的证据。"

布置:世界观笔记 3 行(见下)。

投屏·板书

  • 左:3 列时间线(2003 / 2023 / 2024–2026),只写锚点与 1 个数字
  • 中:四角色类比图(试驾员 / 装车工 / 代驾 / 随队工程师)
  • 右:40 / 30 / 30 饼图(手绘,不要用精美 PPT——手绘降低距离感)
  • 底部常驻一句话:80% → 99%

互动设计

问题 期望答案 冷场备选
"FDE 和售前/实施/外包差在哪?" 提到"回流产品/现场经验"最好;否则讲师补 "猜一下:这四个角色里,谁会在项目结束后还写文档?"
"为什么 2003 年就有的岗位,2026 年才火?" 因为 AI 让"定制"的成本结构变了 改成选择:"A 模型变强了 / B 落地成本降了 / C 客户变聪明了"
"40/30/30 里,你现在最缺哪一块?" 任何答案都接,记下来 群里打 1/2/3 投票

学员动作(现场)

  • 举手回答预读问题(点名制)
  • 记世界观笔记(3 行,M1 结束前写完,不是课后):
    1. FDE 和售前/实施/外包,最大的差别是:______
    2. 我现在的岗位最像哪个前身?缺的是哪一块?
    3. 我公司现在是谁在干 FDE 的活?他缺哪一块?(这题是 06 §0.5 布置的,D2 开场会点名分享)

常见错误与纠偏

错误 纠偏
讲师兴奋起来开始讲 Ontology / 三道成本门槛 立即收:"这个在预习材料 §2,今天不展开"——红线 3
学员追问"我学完能进大厂吗" "这门课给能力与作品集,不承诺结果;D8 教你怎么把作品集正确用起来"(02 D1 常见问题表)
数字讲太细(念完整张表) 只念 3 个:600+ → 6000+、Indeed 643 → 5330、国内 42 倍;其余让学员去 00 §1.4 看
有人问"这些数字靠谱吗" 正面回答:"00 §1.6 专门列了两处来源冲突,我们如实标出不装作只有一个答案——这是这门课的引用纪律"

承接语(最后 30 秒)

"世界观装好了。现在给你地图——44 分钟后,你要能自己画出来。"

学员笔记要点

  • FDE = 售前 + 实施 + 驻场外包 的合体 + 把现场经验回流成产品能力
  • 类比:售前=试驾员 · 实施=装车工 · 外包=代驾 · FDE=随队工程师
  • 时间:2003 Palantir 起点 → 2023 AIP → 2024–2026 岗位爆发(引用必带来源与日期)
  • 能力模型 40 工程 / 30 业务 / 30 解决方案;40% 是入场券,后 60% 靠做中学
  • 一句话 KPI:FDE 做的是 80% → 99% 那一段的活

S2 · M2 交付地铁图(10:30–11:30 · 60 min)

本节定位:全场信息密度最高的一节,也是 D1 唯一必须"记下来"的知识结构。 把 4 区 18 阶段讲成 4 条地铁线——每站有名字、有下车证据、有闸机。

一句话目标:"下课时你手里有一张自己画的地铁图,能说出四条线分别解决什么问题。"

分钟级时间盒

分钟 动作 目的
0–5 先给结论:为什么需要地图("没有地图的交付,就是拿客户的钱试错") 动机先行
5–15 画四条线(Zone A/B/C/D),只讲每条线的一句话使命 先骨架,后血肉
15–35 18 站的名字 + 下车证据(每条线 5 分钟,逐站过) 核心内容
35–43 门禁概念:为什么"清单会烂,门禁不会";10 个闸机 7 工业 + 3 通用 今天的新概念 2
43–52 12 反模式里最常踩的 4 个(只讲 4 个,其余预告 D2–D7) 埋钩子
52–58 学员动手:画自己的地铁图(手绘/数字版皆可) 产出
58–60 收口 + 承接 M3 过渡

讲稿要点

① 为什么需要地图(0–5 min)

逐字稿:

"客户不会给你一份干净的需求。他会给你一句抱怨:'我们每周订货全凭店长拍脑袋'。 从这句话到'系统上线、客户验收',中间有 18 站。 没有地图的人会怎么干? 直接开始写代码——然后在第 3 周发现: 客户说的'准确率'和你理解的不是一回事。 今天这张地图的全部意义:让你在第 1 站就知道第 18 站长什么样。"

② 四条线(5–15 min)——只讲使命

线 区 站号 一句话使命 类比
A 线 · 定边界 Zone A 预接触 1–4 把模糊抱怨变成可交付的边界 出发前定行程
B 线 · 造物 Zone B 建造 5–10 把数据和想法变成能跑的东西 施工
C 线 · 稳运 Zone C 运营化 11–15 让东西稳得住、有人管、会进化 通水通电
D 线 · 交离 Zone D 交接退场 16–18 交得出去,带得走 交钥匙

念法:"交付不是百米冲刺,是换乘 4 条线的地铁——每站都要验票。"

③ 18 站 + 下车证据(15–35 min)——本节核心内容

讲法:逐站念"名字 → 下车证据",不解释为什么(为什么留到 D2–D7 每天讲)。 🏭 = 工业/制造 profile 专属;ticket profile 只走 15 站(跳过 3 个 🏭 阶段)。

A 线 · 定边界(1–4)

站 阶段 下车证据(离开这站时必须手里有什么)
1 项目立项与问题框定 qualification 一页"值不值得做"的判断:高价值?数据难?客户集中?
2 🏭 现场勘察 / Gemba walk site_survey 现场记录:物理环境、OT 网络、资产清单、安全约束
3 干系人地图与对齐 stakeholder_map 一张干系人地图:≥2 位发起人 + 每人"在乎什么"
4 成功标准契约化 success_criteria 客户签字的可度量 done + 时间盒(≤14d / ≤90d / ≤120d)

B 线 · 造物(5–10)

站 阶段 下车证据
5 数据接入 connect schema + 样本预览 + PII 清单
6 语料锻造 corpus 语料报告:清洗后可用量、覆盖盲区、合成补齐、train/eval/test 切分
7 真实未策展数据上原型 prototype_real_data 在真数据(不是样板数据)上跑通的输出截图
8 干系人验证 validate 验证记录:向谁演示了、接受了什么、拒绝了什么及理由
9 🏭 部署上线 deploy FAT/SAT 记录 + 功能安全分析 + 合规文件(CE / EU AI Act)
10 评估交付 eval 主指标 + 业务口径指标 + Top 3 bad case

C 线 · 稳运(11–15)

站 阶段 下车证据
11 SLO/SLA + on-call slo_sla SLO 卡:目标值 + 测量方式 + 错误预算 + 告警路由
12 Runbook 编写 runbook 5 类事件 × 四段:判断信号 → 处置 → 回滚 → 升级
13 监控与漂移检测 monitoring_drift 漂移监控 + 告警路由("AI 不是坏了才叫坏,慢慢变差也是坏")
14 🏭 变更管理 + 终用户培训 change_mgmt_training 培训题纲 + 工会/共决记录(工业现场)
15 飞轮 → 产品化 flywheel_productization ≥1 个现场特性进入产品化评审

D 线 · 交离(16–18)

站 阶段 下车证据
16 运维移交 ops_handoff 所有权移交记录(转交客户运维/CS)
17 知识转移 knowledge_transfer 文档包:runbook + eval 报告 + SLO + 模型卡 + 培训材料
18 退场 disengage 客户签字 + 退场计划(≤120 天,含终止条件)

④ 门禁:今天的新概念 ②(35–43 min)

逐字稿(核心比喻,全场要重复):

"清单会烂,门禁不会。 你见过项目计划表吗?第一周很漂亮,第三周开始有人打勾但不做事,第五周没人看了。 清单是自觉,门禁是制度。 门禁长什么样?就是检票闸机—— 你没票,它不放你走。它不骂你,也不听你解释,它只是不放行。"

门禁怎么运作(投屏讲):

  • 每个门禁有两种判定:
    • blocker:硬拦,过不去,必须补齐
    • warning:放行,但留痕并扣作品集等级
  • 门禁是活的:每次推进阶段都会重新评估当前阶段的全部门禁—— "上周过了不代表今天还过"。一份过期的"已通过"记录,永远不会自动放你过去。
  • 怎么查:
    fde-scope gate list                        # 看全部 10 个门禁(🏭 工业专属 7 关 / 🏢 通用 3 关)
    fde-scope gate check <你的档案id>           # 查当前阶段第一个门禁
    fde-scope gate check <你的档案id> --gate slo   # 查指定门禁
    

10 个闸机 = 7 工业专属 + 3 通用(03 §2):

类型 数量 门禁 挂在第几站
🏢 通用 3 success_criteria · slo · handoff_signoff 4 · 11 · 18
🏭 工业专属 7 site_survey · air_gap · fat_sat · functional_safety · conformity · shift_handover · works_council 2 · 5 · 9 · 9 · 9 · 11 · 14

念法:"注意最后一行——第 9 站挂了 3 个闸机。 为什么?因为工业现场的'上线'不是技术动作,是合规动作。这个 D5 会亲眼看到。"

⑤ 12 反模式里最常踩的 4 个(43–52 min)

讲法:每个给一个现场画面,不给定义。其余 8 个预告"每天讲 1–2 个"。

# 反模式 现场画面(讲师照着讲) 课程里在哪治
1 Sponsor Collapse(唯一发起人) "项目很顺。三个月后那位副总调岗了,新来的第一句话是'这个项目我们重新评估一下'。你前面三个月白干。" D2
2 Demo-Debt(把 Demo 当交付) "演示那天客户鼓掌。生产上线那天你才发现:演示用的是挑过的 200 条数据,线上是没人挑过的 200 万条。" D5
3 Data Quality Surprises(假设数据是干净的) "客户说'数据在数据平台上了,随时能取'。你打开一看:同一个客户名有 7 种写法,日期有 3 种格式,还有一列全是空的。" D3
4 Scope Creep(范围蔓延) "客户说'既然都做了,顺手加个报表吧'。你答应了。加了 4 次以后,交付日期推了两个月,你成了唯一一个还相信这个项目的人。" D2

一句话总结:"这 4 个反模式有一个共同点:它们都不是技术问题,都是判断问题。 这就是为什么这门课先教定边界,再教写代码。"

⑥ 学员动手画图(52–58 min)

要求(投屏):

画你的交付地铁图(手绘/数字版都行):
1. 四条线,每条线写一句话使命
2. 每站写"站名 + 下车证据"(可以只写你记得的,缺的留空)
3. 用红笔圈出你觉得自己最可能翻车的 2 站
4. 在图上标一个 🏭(如果你是工业场景)

助教巡场,只答卡住超过 3 分钟的问题。允许留空——留空的地方就是课后要找的地方。

⑦ 收口(58–60 min)

"地图有了。但地图上还缺一样东西——你凭什么判断该在哪一站停下? 接下来 30 分钟,讲三个判断。"

投屏·板书

  • 主体:一张手绘地铁图(4 条横线,标注 18 站,🏭 站画方框)
  • 右侧常驻:门禁 = 检票闸机;blocker(红)/ warning(黄)
  • 底部:清单会烂,门禁不会

互动设计

问题 期望答案 冷场备选
"哪一站最容易跳过?为什么?" 第 4 站(成功标准)——因为"客户催得急" 投票:"A 第 4 站 / B 第 6 站 / C 第 17 站"
"如果是你自己家装修,你会在哪一站验票?" 任何答案→引到"验收标准必须客户能自己验" "装修队说'相信我',你给钱吗?"
"红笔圈出来的两站,说说为什么?" 抽 2 人说,讲师归类到反模式 讲师先自曝自己最常翻的那一站

学员动作(现场)

  • 画地铁图(必须动手,不许只看)
  • 在图上做两件事:红笔圈 2 个高危站 + 标 🏭
  • 把图拍照发群(命名 D1-姓名-地铁图,对应产出 1 的附件)

常见错误与纠偏

错误 纠偏
学员抄 PPT 而不是画图 要求"画,不是抄"——手绘版优先,因为手绘会强制你理解结构
纠结某一站到底归哪条线 "别纠结边界,先记住每站要交什么"
有人问"为什么工业要额外 7 个门禁" "因为停工一分钟就是几十台车——D3/D5 会给你看真实的拦截现场"(案例 C,见 07-实战剧本与案例库.md §2.3)
助教开始替学员画 助教只巡场答问,不动学员的纸

承接语(最后 30 秒)

"地图有了,闸机也有了。但光有地图,你还是会走错——因为地图不告诉你'什么时候该停'。接下来 30 分钟,三条铁律。"

学员笔记要点

  • 四条线:A 定边界(1–4)· B 造物(5–10)· C 稳运(11–15)· D 交离(16–18)
  • 每站都要有下车证据;ticket profile 走 15 站,跳过 3 个 🏭
  • 门禁 = 检票闸机;blocker 硬拦 / warning 放行留痕;10 个闸机 = 7 工业 + 3 通用
  • 第 9 站(部署上线)挂 3 个闸机:工业上线的本质是合规动作
  • 今天记住 4 个反模式:Sponsor Collapse · Demo-Debt · Data Quality Surprises · Scope Creep

S3 · M3 三律(11:30–12:00 · 30 min)

本节定位:把 D2–D7 六天要反复复用的三条判断规则一次讲透。 这是 00 §2.4 / §2.5 唯一的"正式讲授"时段。

一句话目标:"记住三句话,后面六天每天都用它们。"

分钟级时间盒

分钟 动作 目的
0–3 先讲今天最大的一个数字:60% 停在试点 制造焦虑(诚实的焦虑)
3–13 80/95/99 阶梯图 + "最后 1% 人工兜底" 三律第一律的出处
13–21 三律逐条讲,每条配一个翻车现场 记忆挂钩
21–27 学员动作:写下自己工作中违反三律的一件事 迁移到自身
27–30 收口 + 承接 M4("下午你会亲手体验其中一条") 过渡

讲稿要点

① 先给一个数字(0–3 min)

"两个数字(来源:腾讯研究院报告 Ch.01 §1.4): 超过 70% 的企业已经在至少一个职能里尝试生成式 AI; 超过 60% 仍然停留在试点或实验阶段。 ——六成企业的 AI 项目没走到生产。

② 80 / 95 / 99(3–13 min)——画阶梯图

阶段 需要什么 难度感受
0 → 80% 通用大模型 + 简单 Prompt 很容易——有经验的工程师一天就能搭出"挺好用"的原型
80% → 95% 大量 Prompt 优化、规则补充、数据标注、测试集构建 难——模型在特定场景出错、行业术语理解不准、边界情况处理不了
95% → 99% FDE + 专用平台 + 上万级真实对话数据 非常难——1% 的错误也可能造成严重后果;而且 "改好 A 又坏 B"

本节最该被记住的一句(00 §2.4 原文): FDE 不是做从 0 到 80% 的活,而是做从 80% 到 99% 的活。 ——会搭 Demo 的人很多;能把 Demo 变成生产线上稳定系统的人很少。

为什么上限是 99%,不是 100%?(三条理由,念一遍即可)

  1. LLM 是概率系统——数学上不存在 100% 保证;
  2. 从 99% 推到 99.9%,边际成本指数级增长、边际收益递减;
  3. 高风险场景那 1% 不应该让 AI 覆盖,而应通过人工审核和回滚机制兜底。

最漂亮的一句,建议背下来: 99% 不是技术妥协,而是工程经济学的最优解: AI 覆盖可规模化的 99%,人工守住不可自动化的 1%。

现场用法:客户说"我要全自动、不出错"时——用这句话回应, 然后带他一起设计那 1% 的人工兜底流程(这正是 D6 的 Runbook)。

③ 三律(13–21 min)——每条配一个翻车现场

第一律:先成功标准,后代码

出处:上面那个"60% 停在试点"。瓶颈不在模型能力,也不在工具,在人—— 真正卡住的是最后 20% 的生产化工程。

翻车现场(讲师讲自己的): "客户说'我要提升客服效率'。我做了三个月,上线那天他说'这不是我想要的'。 我问他想要什么,他说'客服能少招 5 个人'。 ——这句话我第一天就能问到。我花了三个月。"

判断口诀:"这句话,客户用什么数字来验收?"(05 §5 提问库)

第二律:在真实脏数据上做原型

翻车现场: "我在挑过的 200 条数据上做了个 Demo,效果 95%,客户鼓掌。 上线那天用的是没人挑过的 200 万条,效果掉到 61%。 客户问我'你不是说 95% 吗'——我无法解释,因为我从没在真数据上跑过。"

金句:"在样板间练出来的手艺,撑不过毛坯房。"

今天的证据:下午你会亲手跑 connect——你会看到这份"看起来挺正常"的数据, 实际只有 20 条、分成 9 类(详见 §4)。

第三律:一切产出可验证

翻车现场: "我交付的时候说'这个系统很稳定'。客户问'多稳定?' 我说'挺稳定的'。他说'上次那个供应商也这么说,然后我们崩了三次'。"

定义:可验证 = 别人能拿着你的产出,自己跑一遍,得到同样的结果—— 命令可复制、数字可复现、结论有依据、说谎会被抓。

为什么这条最重要:它是唯一能替代"你要相信我"的东西。

④ 学员动作(21–27 min)

投屏指令:

写下你工作中违反过这三律的一件事(3 行,给自己看,不交):
1. 哪一律?(先标准 / 真数据 / 可验证)
2. 当时发生了什么?代价是什么?
3. 如果重来,你会在哪一步做不一样?

不交、不分享。只用于 D8 答辩时"如果重来会改什么"那一题的素材积累。

⑤ 收口(27–30 min)

"三律讲完了。上午结束——下午你要亲手跑一条链路,而且我会故意犯一个错,你们抓我。 13:30 准时开始,先把环境准备好的人,下午会轻松很多。"

投屏·板书

  • 主图:80 / 95 / 99 三级阶梯(手绘),顶端标 "FDE 在这段"
  • 右侧:三律各一行 + 对应金句
    • 先成功标准后代码 → "客户用什么数字验收?"
    • 真数据上原型 → "样板间的手艺撑不过毛坯房"
    • 一切产出可验证 → "同命令,同结果"
  • 底部:60% 停在试点(唯一的市场数字)

互动设计

问题 期望答案 冷场备选
"为什么不是 100%?" 概率系统 + 边际成本 + 高风险那 1% 该人工 改成选择:"A 做不到 / B 不划算 / C 那 1% 不该给 AI"
"客户说'我要全自动不出错',你怎么答?" 用 99% 那句话 + 一起设计 1% 的兜底流程 讲师演客户,学员现场回
"三律里哪一条最难做到?" 第一律(因为要顶住客户催) 群里投票

常见错误与纠偏

错误 纠偏
学员把 80/95/99 记成"准确率目标" 纠正:"这是成本结构的分界线,不是成绩单"——0→80 便宜,80→99 才要人
有人问"那 99.9% 的项目怎么办" "边际成本指数增长——先算钱,再谈指标"
三律讲成空洞口号 每条必须配翻车现场;没故事的讲师去 00 §2.4 找依据,不要编

承接语(最后 30 秒)

"记住三句话,后面六天每天都用。现在——午休。13:30 回来,动手。"

学员笔记要点

  • 市场事实:70% 企业在试,60% 停在试点(引用带来源与日期)
  • 0→80% 容易,80→99% 才是 FDE 的战场;99% 是工程经济学最优解
  • 三律:① 先成功标准后代码 ② 在真实脏数据上原型 ③ 一切产出可验证
  • 三律的检验口诀:"客户用什么数字验收?" / "样板间 vs 毛坯房" / "同命令,同结果"

S4 · M4 工具箱开箱(13:30–14:30 · 60 min)

本节定位:第一次动手。目标是破除"这是程序员的事"的心理门槛—— 所有命令都是可复制的,学员的任务是看懂每一步在干什么。

一句话目标:"亲手跑通第一条链路,并且亲眼看到一次'跳过成功标准'的代价。"

本节含今天唯一的"故意翻车"(红线 2),翻车脚本见下文 ⑤。

分钟级时间盒

分钟 动作 目的
0–8 装环境 + 冒烟:pip install -e ".[dev]" 门槛最高的 8 分钟,助教全力巡场
8–16 第 1 步 connect:建立"先看再装"的职业习惯 新概念 ③ 真实数据
16–26 第 2 步 corpus:讲"淘米"类比 核心类比
26–33 打开报告:逐段读关键数字,示范"对客户怎么说" 证据意识
33–41 故意翻车:讲师先跑 corpus 再"想起"没定成功标准 红线 2
41–50 第 3 步 web:打开控制台(M5 的引子) 预告
50–60 学员跟上重跑一遍(不要求跑完,要求"跑起来") 保证下午不断档

演示脚本(讲师投屏,逐条敲,不要复制粘贴大段)

# 第 0 步:装环境(一次性)
pip install -e ".[dev]"

# 第 1 步:先看数据长什么样(look before you load)
#          —— 建立"先看再装"的职业习惯
fde-scope connect --type csv --source examples/quickstart_csv/sample_tickets.csv

# 第 2 步:锻造语料 —— 讲"淘米"类比:去砂(去重)、去石(质量门)、补水(补盲)
fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --out reports/corpus_report.html

# 第 3 步:打开报告 —— 逐段读关键数字,示范"对客户怎么说"
open reports/corpus_report.html      # macOS;Windows 用 start,Linux 用 xdg-open
# 学员更推荐:直接在文件管理器里双击 reports/corpus_report.html

# 第 4 步:打开控制台(M5 的主角,先埋个引子)
fde-scope web     # → http://127.0.0.1:8080
# 这一步不用敲 open:把终端里打印的 http://127.0.0.1:8080 复制到浏览器即可

讲稿要点

① 装环境(0–8 min)

pip install -e ".[dev]"
  • 期望输出末尾看到 Successfully installed。
  • 不需要:API key、Docker、AgentScope——全链路有零 key 路径。
  • 报错 → 立刻切 11-工具与环境准备.md 第 3 节排查表;仍不行进"环境急诊室"; 最差情况助教共享屏代跑、学员口头指挥——照样算完成(02 D1 降级路径)。

讲师提醒:这 8 分钟不要讲任何概念。装不上的学员现在最需要的是"别慌"。

② 第 1 步 connect:先看再装(8–16 min)

跑完的真实输出(sample_tickets.csv,2026-09 实测):

FDE Scope v0.1.0 — connect · csv
Schema · examples/quickstart_csv/sample_tickets.csv
┌─────────┬────────┬──────────┬──────┐
│ field   │ type   │ nullable │ PII? │
├─────────┼────────┼──────────┼──────┤
│ id      │ string │ False    │      │
│ content │ string │ False    │      │
│ category│ string │ False    │      │
│ channel │ string │ False    │      │
└─────────┴────────┴──────────┴──────┘
rows≈20 · categories=['物流查询','退款','账号问题','退换货','支付问题',
'订单修改','会员咨询','发票咨询','售后补发'] · channels=['chat','email','phone']
✅ Sample extracted → samples/preview.json

逐行讲(这是本节最重要的 5 分钟):

  1. Schema 表:4 个字段、类型、是否可空。 PII? 那一列全空——但不亮 ≠ 没有 PII。

    讲师当场追问:"这份数据的 content 列里,如果写着'我的手机号是 138xxxx',它算不算 PII?" —— 算。schema 探测只按字段名判(name/email/phone 这类列名才亮), 自由文本必须逐条看值。这是 D3 的第一个坑,今天先埋。

  2. rows≈20:只有 20 条。

    "客户说'我们有海量数据',你打开一看是 20 条。这就是真实数据的第一课。"

  3. 9 个类别:20 条分成 9 类,平均每类 2 条多——极度不均衡且极度稀疏。
  4. ✅ Sample extracted → samples/preview.json:命令有产出文件。

    "没有产出文件的命令等于没跑。 这门课所有作业都要求证据——这就是证据的样子。"

新概念 ③「真实数据」就落在这里:不是"数据"这个词, 而是"真实数据是脏的、少的、不均衡的"这个体感。

③ 第 2 步 corpus:淘米(16–26 min)

先讲类比(30 秒):

"语料工程就是淘米: 去砂 = 去重(同一个客户名字 7 种写法,是一种米还是七种米?) 去石 = 质量门(空的、乱码的、错的,不能下锅) 补水 = 补盲(缺口在哪,补的是缺口,不是把米堆高)"

跑完的真实输出(2026-09 实测):

🔄 Loaded 20 raw rows
✅ PII entities masked: 2
✅ Dropped (dedup+gate): 0
✅ Corpus forged: 20 real + 395 synthetic = 415 total
⚠ Coverage gaps:
   • 物流查询: 3 (need ≥100)
   • 退款: 3 (need ≥100)
   • 账号问题: 3 (need ≥100)
   • 退换货: 3 (need ≥100)
   • 支付问题: 3 (need ≥100)
   • 订单修改: 2 (need ≥100)
   • 会员咨询: 1 (need ≥100)
   • 发票咨询: 1 (need ≥100)
   • 售后补发: 1 (need ≥100)
📊 Report → reports/corpus_report.html (+ reports/corpus_report.json)

逐行讲(关键 6 分钟):

行 讲什么
Loaded 20 raw rows 原料就 20 条——先承认现状,不粉饰
PII entities masked: 2 20 条里就有 2 处 PII 被识别并脱敏。"你的数据里一定有 PII,问题是你能不能找出来"
Dropped (dedup+gate): 0 这 20 条恰好没有重复与不合格——这是运气,真实数据很少是 0
20 real + 395 synthetic = 415 total 注意这里的诚实:报告主动标出了 395 条是合成的。"合成比例必须如实标注——这是 D4 的门禁硬指标"
⚠ Coverage gaps(9 条) 每一类都缺,都缺到 need ≥100。→ 追问全班:"所以这 20 条数据,能支撑什么、不能支撑什么?"
Report → ... 两份产出:HTML(给人看)+ JSON(给机器看)

班内提问(本节高潮):

"如果客户问:'我这 20 条数据是不是够用了?'——你怎么答?"

期望答案:"不够。9 类每类 1–3 条,连'这一类到底长什么样'都看不出来; 现在这 415 条里 95% 是我们合成的——能用来验证流程跑通, 不能用来证明'这个模型效果好'。"

④ 逐段读报告(26–33 min)——示范"对客户怎么说"

打开 reports/corpus_report.html,只读四段(详细解读放 D4):

  1. 清洗后可用量(原始 → 可用)
  2. PII 脱敏数
  3. 覆盖盲区(K 个类别,各差多少)
  4. train / eval / test 切分

话术示范(讲师念,学员记):

"您给的这 20 条,我们一条没浪费,但里面就有 2 处个人信息,我们做了脱敏。 它最大的价值是让我们看清了您业务的 9 个类别长什么样; 但它太小了——所以我们的做法是按这 9 个类别补样本、把每一类补到至少 100 条, 补了多少、哪些是补的,报告里都写着,您可以随时抽查。"

注意这句话里的"零术语"要求:没说"覆盖度""语料""合成"——D4 会专门练这个。

⑤ 故意翻车(33–41 min)——红线 2,必演

脚本(顺序很重要,一定要"演得像"):

  1. 明明已经跑完 corpus 了,假装忽然想起来:

    "哦对,我好像……还没定成功标准?"

  2. 对着屏幕停顿两秒,然后问全班:

    "我刚才跳过了哪一站?跳过它的代价是什么?"

  3. 等 10 秒(不要急着替他们答)。期望答案:第 4 站(成功标准契约化); 代价:不知道"客户用什么数字验收",所以永远不能说'做完了'—— 这正是 Infinite Pilots / Demo-Debt 的开场。
  4. 补一刀(关键):

    "更糟的是——我刚才做的东西看起来完全正常。报告生成了、数字很漂亮、 415 条语料、2 处 PII 都脱敏了。跳过成功标准不会报错。 它只会在三个月后,让你删掉两百行代码。"

  5. 引出 D2:

    "所以明天第一件事,不是学工具,是学怎么定义 done。"

讲师纪律:翻车必须是真的"跳过"(口头上、顺序上),不能变成"我给大家演示一下错误做法"—— 后者学员会当教学内容看,前者才会产生"代价的体验"。

⑥ 第 4 步 web + 预告(41–50 min)

fde-scope web     # → http://127.0.0.1:8080

先打开看一眼即可,详细讲解在 M5。讲师可以只展示一句:

"这是我们的工作台。注意到左边那张矩阵图上有红色的东西了吗? 那个红色不是装饰,是门禁在拦人。10 分钟后我们专门看它。"

⑦ 学员跟上重跑(50–60 min)

要求(投屏):

现在,你自己跑一遍(不需要全跑完,跑起来就行):
1. connect → 看到 Schema 表和 rows≈20
2. corpus → 看到 20 real + 395 synthetic = 415 total
3. 报告文件真的出现在 reports/ 目录里
4. 卡住 > 3 分钟 → 举手找助教(不要自己耗)

投屏·板书

  • 主区:终端(字号调到最大,后排要看得见)
  • 左侧常驻:四条命令的清单(学员照着抄)
  • 右侧:淘米类比图(去砂 / 去石 / 补水)
  • 翻车环节:白板上大写 "我跳过了哪一站?"

互动设计

问题 期望答案 冷场备选
"PII? 那列全是空的,说明什么?" 不亮 ≠ 没有 PII,自由文本要逐条看值 "如果 content 里写着手机号,算不算?"
"20 条里 2 处 PII,你怎么看?" PII 一定存在,问题是能不能找出来 改成选择:"A 偶然 / B 一定会有更多 / C 无所谓"
"我刚才跳过了哪一站?代价是什么?" 第 4 站;代价是永远不能说"做完了" 给三个选项让群里打字母
"这 415 条能证明模型好用吗?" 不能,95% 是合成的,只能验证流程跑通 "换成'这 415 条能用来干什么'?"

常见错误与纠偏

错误 纠偏
学员在错误目录跑命令(报错找不到文件) 强调"必须在仓库根目录、已激活虚拟环境";让学员先 pwd 看一眼
学员看不到报告(找不到 reports/ 在哪) "报告路径看错(在 reports/ 下)"——这是 06 D1 列出的头号常见坑
有人问"为什么才 20 条,是不是仓库放错了" "这就是故意选的样例数据——让你第一天就体验真实数据有多小;工业数据在 examples/quickstart_manufacturing/"
讲师忍不住替学员敲命令 闭嘴巡场(05 §2:只答"卡住超过 3 分钟"的问题)

承接语(最后 30 秒)

"恭喜——你已经跑过一条交付链路了,虽然它很短。 现在换个大屏视角:这条链路在一个系统里长什么样?"

学员笔记要点

  • 三条命令:connect(先看)→ corpus(淘米)→ 打开报告(对客户怎么说)
  • 先看再装(look before you load):不看数据就开始装,是新手第一个坑
  • PII? 列不亮 ≠ 没有 PII;自由文本必须逐条看值
  • 真实数据的第一体感:少(20 条)、不均衡(9 类)、一定有 PII(2 处)
  • 跳过成功标准不会报错——它只会在三个月后让你删代码

S5 · M5 看控制台(14:40–15:30 · 50 min)

本节定位:把 M4 的"一条命令"放大成"一个可管理的工程"。 学员要亲眼看到:门禁真的会拦人——不是吓唬,是红色 blocker 摆在屏幕上。

一句话目标:"看完这 50 分钟,你知道自己明天开始的工作,会被什么拦住。"

分钟级时间盒

分钟 动作 目的
0–6 种案例数据 + 启动 fde-scope web 让控制台里有东西可看
6–16 工作台 + engagement 矩阵 建立"多项目并行"的视角
16–28 gate 面板 + 红色 blocker(本节高潮) 门禁的具象化
28–38 引导模式 + 一个档案的完整旅程(茶语万象) 看到"走完的样子"
38–46 学员操作:找到「星澜科技」的红色截图 产出
46–50 收口 + 承接 M6 过渡

演示脚本

# 先种案例数据(幂等,重复跑安全;空仓库的控制台是空的,所以这步不能跳)
python examples/seed_mock_engagements.py

# 启动工作台
fde-scope web     # → http://127.0.0.1:8080

为什么不能跳:空仓库的控制台只有"创建一个 engagement"的提示,没有 blocker。 没有这步,本节最重要的红色就看不到(06 D1 任务卡已注明)。

讲稿要点

① 工作台与 engagement 矩阵(6–16 min)

进入 fde-scope web 后,按顺序讲三块(不要一次讲全):

  1. 工作台(首页):一眼看到"现在手上有什么"。

    "你有多个客户同时跑的时候,这张表就是你的记忆——哪家卡在哪一站,一眼可见。"

  2. engagement 矩阵:把每个客户按 4 区 × 18 阶段排开。

    "上午你们画的地铁图,在这里变成了格子。每一个格子,就是一个客户当前站的位置。"

  3. 每个 engagement 的档案:进去能看到委托单、成功标准、journal(过程流水)。

② gate 面板 + 红色 blocker(16–28 min)——本节高潮

讲述顺序(很重要):

  1. 先看「茶语万象」(标杆案例)——它的门禁是绿的。

    "这是别人家的满分作业:10 个 mock 档案里的标杆。看清楚每一站该长什么样。" (档案版成功标准:≤14d 完成数据接入 · ≤90d AI 订货预测上线覆盖 90% 门店 · MAE 较基线下降 ≥20% · ≤120d 完成运维移交,SLO 99.5%)

  2. 再看「南湾汽车」(工业案例,门禁被真实拦截)——停在 deploy 阶段,三个门禁全红:

    COLUMNS=200 fde-scope engage list                                 # 找到 eng-southbay-manufacturing-seed03
    fde-scope engage status eng-southbay-manufacturing-seed03         # 停在 deploy 阶段
    fde-scope gate check eng-southbay-manufacturing-seed03                            # ✋ fat_sat:SAT 未执行
    fde-scope gate check eng-southbay-manufacturing-seed03 --gate functional_safety   # ✋ 未做危险分析
    fde-scope gate check eng-southbay-manufacturing-seed03 --gate conformity          # ✋ CE / Annex IV / 危险分析 三条
    

    念这段话(本节最重要的一段): "FAT/SAT 未执行、功能安全未做危险分析、EU AI Act 高风险 → 缺 CE 与技术构造文件。 三个门禁全红——仅 conformity 一家就报了 3 条 blocker。 这正是今天想让你亲眼看到的:工业现场的'上线'不是技术动作,是合规动作。"

  3. 再看「星澜科技(Adnova)」(反面教材)——success_criteria 门禁是红的。

    "它的委托单其实很漂亮,成功标准也有数字。 但干系人地图上,发起人只有 1 个。 ——追问你们一句:如果这位 COO 下季度调岗,这个项目还活着吗?" → 引出 Sponsor Collapse(D2 正式讲)。

顺带讲一个"设计不是 bug"的点:gate check 撞上 blocker 时, 系统会自动记一张待审技能卡草稿(这是飞轮设计,不是 bug)。 看完用 fde-scope skill review 查、fde-scope skill archive <skill-id> 清掉即可。

③ 引导模式 + 完整旅程(28–38 min)

  • 引导模式:控制台会告诉你"当前阶段该做什么"。

    "你们现在不需要记住 18 站的全部细节——系统会在每一站告诉你该干什么。 今天要求的是'知道有地图',不是'背下地图'。"

  • 茶语万象的完整旅程:从 qualification 一路看到 disengage。

    "这是走完全程的样子。你会注意到 ticket profile 跳过了 3 个 🏭 阶段,实走 15 站。"

  • 顺带演示 fde-scope gate list:10 个门禁,🏭 7 关 / 🏢 3 关。

④ 学员操作(38–46 min)

投屏指令:

1. 找到「星澜科技(Adnova)」
2. 找到它红色的 blocker 那一页
3. 截图保存(这就是 D1 任务卡要的证据)
4. 顺手看一眼「茶语万象」——它的门禁是绿的,对比一下差在哪

⑤ 收口(46–50 min)

"刚才那个红色,就是你以后每天要盯的东西。 但今天最后 30 分钟,你们要再自己跑一遍——这次我不带,你们自己走。"

投屏·板书

  • 主区:浏览器(控制台),必须全屏,红色 blocker 要显眼
  • 白板:门禁是活的——"上周过了 ≠ 今天还过"
  • 底部对照:茶语万象(绿)vs 南湾汽车(三红)vs 星澜科技(一红)

互动设计

问题 期望答案 冷场备选
"星澜科技的门禁为什么红?" 发起人只有 1 个 → Sponsor Collapse 风险 "如果这位 COO 下季度调岗,项目还活着吗?"
"南湾汽车为什么上不了线?" 不是技术问题,是合规(FAT/SAT、功能安全、CE) "A 技术不行 / B 合规没做 / C 客户不想上"
"红色 blocker 和你有什么关系?" 明天起你的产出会被这样拦 "如果你是讲师,你会因为什么拦下自己的作业?"

常见错误与纠偏

错误 纠偏
学员没跑 seed 就打开控制台,看到空页面 "空仓库的控制台只有'创建一个 engagement'的提示,没有 blocker——所以这步不能跳"
engage list 的 id 被截断成 eng-xxx-t… 用 COLUMNS=200 fde-scope engage list
有人纠结"这些客户是真的吗" "全部虚构,与任何真实公司无关;案例 A–D 与 07 的剧本同名同源,可以对着看"
gate check 产生了技能卡草稿,学员以为出错 说明这是飞轮设计;用 fde-scope skill review / archive 处理

承接语(最后 30 秒)

"地图你有了,闸机你也看见了。现在,自己跑一遍。"

学员笔记要点

  • fde-scope web = 工作台 / engagement 矩阵 / gate 面板 / 引导模式
  • 门禁是活的:每次推进都会重新评估;上周过了 ≠ 今天还过
  • 三类典型:茶语万象(绿,标杆)· 南湾汽车(三红,工业合规)· 星澜科技(一红,唯一发起人)
  • 空仓库看不到 blocker——必须先 python examples/seed_mock_engagements.py
  • 今天要交的证据之一:星澜科技红色 blocker 那一页的截图

S6 · M6 迷你链路挑战(15:30–16:30 · 60 min)

本节定位:学员独立复现。讲师闭嘴,助教主攻。 这是 D1 的唯一产出(🎯 产出 1)的生成时段。

一句话目标:"不靠讲师,你自己跑完 connect → corpus,并跟同桌用 3 句话讲清楚。"

分钟级时间盒

分钟 动作 目的
0–5 宣布规则 + 复习三条命令(不演示,只列清单) 断奶
5–35 学员独立跑;助教巡场;讲师只答卡住 > 3 分钟的问题 产出
35–45 同桌互讲:3 句话讲清"我刚才干了什么、为什么" 费曼复述
45–55 抓 2–3 人上台复述(随机点名,不点积极分子) 验证真懂
55–60 对照 G1 自查 + 预告 S7 收口

讲稿要点

① 规则(0–5 min)

投屏(只列清单,不演示):

今天你要独立完成:
1. fde-scope connect --type csv --source examples/quickstart_csv/sample_tickets.csv
2. fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --out reports/corpus_report.html
3. 确认 reports/corpus_report.html 真实存在(不是"我以为生成了")
4. 准备 3 句话(下一环节要用)

规则:
· 卡住 > 3 分钟 → 举手,不要自己耗
· 讲师不给答案,只问你"你试了什么"
· 卡住不是失败,是今天最值钱的时刻

② 学员独立跑(5–35 min)

  • 助教巡场,只答"卡住超过 3 分钟"的问题。
  • 讲师闭嘴。可以在白板上写:"卡住 > 3 分钟再举手"。
  • 达标的标志(投屏,学员自对):
    1. connect 输出里能看到 Schema 表和 rows≈20
    2. corpus 输出里能看到 20 real + 395 synthetic = 415 total
    3. reports/corpus_report.html 真的在那里

③ 同桌互讲:3 句话(35–45 min)

投屏模板(必须包含"为什么"):

跟同桌讲 3 句话:
1. 我刚才做了什么?(动作)
2. 为什么要先看数据,再动手?(理由)
3. 报告里最重要的数字是哪个?为什么是它?

期望的"及格答案"(讲师念一遍示范,让学员知道标准):

"① 我把一份 20 条工单数据接进来看了长什么样,然后让它生成了一份语料报告。 ② 因为不看数据就开始做,就会在假数据上做出好看但没用的东西——真实数据只有 20 条、还带 PII。 ③ 我觉得是 20 real + 395 synthetic 这行——它告诉我这份数据主要靠补, 所以能验证流程,不能证明效果。"

④ 随机点名复述(45–55 min)

  • 点后排、点没举手的(05 §2:抽人不抽"积极分子")。
  • 学员讲不清时,讲师不补答案,只问:

    "那你现在最想搞清楚的是哪一点?"(把"不会"转成"要查什么")

  • 讲得好的,当场给一句具体表扬(表扬要具体到动作,不要"讲得好"):

    "你刚才主动说了'2 处 PII 被脱敏'——这说明你看了输出,不是只看最后一行。"

⑤ 收口(55–60 min)

"现在对照 G1 自查——注意,G1 有一条不是硬拦的,但你必须自己知道。 下一节讲。"

投屏·板书

  • 常驻:三条命令清单 + 达标标志三条
  • 白板:卡住 > 3 分钟再举手(大字)
  • 互讲环节:3 句话模板

互动设计

问题 期望答案 冷场备选
"为什么要先看数据?" 不看就在假数据上做出好看没用的东西 "如果直接跳过 connect 会怎样?"
"报告里最重要的数字是哪个?" 无唯一答案,但必须说出理由 群里投票选 3 个候选数字
"你卡在哪?" 任何答案都接,转成"下一步查什么" 讲师先自曝"我当年卡在哪个命令"

常见错误与纠偏

错误 纠偏
学员跑在错误目录 "先 pwd 看一眼——必须在仓库根目录"
学员让 AI 代跑,自己没看输出 "AI 可以帮你,但你得能脱稿讲清关键决策——D8 会抽查"
学员只截图不跑(交截图充数) G1 是 blocker:报告文件必须真实存在(03 §2 G1)
有人提前跑完开始闲聊 让他去帮同桌(当小助教)——06 §8 结对互评的机制

承接语(最后 30 秒)

"最后 30 分钟:交作业、拿反馈、听明天的预告。"

学员笔记要点

  • 我今天亲手跑通了 connect → corpus,报告文件真实存在
  • 我能用 3 句话讲清:做了什么 / 为什么要先看数据 / 最重要的数字是哪个
  • 卡住 > 3 分钟就举手——省下的时间是你的

S7 · 门禁 G1 + 答疑(16:30–17:00 · 30 min)

本节定位:D1 的验收环节 + 明天预告。 重点不是"讲 G1 是什么",而是让学员当场自评、当场暴露差距。

一句话目标:"对照 G1 三条自查,把产出交出去;知道明天自己是什么角色。"

分钟级时间盒

分钟 动作 目的
0–8 逐条念 G1 检查项 + 学员当场自评打钩 暴露差距
8–16 提交规范(命名、渠道、截止、补交规则) 防止因格式被打回
16–24 答疑(先答"停车位"里记的问题) 兑现承诺
24–30 预告 D2:"明天你就是'进场第一天'" 埋钩子

讲稿要点

① G1 自查(0–8 min)

G1 冒烟门(03 §2 原文):

# 检查项 判定
① connect + corpus 命令跑通,报告文件真实存在 blocker
② 能用白话解释"我刚才做了什么"(口头或 3 行文字) blocker
③ 报告中的关键数字与实际运行一致 warning

讲法:"前两条是硬拦——做不到就进不了明天。第三条是软提醒—— 数字对不上不拦你,但会被记下来。为什么它只是 warning? 因为'数字看错'是新手最常见的错,我们不想第一天就把人拦死—— 但你自己得知道:数字对不上,等于没有证据。"

逐条让学员当场打钩,并念一遍提交要求:

提交内容(产出 1 · 迷你链路证据包):
1. reports/corpus_report.html(提交文件本身,或报告首页截图)
2. 3 行白话解释:做了什么 / 为什么要先看数据 / 最重要的数字是哪个
3. 控制台「星澜科技」红色 blocker 的截图

命名:D1-姓名-产出名(多文件加后缀)
截止:直播次日 21:30(运营催交时间);次日 08:30 出门禁通过榜

② 提交规范与补交(8–16 min)

项 规则
命名 D<N>-姓名-产出名(多文件加后缀:-截图1 / -数据)
渠道 群内指定提交入口(以当期公告为准)
截止 直播次日 21:30 前;次日 08:30 出通过榜
24h 内补交 正常放行(标注"补交通过")
超 24h 补交 记"延期通过":计入完课,作品集等级最高 B
豁免 数据涉密 / 岗位冲突等特殊情况,私聊讲师走豁免,记录在证书备注

补交申请格式(群里 @助教):

【补交申请】D3-李四-数据体检报告
原因:<一句话> | 预计提交时间:<明晚 20:00 前>
当前卡点:<一句话,方便助教提前准备>

讲师强调一句:"排不进去就别拖着——24 小时内补交完全正常, 拖过了才降级。报备比硬扛体面。"

③ 答疑(16–24 min)

  • 先答"停车位"里记下的问题(今天积累的跑题问题)——兑现 S0 的承诺。
  • 常见问题的标准答法(02 D1 常见问题表 + 05 §6):
学员问 回答要点
我不会 Python 能学吗? 能。今天所有命令可复制;Level 2 才碰代码。
没有 API key 能跑吗? 能。全链路有零 key 路径(规则模式),LLM 是可选加速器不是门槛。
我一直在用 Qoder / Trae / CodeBuddy,要换工具吗? 不用换。课程只叠"流程与门禁层",编码/办公工具继续用你顺手的。
学完能进大厂做 FDE 吗? 本课给能力与作品集,不承诺结果;D8 教你正确地把作品集用起来。
FDE 的历史和原理要背吗? 不背。今天 3 个新概念里没有它们。要用只有两个场合:D8 模拟面试、客户现场被追问——翻 00 §5 即可。引用数字必须连来源一起说,不确定的说"待核实"。

④ 预告 D2(24–30 min)

逐字稿(留一个悬念):

"今天你是'来上课的人'。 明天早上,你就是'进场第一天'。 客户会给你一句抱怨——就一句话,不给整理好的需求。 你要在 90 分钟里把它变成一份能签字的委托单。 今天下午你见过那份红色了:星澜科技为什么红? 明天第一件事就是讲它。

课后动作只有两个: ① 交产出 1(别忘了那张红色截图) ② 把今天画的地铁图拍照存好——D8 你要拿它跟自己的实际路径对照。"

投屏·板书

  • G1 三条 + blocker/warning 标注(红/黄)
  • 提交规范表 + 补交规则
  • 命名示例:D1-张三-迷你链路

互动设计

问题 期望答案 冷场备选
"G1 三条里,哪条是 warning?为什么?" ③;因为数字看错是新手最常见错,第一天不要拦死 直接公布答案,讲理由
"明天你是什么角色?" 进场第一天(面对一句抱怨的 FDE) "客户只给你一句话,你第一句问什么?"

常见错误与纠偏

错误 纠偏
学员只交截图、不交报告文件 G1 ①是 blocker:报告文件必须真实存在(06 §6 反例第一条)
有人问"能不能晚两天补" 讲清 24h 规则,并说"报备比硬扛体面"
答疑被少数人占满 讲师控时:每人一问,停车位里的问题优先
预告讲太细(把 D2 讲了一遍) 只留悬念与两个课后动作,细节让学员去读 06 D2 任务卡

承接语(全场最后 30 秒)

"今天就到这里。 你带走三件事:一句话(FDE 做 80%→99%)、一张图(4 条线 18 站)、一条能跑的链路。 明天见——带上你的地图,和那句你还没问出口的问题。"

学员笔记要点

  • G1 三条:① 命令跑通 + 报告存在(blocker)② 能白话解释(blocker)③ 数字一致(warning)
  • 提交命名 D1-姓名-产出名;截止次日 21:30;24h 内补交正常放行
  • 产出 1 三件:报告文件(或首页截图)+ 3 行白话解释 + 星澜科技红色 blocker 截图
  • 课后两个动作:交产出 1 · 存好地铁图照片

附 A · D1 板书总图(一天下来的白板应该长这样)

┌──────────────────────────────────────────────────────────────────┐
│  D1 红线:3 个新概念(交付链路/门禁/真实数据)· 故意翻车一次 · M1 只讲故事  │
├──────────────────────────────────────────────────────────────────┤
│  S1  世界观    售前=试驾员 · 实施=装车工 · 外包=代驾                  │
│                FDE = 随队工程师     →    【80% ➜ 99%】              │
├──────────────────────────────────────────────────────────────────┤
│  S2  地铁图    A 定边界(1-4) ─ B 造物(5-10) ─ C 稳运(11-15) ─ D 交离(16-18) │
│                门禁 = 检票闸机     【清单会烂,门禁不会】              │
│                4 反模式:Sponsor Collapse · Demo-Debt ·              │
│                          Data Quality Surprises · Scope Creep       │
├──────────────────────────────────────────────────────────────────┤
│  S3  三律      ① 先成功标准后代码(客户用什么数字验收?)              │
│                ② 真数据上原型(样板间 vs 毛坯房)                     │
│                ③ 一切产出可验证(同命令,同结果)     60% 停在试点      │
├──────────────────────────────────────────────────────────────────┤
│  S4 工具箱     connect(先看)→ corpus(淘米)→ 报告 → web            │
│                【我跳过了哪一站?】                                    │
├──────────────────────────────────────────────────────────────────┤
│  S5 控制台     茶语万象(绿) · 南湾汽车(三红) · 星澜科技(一红)           │
├──────────────────────────────────────────────────────────────────┤
│  S6 挑战       卡住 > 3 分钟再举手                                    │
├──────────────────────────────────────────────────────────────────┤
│  S7 G1         ① 报告存在 ② 能讲清 ③ 数字一致                        │
└──────────────────────────────────────────────────────────────────┘

附 B · 讲师自查(下课前 5 分钟)

  • ☐ 红线 1:今天有没有冒出第 4 个新概念?→ 停车位里的问题都记下来了吗
  • ☐ 红线 2:翻车演了吗?是"真跳过"还是"演示错误"?(后者无效)
  • ☐ 红线 3:M1 有没有展开 Ontology / 三道门槛 / 前线学习机制?(展开=犯规)
  • ☐ 两个硬性休息(10:15 / 14:30)守住了吗
  • ☐ 有没有每个学员都动手跑过至少一条命令(不是只看投屏)
  • ☐ 随机点名复述点到了后排/没举手的人吗
  • ☐ 市场数字引用时,来源与日期都说了吗
  • ☐ D2 的两件课后动作布置清楚了吗(交产出 1 + 存地铁图照片)

下一节:17-D2逐节教案.md(定边界:把模糊抱怨变成可交付的边界) 本日配套:02-逐日教学大纲.md Day 1(时间盒总表)· 06-学员手册与作业包.md D1 任务卡 · 07-实战剧本与案例库.md(案例 D 星澜科技)

17 · D2 逐节教案:定边界

17

course-level-1/17-D2逐节教案.md

本文件是 D2(90 分钟直播 + 45 分钟自练)的逐节执行稿:每节课讲什么、怎么说、屏幕放什么、学员做什么、卡住怎么救、下一节怎么接。 上游时间盒:02-逐日教学大纲.md Day 2|通用骨架与控场:05-讲师手册.md §2 / §4(D2 五条带教要点) 模板与术语:12-附录-术语表与模板库.md §1.1(角色词典)· §1.6(十二反模式)· §2.1(委托单模板) 演练素材:07-实战剧本与案例库.md §2.1(茶语万象)· §2.4(星澜科技)· §2.5(明源体检)· §3.1(D2 客户开场)· §4.1(CTO 角色卡)· §5(助教评分) 学员侧任务卡:06-学员手册与作业包.md D2|门禁条款:03-评估体系与通关门禁.md §3 G2 行 本日演示客户:茶语万象 / 星澜科技(Adnova)(全部虚构)|演示工作目录:/tmp/fde-d2-demo(不写进仓库)


0. 今天的三条红线(全天不许破)

# 红线 怎么守
1 全天只出现 3 个新概念:qualification · 干系人地图 · 成功标准 任何时刻冒出第 4 个术语 → 写进"停车位"(白板角落),课后答疑再讲
2 "这条标准,客户自己能验收吗?" 今天至少说 3 次(S2 一次、S3 巡场一次、S4 复盘一次) 每次学员念成功标准,讲师/助教只回这一句,不回别的
3 演示、案例、作业只用虚构客户 真实客户名与 PII 不进群、不上传、不进任何第三方工具(11 §6.1 三条红线)

今天没有硬性休息:D2 直播只有 90 分钟,中间不设休息点。 但 S3 上手 35 分钟是天然的"站起来"时间——学员要挪桌子分组,讲师可以趁这段时间补水。

为什么今天这么"窄":D1 装的是世界观,D2 装的是第一个闸机。 一天 90 分钟只教一件事——把一句抱怨变成一页纸的边界。宁可少讲一个案例,也要保证每个学员手里有一份自己的委托单。

今日 6 节课总览

节 时间 一句话目标 学员产出 记忆锚点
S1 回炉 0–10 min 抽考 D1 三概念 + 看一个"唯一发起人"的翻车 —— "他明天离职,项目还活着吗?"
S2 讲与演 10–35 min 看一句抱怨如何变成一页委托单,并亲眼看到闸机会拦人 观察笔记 "Zones A 的目标不是写方案,是定义 done"
S3 上手 35–70 min 亲手做完自己的委托单(含干系人地图 + 第二发起人) 🎯 产出 2 草稿 "第二发起人是谁?"
S4 复盘 70–80 min 看 1 优 1 劣,学会把形容词改成可度量 修订清单 形容词 → 数字 + 时间 + 测量集
S5 布置 80–90 min 收 G2 + 明日钩子 提交清单 "明天你会看到号称最干净的数据"
S6 自练 +45 min 独立完成、自评、提交 🎯 产出 2 提交 门禁自查 4 条

今日产出物(🎯 产出 2):客户委托单(≤1 页),7 节结构见 12 §2.1: ① 业务画像 ② 干系人地图 ③ 成功标准 ④ 时间盒 ⑤ 范围(✅做 / ❌不做 / 🔄变更规则)⑥ 放弃标准 ⑦ 已知风险。 通关门禁 G2 原文(03 §3): ① 成功标准 ≥3 条且全部可度量(有数字与时间,禁止"提升体验"类形容词)② 干系人含**≥2 位发起人** ③ 有"放弃标准" ④ 委托单 ≤1 页 —— ①② blocker;③④ warning(④ 超 2 页为 blocker)。


S1 · 回炉(0–10 min · 10 min)

本节定位:10 分钟干两件事——确认 D1 的三个概念没丢,再用一个"错误示范"制造今天的动机。不讲课,只提问。

一句话目标(开场念):"昨天你看到了整条链路,今天你要在链路的第一道闸机前,替客户把边界画出来。"

分钟级时间盒

分钟 动作 目的
0–2 一句话回顾 D1(80%→99%)+ 宣布今天产出物 建立连续性
2–5 抽考 D1 三概念(选择题,3 题 1 分钟) 低成本复现,不是考倒人
5–9 案例 D 星澜科技(07 §2.4):念客户原话 + 三级追问 制造今天的核心动机
9–10 命名反模式并收口:"今天第二个概念就是它的解药" 埋 S2 的钩子

讲稿要点

① 抽考怎么问(2–5 min)——用选择题,不用问答题

问答题会让没复习的人在 90 分钟的第一分钟就掉队。选择题让他"至少能蒙",蒙完听到正确答案,认知成本最低。

投屏 3 题,让全体在群里打字母,讲师 20 秒后揭晓:

# 题目 选项 答案
1 D1 说 FDE 做的是哪一段的活? A. 从 0 到 80% B. 从 80% 到 99% C. 从头做到尾 B
2 "门禁"和"作业清单"最大的区别? A. 门禁更严格 B. 门禁在你要通过的那一刻重新验证 C. 门禁是讲师定的 B
3 D1 那条迷你链路里,为什么要先跑 connect 再跑 corpus? A. 手册这么写的 B. 要先看真实数据长什么样 C. corpus 需要 connect 的输出 B

揭晓后的点评只有一句:

"三题全是 B——听起来像出题偷懒。不是。这三题是同一个答案的三个侧面: 你的活在下半场、你的证据要现场成立、你的判断要建立在真东西上。 今天这一整天,就是把这三句话用在一个人身上——那个给你提要求的人。"

② 案例 D 星澜科技(5–9 min)——逐字念 07 §2.4

"出海营销 AI 素材工厂。COO 一个人拍板,说'先把东西做出来,其他人我来协调'。 委托单很漂亮,成功标准也有数字。但干系人地图上,发起人只有 1 个。"

念完停 3 秒,然后走三级追问(07 §2.4 原题 + 两级递进):

级 追问 学员通常答 讲师动作
1 "这个项目有什么问题?" "只有一个发起人""其他人没参与" 不评价,点头,接着问
2 "如果这位 COO 下季度调岗,这个项目还活着吗?" (沉默——这是今天最值钱的 5 秒) 让沉默待满,不救场
3 "委托单很漂亮、成功标准也有数字——那问题出在哪?" "……出在没人第二个签字" 收口

第 3 问是关键:它把学员的注意力从"文档质量"搬到"结构风险"上。 多数新人相信"文档写好 = 项目稳";这一问当场推翻它。

⚠️ 讲师注意:别说成"这个 COO 不行"。要说成"这个结构不行"。 COO 可能是全场最支持这个项目的人——恰恰因为他一个人扛,他才最危险。

③ 命名 + 收口(9–10 min)

"这个反模式有名字,叫 Sponsor Collapse(发起人塌陷)——12 §1.6 十二反模式第 5 条。 它的解药,是今天三个概念里的第二个:干系人地图。 而这张图今天要逼出一样东西,叫第二发起人。一会儿你会知道为什么它是硬门槛。

投屏一行字,全天常驻:

Sponsor Collapse → 干系人地图必须 ≥2 位发起人

投屏·板书

  • 左:3 道选择题(揭晓前只显示题目)
  • 中:案例 D 客户原话(大字,只留 30 秒)
  • 右:常驻一行 Sponsor Collapse → 干系人地图必须 ≥2 位发起人
  • 白板角落:停车位(今天所有跑题问题记这里)

互动设计

问题 期望答案 冷场备选
"这位 COO 调岗了,项目还活着吗?" 任何回答都接住,重点是让沉默发生 改成人举手:"觉得还活着的举手"——通常 0 到 1 只手,比语言更有力
"你公司里有没有这种'一个人扛'的项目?" 不要求公开回答(涉及真实公司),改成群里匿名打 1(有)/ 0(没有) 讲师自曝一个脱敏版本

常见错误与纠偏

错误 纠偏
抽考变成点名批评 全程群内打字母,不点名;答错的人不会暴露
学员开始讨论"这个 COO 是不是傻" 立刻拉回:"COO 是好人,结构是坏结构——我们今天要学的就是怎么救它"
讲师在案例 D 上讲解超过 5 分钟 硬性:9 分钟必须收口。案例 D 是钩子,不是教学内容(D2 的"讲"在 S2)
有人问"星澜科技的档案在哪看" "控制台里能看——它真实存在,success_criteria gate 是红的"(07 §2.4),不展开

承接语(最后 30 秒)

"看到了坏结构,接下来看好结构长什么样。25 分钟,我用一个虚构客户,把一句抱怨拆成一页纸。"

学员笔记要点

  • D1 三概念回顾:FDE 做 80%→99% · 门禁是现场重新验证 · 判断建立在真东西上
  • 反模式 Sponsor Collapse:唯一发起人离职即死 → 解药是干系人地图 + 第二发起人
  • 今天的产出物:客户委托单(≤1 页),门禁 G2

S2 · 讲与演(10–35 min · 25 min)

本节定位:全场唯一的"演示"段。目标不是讲清方法论,是让学员亲眼看到闸机会拦人。 本节产出的不是知识,是"证据长什么样"的样板。

一句话目标:"25 分钟后,你能说出委托单的 7 个格子分别填什么,并知道你填错时哪一行会变红。"

分钟级时间盒

分钟 动作 目的
0–3 念客户原话,把它拆成 3 个问题 从"感受"到"结构"
3–8 投屏 12 §2.1 的 7 节模板 + 时间盒四数字 给出骨架
8–20 现场演示:立项 → 看闸机 → 撞门 → 硬推被拦 本节核心,不可省
20–23 形容词改造示范(1 分钟 1 个,改 3 个) 示范胜过讲十遍(05 §4 D2-3)
23–25 收口:两套门禁一个标准 + 承接 S3 过渡

讲稿要点

① 把抱怨拆成 3 个问题(0–3 min)——逐字念 07 §2.1

投屏客户原话(先不投屏任何模板,只投这段大白话):

"全国 2800 家门店,每周订货全凭店长拍脑袋——订多了报废,订少了断货。 我们买了数据平台,但没人知道怎么让它'会订货'。"

念完问全场:"这段话里,客户提了几个要求?"(学员会说"一个""两个")

"他说了 0 个要求。他说的是一个现象。 委托单的全部工作,就是把这个现象翻译成三个问题的答案——"

投屏三行(这一整天反复回来看的骨架):

① 谁说了算?        → 干系人地图
② 值不值得做?      → qualification
③ 什么算 done?     → 成功标准

"注意第三问的措辞:不是"要做什么",是"什么算 done"。 这是 05 §4 里对 D2 最重要的一条提醒:Zones A 的目标不是写方案,是定义 done。 方案是 D4–D5 的事。今天你要是开始写技术方案了,你跑错站了。"

② 给出骨架(3–8 min)——投屏 12 §2.1 的 7 节

不逐字讲模板(学员课后自己看),只讲每格填错会怎样:

节 填什么 填错的后果
1 业务画像 行业 · 规模 · 谁付钱 · 现在怎么干活 · 痛在哪 后面所有判断失去依据
2 干系人地图 执行发起人 · 第二发起人 · 一线使用者 · IT/安全把关人 Sponsor Collapse(G2 blocker)
3 成功标准 ≥3 条,全部可度量 Infinite Pilots(G2 blocker)
4 时间盒 ≤14d 集成 / ≤90d 上线 / ≤120d 交接 / 每周同步 项目变成没底洞
5 范围 ✅做 / ❌不做 / 🔄变更规则 Scope Creep
6 放弃标准 什么情况下我们应该说"这个不该做" 沉没成本滚雪球(G2 warning)
7 已知风险 风险 · 影响 · 缓解 · 责任人 出事时无人可找

只强调两格:第 2 格和第 3 格。理由:

"7 个格子里,只有 2 个是硬拦(blocker),其余是提醒。 硬拦的只有这两格——因为它们是唯一两个"你写错了、别人替你兜不住"的地方。"

时间盒四个数字要念出来(12 §2.1 / 02 Day 2):

≤14 天  完成数据接入          ← 集成
≤90 天  上线                  ← 出价值
≤120 天 完成交接              ← 你得走得掉
每周   一次同步               ← 别让人失联

"这四个数字不是我编的(引用自行业 FDE 实践)。它们的用途不是承诺,是触发复盘: 到第 15 天数据还没接完,不是'再等等',是该开会了。"

③ 现场演示(8–20 min)——本节核心,一条命令都不能省

演示前把终端字号调到最大,并先声明工作目录:

# 本演示全部写入 /tmp,不污染课程仓库(学员自己练时用默认目录即可)
export FDE_SCOPE_HOME=/tmp/fde-d2-demo
mkdir -p /tmp/fde-d2-demo

讲师旁白:"我特意把它指到临时目录——演示可以乱、仓库不能乱。这也是个习惯。"

第 1 步 · 立项(约 30 秒)

fde-scope engage init --customer "茶语万象" --profile ticket

真实输出(照抄,不要美化):

FDE Scope v0.1.0 — engage init · ticket

✅ Engagement eng-茶语万象-ticket created (profile=ticket)
   phase: qualification · zone: pre_engagement
   visible phases: 15

三处要点,逐句讲:

  1. --profile ticket → 这就是**qualification(值不值得做)**的第一个判断:这条链路用哪套。 "同一件事,工厂和互联网公司的交付链路不一样。选错 profile,后面每一站都白走。"
  2. phase: qualification · zone: pre_engagement → 你现在站在地图的第一站。
  3. visible phases: 15 → "看到 15 了吗?02 说 ticket 走 15 个阶段、manufacturing 走 18 个。 差的那 3 个全是工业专属阶段——现场勘察、部署上线、变更管理培训。工业现场这三站躲不掉,互联网项目多数用不上。"

第 2 步 · 看一眼闸机清单(约 1 分钟)

fde-scope gate list

真实输出(10 行,第 3 列 🏭=工业专属 / 🏢=通用):

FDE Scope v0.1.0 — gates · manufacturing

┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┓
┃ slug              ┃ name                                                  ┃ industrial_only ┃
┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━┩
│ site_survey       │ Site Survey / Gemba Walk                              │ 🏭              │
│ success_criteria  │ Success Criteria & Dual Sponsor                       │ 🏢              │
│ fat_sat           │ FAT / SAT Acceptance                                  │ 🏭              │
│ functional_safety │ Functional Safety (ISO 13849 / IEC 61508 / ISO 10218) │ 🏭              │
│ conformity        │ CE / EU AI Act Conformity                             │ 🏭              │
│ works_council     │ Works Council / Labor Co-determination                │ 🏭              │
│ air_gap           │ Air-Gapped Deployment Readiness                       │ 🏭              │
│ shift_handover    │ Shift Handover Integration                            │ 🏭              │
│ slo               │ SLO / SLA + On-call                                   │ 🏢              │
│ handoff_signoff   │ Handoff Sign-off                                      │ 🏢              │
└───────────────────┴───────────────────────────────────────────────────────┴─────────────────┘

必须讲清的三件事(学员最容易在这里踩坑):

  1. 这 10 个不是本课程的门禁 G0–G8。 它们是工具门禁,管的是 SOP 链路某个阶段能不能推进。 "两套门禁,一个标准,别搞混——03 §1.1 专门写了这件事。"
  2. 🏢 通用的只有 3 个:success_criteria · slo · handoff_signoff。 "今天我们要过的是第一个。"
  3. ⚠️ 不要演示 gate check <id> --gate site_survey。ticket 档案上它会印 ✅ PASS—— 那是"这个门在 ticket 档案下没有可检查的数据"的空过,不是通过了工业门(03 §1.1 专门警告过)。 "拿这个空 ✅ 去充作品集,助教一眼看穿。"

第 3 步 · 现在去撞门(10–14 min)——今天最重要的一条命令

fde-scope gate check eng-茶语万象-ticket --gate success_criteria

真实输出(退出码 = 1,这行字本身就是证据):

❌ BLOCKED · gate=success_criteria
  🚫 成功标准未定义——无法判定 done(无限 pilot 反模式)
  🚫 仅有 0 个 sponsor——要求 ≥2(防 Sponsor Collapse)
  ⚠️  sponsor 未填写可度量的 success_metric
💡 已把这次阻塞沉淀为草稿 skill-1d607e0f — fde-scope skill review 可查看并完善

逐行讲解——这一段浓缩了今天全部三个概念:

行 讲什么
🚫 成功标准未定义——无法判定 done 今天第 3 个概念。没有 done,项目就没有终点 = Infinite Pilots
🚫 仅有 0 个 sponsor——要求 ≥2 今天第 2 个概念。Sponsor Collapse——和刚才星澜科技一模一样的病
⚠️ sponsor 未填写可度量的 success_metric 同样是"没标准",但严重度降级:这是提醒,不是硬拦
💡 已把这次阻塞沉淀为草稿 skill-1d607e0f 飞轮第一次出现

关于最后一行,逐字稿:

"这行字长得像 bug,其实是这门课最有意思的设计之一: 你撞墙的这一刻,系统把你的错误变成了资产。 它记了一张"待审技能卡草稿"——fde-scope skill review 可以看,fde-scope skill archive <id> 可以清。 这就是 D1 说的"把现场经验回流成产品能力"的最小形态。 注意:它不替你把门打开,它只是记下来。 挡你还是挡你。"

关于 🚫 和 ⚠️ 的符号语义——顺手指一下投屏的 03 §3:

"🚫 = blocker = 硬拦,不补齐不放行;⚠️ = warning = 可放行但记入档案,在作品集评分里扣分。 这套语义课程门禁 G0–G8 和工具门禁完全同构——03 §3 的表里原话就是这两行。"

第 4 步 · 硬推一次,看它会不会真拦(14–18 min)

很多人以为 gate check 只是个"报告工具"。下一演示要推翻这个想法。

fde-scope engage advance eng-茶语万象-ticket   # 第 1 次
fde-scope engage advance eng-茶语万象-ticket   # 第 2 次
fde-scope engage advance eng-茶语万象-ticket   # 第 3 次

真实输出:

✅ Advanced → stakeholder_map (干系人地图与对齐) · zone=pre_engagement
✅ Advanced → success_criteria (成功标准契约化) · zone=pre_engagement
❌ ADVANCE BLOCKED — phase=success_criteria
❌ BLOCKED · gate=success_criteria
  🚫 成功标准未定义——无法判定 done(无限 pilot 反模式)
  🚫 仅有 0 个 sponsor——要求 ≥2(防 Sponsor Collapse)
  ⚠️  sponsor 未填写可度量的 success_metric
💡 已把这次阻塞沉淀为草稿 skill-3fffbaa7 — fde-scope skill review 可查看并完善

这里有个反直觉的地方,必须停下来讲:

"注意——前两步不但没被拦,还放行了。 因为 qualification 和 stakeholder_map 这两个阶段本身没有挂门禁, 它们靠的是检查表加你自己的诚实。整条链路里,只有 success_criteria 挂了闸机。

这不代表前两站不重要。恰恰相反: 闸机只装在最重要、也最容易被糊弄的那一站。 前两站糊弄了,你自己心里知道;成功标准糊弄了,三个月后客户和你才知道——那时候代价最大。"

再补一刀:

"还有一层:门禁是"推进那一刻"算的,不是"提交那一刻"算的。 今天它拦住我,因为我现在没有标准。 明天我补上了,它让我过——但每次推进它都会重算。 所以没有"我上周通过了"这回事(AGENTS.md 第 1 条不变量):

一个过期通过记录,不等于一次真通过。

第 5 步 · 那怎么才能变绿?(18–20 min)——诚实回答

学员一定会问:"那我填什么它才让我过?"——如实回答,不要编:

"说实话:fde-scope 目前没有 engage set-sponsor 这类"录入"命令。 工具的定位是验收,不是录入——它在你推进的那一刻,去读那份 engagement 档案并重新判定。

所以在真实项目里,闭环是这样的:"

投屏:

你写委托单(Markdown,交课程门禁 G2)
        ↓   结构化进 engagement 档案 JSON(团队真实项目里)
fde-scope gate check / advance(工具门禁现场验收)

"两套门禁,一个标准。 标准是什么,今天就要定下来——而且标准不长在工具里,长在你和客户之间。"

④ 形容词改造示范(20–23 min)——示范一次胜过讲十遍

投屏左列,现场改右列(真的当场打出来,不要预先做好):

❌ 形容词版 ✅ 可度量版
提升客服效率 客服中心人工工单从 1.2 万件/周降到 ≤8400 件/周,90 天内,按周报口径统计
提升用户体验 会话平均处理时长从 4.2 min 降到 ≤3.0 min,同一批 200 条测试集上测
提高数据质量 关键字段缺失率从 12% 降到 ≤2%,接入后第 30 天复核
让 AI 更聪明 在 200 条客户测试集上准确率从 61% 到 ≥85%,bad case 逐条有记录
提升运营效率 ???

最后一行是本节课的"钉子",停下来讲:

"前面四条我都能改。第五条改不了——不是因为不精确,是因为没人知道"运营"指什么。 这就是形容词标准的真正问题:它不是写得模糊,是它根本还没想清楚问题是什么。

所以下次你要写"提升效率"的时候,别急着找数字——先回去问客户:你说的效率,是谁的哪个动作快了? 问不出来,说明这一条还不该进委托单。"

改造三件套(投屏,全天常驻):

① 谁的数字(主体是客户,不是你的模型)
② 从多少到多少(基线 → 目标)
③ 什么时候、拿哪批数据测(时间 + 测量集)

⑤ 收口(23–25 min)

"今天你看到的这一页纸,是整条链路里唯一一份"不进代码"的产出—— 它不跑、不部署、不上线,但它决定了后面 17 站值不值得走。 现在轮到你了。"

投屏·板书

  • 左:客户原话(只留 3 分钟)
  • 中:三个问题(谁说了算 / 值不值得做 / 什么算 done)——全天常驻
  • 右:改造三件套(主体 / 基线→目标 / 时间+测量集)——全天常驻
  • 底部:Sponsor Collapse → 干系人地图必须 ≥2 位发起人
  • 白板角落:停车位

演示脚本(可直接复制执行)

# 演示前:终端字号最大;本演示全部写入 /tmp,不污染仓库
export FDE_SCOPE_HOME=/tmp/fde-d2-demo
mkdir -p /tmp/fde-d2-demo

# ① 立项
fde-scope engage init --customer "茶语万象" --profile ticket
#   → ✅ eng-茶语万象-ticket created (profile=ticket) / visible phases: 15

# ② 看闸机清单(讲:10 个里通用只有 3 个;不要演示 site_survey 的空 PASS)
fde-scope gate list

# ③ 撞门(今天最重要的一条命令)
fde-scope gate check eng-茶语万象-ticket --gate success_criteria
#   → ❌ BLOCKED:2 条 🚫 + 1 条 ⚠️ + 一行 💡 技能卡草稿

# ④ 硬推三次(前两次放行、第三次被拦——讲"闸机只装在最重要那一站")
fde-scope engage advance eng-茶语万象-ticket
fde-scope engage advance eng-茶语万象-ticket
fde-scope engage advance eng-茶语万象-ticket
#   → ✅ → ✅ → ❌ ADVANCE BLOCKED — phase=success_criteria

演示事故预案:

状况 现场处理
命令敲错 / 拼写错 不要重敲,先念一遍错误信息——"看,工具会告诉你哪里错了。这是它比人强的地方"
上一次演示的档案还在,init 报已存在 现场讲 id 公式:eng-{客户名小写去空格}-{profile} → 换名字或加后缀演示
学员问"我能改成 manufacturing 看 18 阶段吗" 好问题,让他在自练时段自己试(S6 路径 C),不要占用直播时间
学员问"绿了以后长什么样" 投屏 engage status eng-teaverse-ticket-seed01(满分参考档案:complete=True、三个门禁全 ✅),一句话带过——"今天先知道它长这样,细节 D7 讲"

互动设计

问题 期望答案 冷场备选
"这段话里客户提了几个要求?" "0 个,是现象不是要求" 直接给答案:"我先告诉你们——0 个。这就是为什么需要委托单"
"第 5 条'提升运营效率',谁能给它加数字?" 通常没人能——这正是要的效果 讲师自己试一次并失败:"我也改不了。因为它没有主体"
"🚫 和 ⚠️ 有什么区别?" 硬拦 / 记录并扣分 类比:"🚫 是考场作弊取消成绩,⚠️ 是扣分后放行"
"门禁会不会太死板,卡住好项目?" 好问题——诚实回答:"所以有 warning 一档,也有补交留痕机制(03 §1)" "你觉得哪一条现在卡你?"——收集真实摩擦点,课后答疑

学员动作(现场)

  • 群里打选择题字母(3 题)
  • 记录投屏的两组常驻内容:三个问题 + 改造三件套
  • 抄下"🚫/⚠️"两个符号的语义
  • 跟着敲一遍第 3 步(撞门那条)——愿意跟的在群里贴自己的输出截图(只贴虚构客户)

常见错误与纠偏

错误 纠偏
讲师开始讲"engagement JSON 结构长什么样" 立即收:这是第 4 个概念 → 停车位。今天不展开
演示到一半开始 debug 真实报错 报错也是教学内容——但限时 60 秒;超时就说"这条我课后单独发群里"
讲解成功的学员问"我能不能直接看 seed 档案抄标准" 回应 07 §2.1 演示要点原文:"这是别人家的满分作业——但你要做的不是抄,是知道每一站的证据长什么样"
有学员指出"演示用了 /tmp,和我环境不一样" 正面肯定,并说明:默认目录是 ~/Documents/FDE Scope,FDE_SCOPE_HOME 可以改——改目录这件事今天不考,别在这多说
25 分钟被讲超(演示最容易超) 硬性:到 25 分钟立刻切 S3。宁可少演示一步"advance 第三次",也不能挤掉学员动手时间

承接语(最后 30 秒)

"现在我演完了。接下来 35 分钟,你演。 你和隔壁桌,会被给到一段故意没整理过的客户抱怨——和我刚才念的那段一样糙。 你的任务:把它变成一页纸。"

学员笔记要点

  • Zones A 的目标不是写方案,是定义 done(05 §4 D2-4)
  • 抱怨 → 三问:谁说了算(干系人地图)· 值不值得做(qualification)· 什么算 done(成功标准)
  • 委托单 7 节,只有 2 节是 blocker:干系人地图(≥2 位发起人)· 成功标准(≥3 条全可度量)
  • 时间盒四数字:≤14d 集成 · ≤90d 上线 · ≤120d 交接 · 每周同步
  • 可度量三件套:主体是客户 · 基线→目标 · 时间 + 测量集
  • 两套门禁,一个标准(03 §1.1);过期通过 ≠ 真通过
  • 🚫 = 硬拦,⚠️ = 记录并扣分

S3 · 上手(35–70 min · 35 min)

本节定位:全场唯一"必须产出"的一段。学员 35 分钟内做出自己的第一版委托单,并被助教当场压力测试。 助教必须在场——这一段的教学效果,一半来自角色扮演。

一句话目标:"35 分钟后,你手里有一份能拿去给客户看的委托单草稿——不是完美的,是能用的。"

分组建档(讲师,1 分钟)

按 07 §1 固定分组,从 D2 一直用到 D7(D8 交叉提问):

组 案例 类型 训练重点
A 组 案例 B · 迅捷出行 ticket(网约车) 冲突干系人 · 含 PII 数据
B 组 案例 C · 南湾汽车 manufacturing(整车厂) 工业叠加层 · 门禁真实拦截

讲师逐字念:"从现在到 D7,你一直用这个案例。D8 答辩时,你要回答对方那个案例的问题—— 因为客户现场就是这样:你用的不是你的案例,但仍要听懂对方讲什么。"

为什么两组案例不同:A 组练"人的冲突"(要快 vs 要稳),B 组练"工业现实"(PLC 不许碰)。 两种病都得见过。

分钟级时间盒(学员视角)

分钟 学员做什么 助教做什么
0–1 分组建档,读规则 念规则 + 声明红线
1–6 读客户简报(原始形态,故意不整理) 巡场,只回答"简报里有没有"类问题
6–10 独立写"我认为的 3 条成功标准"(不许讨论) 强制安静,看到讨论就制止
10–12 组内对标准,找出分歧 记录分歧点(这是 S4 的弹药)
12–25 补完干系人地图 + 范围 + 放弃标准 + 风险 逼第二发起人(见下)
25–33 助教扮演客户 CTO 压力测试(每桌 2–3 分钟) 按 07 §3.1 + §4.1
33–35 每组自评 G2 四条 收自评结果,挑 S4 的素材

讲稿要点

① 念规则(0–1 min)——三条,不多

"三件事: ① 先各自写,再讨论——因为客户不会给你时间开会,你第一次听到的抱怨往往是碎片; ② 只用手头的简报,不许上网查这家公司、不许用真实客户名; ③ 35 分钟必须有一版——不完美可以,空白不行。"

② 关于"独立写 4 分钟"(6–10 min)——这是本节的隐藏考点

讲师在开始时说明理由,之后闭嘴:

"接下来 4 分钟,谁也不许说话。写下你认为的三条成功标准。 写得难看的、写得犹豫的,都留着——那是你真实的判断力快照。 一会儿组内一对,你会发现:同一段简报,三个人读出了三种"成功"。 这个分歧不是你们不专业,是客户简报本身就是这个德性——它就是个没整理的抱怨。"

③ 逼第二发起人(12–25 min)——助教的核心动作

这是 05 §4 D2-2 的原文要求,助教必须执行:

"干系人地图必须逼出'第二发起人',没有就让他写'死亡风险'三个字在图上。"

操作细节(助教照着做):

情形 助教的话
图上只有 1 个发起人 "第二个人呢?" → 学员说"简报里没有" → "那就写上「死亡风险:唯一发起人」五个字,就写在图上"
学员说"数据总监应该也算吧" "算不算你说了不算,客户说了算。 你现在要做的是:写下他的名字,然后在备注里写"待确认支持度""
学员说"我不知道第二发起人是谁" "好——那你的下一次会议议程就有了:第一个问题就是问这个"

⚠️ 助教红线:不要替学员想答案。 学员说"没有",就让他把"没有"写下来—— 一张标着"死亡风险"的干系人地图,比一张编出来的四人图有价值得多。

④ 两组各自的关键摩擦(讲师巡场时按组提问)

组 案例里埋的雷 讲师/助教该问的问题
A 组(迅捷出行) 罗成要快 vs 邓琳要稳;钱锋怕背锅;孙丽关心司机侧 "这四个人四个 KPI,你的成功标准写谁的?"(→ Scope Creep 预警)
B 组(南湾汽车) 车间主任说"PLC 谁都不许碰";安全部门未签字;"我们厂没有工会" "谁能在焊装线上给你开停机窗口?"——这个人不在简报里,他必须被写进干系人地图

B 组的"我们厂没有工会"是故意写的陷阱:学员会以为"没有工会 = 没有劳工风险"。 助教追问:"那 works_council 这个门禁在你们厂由谁满足?" —— 正确答案不是"不用管",是"把它写进风险清单,责任人待定"(07 §2.3)。

⑤ 助教扮演客户 CTO 压力测试(25–33 min)

台词骨架(07 §3.1 原文,可直接打印给助教):

(学员:自我介绍 + 想了解"痛点")
客户 CTO:别问了,我时间有限。我就一句话——AI 客服,三个月,能上就上。
          (学员若直接问数据)
客户 CTO:数据的事你找数据部,我只要结果。
          (学员若坚持问成功标准)
客户 CTO:那你说,你觉得这个"成功"应该怎么定?给我个数字。

暗号(07 §4.1):

学员问出"谁和您一起为这个结果负责"时,你可以提"VP 和我也在盯"(给出第二发起人线索)。

观察点(07 §3.1):

  • 学员是否顶住"直接要结果"的压力,把对话拉回成功标准与干系人;
  • 是否识别出"客户只有一位出面人"(→ 追问第二发起人)。

⚠️ 本节节奏警戒:35 分钟做一页纸是紧的。若助教人手不足(每桌压不到 2 分钟), 优先砍压力测试,不要砍独立写 4 分钟——那个环节的认知冲击最强,且不可事后补。

⑥ 自评 G2(33–35 min)——四条打钩

投屏,学员自查(先自评,讲师不替他们评):

G2 自查([03] §3)
✅ ① 成功标准 ≥3 条,且每一条都有数字与时间        ← blocker
✅ ② 干系人含 ≥2 位发起人(没有 → 写"死亡风险")   ← blocker
✅ ③ 有"放弃标准"(什么情况下该说"这个不该做")    ← warning
✅ ④ 委托单 ≤1 页(超 2 页 = blocker)              ← warning

投屏·板书

  • 左:分组表(A 组案例 B / B 组案例 C,用到 D7)
  • 中:35 分钟时间盒表(学员视角)
  • 右:G2 自查四条(打钩区)
  • 白板角落:停车位

互动设计

问题 期望答案 冷场备选
(独立写环节)"写完的举手" 不需要回答,这一环节刻意不说话 ——
"你们组的分歧在哪一条?" 通常是"拦截率 60% 算不算成功" "先别争对错——把它记下来,一会儿我告诉你为什么分歧本身就是产出"
"第二发起人找不到怎么办?" 写"死亡风险"到图上 直接念 05 §4 D2-2 原文,让规则替讲师说话

学员动作(现场)

  1. 读客户简报(5 分钟,只看简报)
  2. 独立写 3 条成功标准(4 分钟,不许讨论)
  3. 组内对齐,找出分歧(2 分钟)
  4. 补完委托单其余各节(13 分钟)
  5. 接受助教扮演的客户 CTO 压力测试(2–3 分钟/桌)
  6. 自评 G2 四条(2 分钟)

常见错误与纠偏

错误 纠偏
学员偷偷联网查"迅捷出行是哪家公司" 当场制止:编造真实背景会污染练习,且触碰"真实客户名"红线
小组一上来就开会讨论,跳过独立写 助教站到桌边计时:"还有 3 分钟独立时间"——用时间压力代替批评
成功标准全部写成技术指标(F1 / MAE / 延迟) 用 05 §4 D2-1 的原问题反问:"你的成功标准,客户能自己验收吗?"
干系人地图只有 4 个名字没有"在乎什么" "名字是最不值钱的一列,'在乎什么'才是——没有它,这张图不能用于决策"
学员卡在"放弃标准"不知道写什么 给一个模板句:"如果 <某个前置条件> 在 <某个时点> 之前不成立,我们建议暂停并重新评估"
有组 20 分钟就写完开始闲聊 加码:让他们把成功标准念给隔壁组听,隔壁组负责找"客户能不能验收"的漏洞

承接语(最后 30 秒)

"停笔。现在先别改——我要让你看看两份真实的作业,一份好的,一份……有代表性的。 看完你再改,会改得更狠。"

学员笔记要点

  • 分组:A 组案例 B(迅捷出行)· B 组案例 C(南湾汽车),用到 D7,D8 交叉提问
  • 先独立写,再讨论——客户不给开会时间
  • 第二发起人找不到 → 写"死亡风险"到图上(不是编一个名字)
  • "在乎什么"是干系人地图里最值钱的一列
  • 放弃标准模板句:"如果 <前置条件> 在 <时点> 之前不成立,我们建议暂停并重新评估"

S4 · 复盘(70–80 min · 10 min)

本节定位:10 分钟,用 1 优 1 劣把 S3 的产出拉到标准线上。 重点是"成功标准写成形容词"这个最高频错误(02 Day 2 复盘行原文)。

一句话目标:"下课时你能一眼看出:哪条标准客户能验收,哪条不能。"

分钟级时间盒

分钟 动作 目的
0–3 1 优:念案例 A 茶语万象的参考成功标准,逐条拆解 给出"好"的具体形态
3–6 1 劣:展示"形容词标准"的三种变体(不点名) 让多数人对号入座
6–8 三种失败模式速讲 建立检查清单
8–9 埋案例 E 钩子 给"放弃标准"这一条加重量
9–10 修订指令 + 承接 S5 立刻行动

讲稿要点

① 1 优 · 案例 A 茶语万象的参考成功标准(0–3 min)

投屏(07 §2.1 档案版原文):

≤14d  完成数据接入(瞬时 10w+ TPS)
≤90d  AI 订货预测上线,覆盖 90% 门店
      MAE 较基线下降 ≥20%
≤120d 完成运维移交,SLO 99.5%

逐条拆结构(不是内容):

条 数字 时间 被测对象 谁来验收
数据接入 10w+ TPS ≤14d 接入链路 数据平台负责人(赵磊)
订货预测 覆盖 90% 门店 ≤90d 上线范围 数字化中心(王芳)
预测质量 MAE ↓≥20% (同一窗口) 模型效果 供应链总监(林晓)
运维移交 SLO 99.5% ≤120d 可运维性 运维接手人

"看这张表最后一列——每一条都指得出来一个人。 这就是可度量的第二个意思:不是数字够多,是每一条都能找到那个会说"我确认"的人。"

② 1 劣 · "形容词标准"的三种变体(3–6 min)

⚠️ 纪律:绝对不点名、不投屏真实学员作业。 用 06 的 G2 典型错误表 + 常见变体。

变体 例子 病在哪
A · 纯形容词 "提升运营效率""赋能一线""提升体验" 没定义问题——最严重
B · 只有工程师能测 "F1 ≥ 0.85""RMS 误差 < 0.3""P99 延迟 < 200ms" 验收主体错了——见下
C · 只有方向没有量 "大幅下降""显著提升""明显改善" 有主体,没数字——改造成本最低

B 变体必须单独停下来讲(这是最反直觉的一类,学员普遍觉得"我这条很专业"):

"F1 ≥ 0.85 是好标准吗?它精确、有数字、可复现。 但它是一件工程师能做、客户不能验收的标准。

你的客户不会在验收会上说'我确认一下 F1'。 客户能验收的是**'人工工单少交了 30%'——数字可以是你算的, 但判断"少了没有"的人必须是他**。"

这就是 05 §4 D2-1 说的"验收主体搞错是最高频错误",在这里落地。

③ 三种失败模式速讲(6–8 min)

给学员一张可以贴在电脑上的检查清单:

① 形容词标准        → 回去问:你说的 X,是谁的哪个动作变好了?
② 只有工程师能验收  → 换成客户的业务量:工单数 / 时长 / 覆盖率 / 缺陷数
③ 没有放弃标准      → 写一句:"如果 <条件> 在 <时点> 前不成立,我们建议暂停"

顺带回答 S3 里记下的"分歧":

"刚才你们组内争的'拦截率 60% 算不算成功'——分歧本身是产出。 它说明你们已经读出了这个项目最难的那部分:两个人对"成功"的定义不一样。 委托单的用途之一,就是把这个分歧写下来,让客户自己看见。"

④ 埋案例 E 钩子(8–9 min)

"今天你写了'放弃标准'——可能很多人是硬凑的。 因为你觉得:都做到这一步了,怎么可能不做?

这门课里有一个案例,正确答案是走人。 客户氛围很好、已经谈了两轮、你也投入了很多—— 但三条致命信号出现之后,专业的人会说"不"。 D7 我们讲它。今天你只要记住一句话:"

投屏大字:

会做的人是供应商,会说不的人才是顾问。(07 §2.5 讲师收尾金句)

⑤ 修订指令(9–10 min)

"现在给你 60 秒:打开你刚才那份委托单,只做一件事—— 把每一条成功标准读一遍,问自己一句'客户自己能验收吗'。 读不过去的,画个圈。圈出来的,才是你今晚要改的。 别改别的。"

投屏·板书

  • 左:案例 A 参考成功标准(4 行)
  • 中:三种失败模式(A 纯形容词 / B 工程师标准 / C 没数字)
  • 右:金句 会做的人是供应商,会说不的人才是顾问
  • 白板角落:停车位

互动设计

问题 期望答案 冷场备选
"F1 ≥ 0.85 有没有问题?" 有:客户不能验收 改成举手:"觉得这条没问题的举手"——一般小半数,然后逐层拆
"你们组的分歧点,现在能写成一条标准吗?" 不要求现场答,留给自练 "写不出来不要紧,写出来"这条待客户确认"就是合格产出"
"放弃标准你们凑了几条?" 坦诚承认硬凑也没关系 立刻接案例 E 钩子

学员动作(现场)

  1. 对照案例 A 的四条,检查自己是否"每条都指得出来一个人"
  2. 把三种失败模式抄进笔记
  3. 60 秒圈的圈——只圈不改(改在 S6)

常见错误与纠偏

错误 纠偏
学员要求"看看别人组怎么写的" "D8 交叉提问时你会看到。今天先把自己的看清"
有人被"1 劣"对号入座而不快 讲师先自我暴露:"我第一份委托单写的也是'提升效率'——05 §5 说,这门课允许犯错,但不允许糊弄"
有人问"那 B 变体就一定不好吗?" 好问题,正面回答:"它该出现在技术方案里,不该出现在验收标准里——你可以在旁注里保留它,但主标准必须是客户的"
复盘被讲师讲成 15 分钟 硬性:10 分钟必须进 S5。宁可少讲一个变体,也要留时间给"布置"

承接语(最后 30 秒)

"好——圈也圈了。现在花 10 分钟,我把今晚要做的事交给你,然后你去自练。"

学员笔记要点

  • 可度量的第二个含义:每一条标准都指出一个会说"我确认"的人
  • 三种失败模式:纯形容词 / 只有工程师能验收 / 只有方向没有量
  • F1 ≥ 0.85 该进技术方案,不该进验收标准
  • 组内分歧本身就是产出——写下来让客户看见
  • 金句:会做的人是供应商,会说不的人才是顾问

S5 · 布置 G2 + 明日预告(80–90 min · 10 min)

本节定位:把今天的产出变成可提交的作业,并让明天的课"有悬念"。 这一节不讲新东西,只做三件事:念门禁、说清怎么交、埋钩子。

一句话目标:"下课后你不需要问任何人——你知道交什么、交到哪、什么时候交、按什么标准判。"

分钟级时间盒

分钟 动作 目的
0–3 逐条念 G2(03 §3 原文 + 判定语义) 判定标准零歧义
3–6 命名规范 + 截止时间 + 提交方式 消除流程问题
6–8 三条自检 + 两条高频坑 提前拦截典型错误
8–10 明日钩子 + 一句收尾 建立悬念

讲稿要点

① 念 G2(0–3 min)——原文照念,不要翻译

投屏 03 §3 的 G2 行:

G2 边界门(挂 D2)
① 成功标准 ≥3 条且全部可度量(有数字与时间,禁止"提升体验"类形容词)
② 干系人含 ≥2 位发起人
③ 有"放弃标准"
④ 委托单 ≤1 页
判定:①② blocker;③④ warning(④ 超 2 页为 blocker)

念完补三句:

"第一句:①②是硬拦——差一条,G2 不过。 第二句:③④是提醒——过了也会记档,在作品集评分里扣分。 第三句:超 2 页也是硬拦。 一页纸不是格式要求,是一种纪律—— 写不到一页,说明你没想清楚;写超过两页,说明你没做取舍。"

② 怎么交(3–6 min)

项 规则
命名 D2-姓名-委托单(如 D2-张三-委托单);多文件加后缀 D2-张三-委托单-干系人图.png(06 §3)
格式 Markdown 或 PDF 均可,总分页 ≤2 页(>2 页直接打回)
截止 直播次日 21:30
门禁榜 次日 08:30 公布通过名单
补交 24 小时内补交(每门 1 次)= 正常放行(标注"补交通过");再晚 = 延期通过,作品集等级最高 B(03 §3)
数据红线 只用 07 的虚构案例,或你自己已脱敏并经公司同意的场景;真实客户名与 PII 不进群、不上传(11 §6.1)

讲师补一句:"别把'我公司真实项目'直接抄上来——想用自己的场景,走 S6 路径 A 的脱敏流程。"

③ 三条自检 + 两条高频坑(6–8 min)

三条自检(05 §4 D2 的落地版):

① 每一条成功标准,客户能自己验收吗?        → 不能 → 改
② 干系人图上,有第二发起人吗?              → 没有 → 写上"死亡风险"
③ 放弃标准里,有没有一句"什么情况下不做"?  → 没有 → 补

两条高频坑(06 D2 任务卡 + 03 §4):

坑 症状 处方
成功标准只有工程师能测 全是 F1 / MAE / 延迟 换成客户的业务量:工单数 / 时长 / 覆盖率 / 缺陷数
发起人只有一位 图上孤零零一个名字 问自己一句:"他明天离职,项目还活着吗?"(06 D2 常见坑原文)

④ 明日钩子(8–10 min)

"今天你写的是'什么算成功'。 明天你会拿到决定'能不能成功'的那份东西——数据。

明天有一句话你会反复听到:先看再装。 你还会看到一个反常识的现象:一份'干净得不能再干净'的 CSV,它自己不会告诉你哪里有问题。

明天见。"

投屏·板书

  • 左:G2 四条(原文 + 判定)
  • 中:提交规则表(命名 / 截止 / 补交 / 红线)
  • 右:三条自检
  • 白板角落:停车位(课后答疑时逐个清)

互动设计

问题 期望答案 冷场备选
"有没有人对 G2 哪一条不确定?" 通常问 ④"一页"怎么算 现场给判据:"打印出来一页正反面之内"
"用自己的真实项目算不算违规?" 算,除非脱敏并经公司同意 现场念 11 §6.4 脱敏四步法(拿掉/替换/哈希/保真)

学员动作(现场)

  • 确认提交规则(命名 + 截止)
  • 把三条自检抄到笔记里
  • 在群里回一个"收到"(讲师以此确认覆盖率)

常见错误与纠偏

错误 纠偏
讲师开始提前讲 D3 的 connect 命令 立即收:"明天讲。今天讲了,明天你就不听了"
学员问"能不能用 Notion / 飞书文档交" 可以导出 PDF 交;但格式不重要,G2 的四条才重要
有人问"补交会不会影响证书" 诚实回答:会记录在案,作品集等级受限——这正是门禁的意义(03 §1)
收尾拖到 90 分钟之后 硬性:到点收。自练时段学员自己会来问

承接语(最后 30 秒)

"今天就到这儿。接下来 45 分钟是自练——今晚的目标不是完美,是交出去。 交出去你才有资格被指出错在哪。"

学员笔记要点

  • G2 四条:标准可度量(blocker)· ≥2 发起人(blocker)· 放弃标准(warning)· ≤1 页(warning,超 2 页 blocker)
  • 命名 D2-姓名-委托单;截止直播次日 21:30;补交 24h 内正常放行(标注"补交通过"),再晚延期通过(封顶 B)
  • 红线:只用虚构案例,或自己已脱敏并经公司同意的场景
  • 两条高频坑:标准只有工程师能测 · 发起人只有一位

S6 · 自练(+45 min)

本节定位:不讲课,学员自己做完并提交。助教在群里值守答疑。 这一节的成功判据只有一个:提交率。 讲师课后统计,未交者次日 08:30 前私聊。

45 分钟怎么分(投屏建议)

分钟 做什么 为什么这么排
0–10 把成功标准改成可度量(用 S4 圈的圈) 最难、最值钱,放精力最好的时候
10–20 补完干系人地图(逼出第二发起人) 需要"想人",比改数字更费脑
20–30 写放弃标准 + 范围(✅做 / ❌不做 / 🔄变更规则) 需要判断,但要基于前面两步
30–40 通读 + 压缩到 ≤1 页 压缩是最好的自检
40–45 自评 G2 四条 + 提交 留够提交时间,别卡在最后一分钟

三条路径(学员按自己情况选一条)

路径 适合谁 做什么
A · 完成(推荐) 所有人 用 07 案例 B(A 组)/ 案例 C(B 组)完成委托单 → 自评 → 提交
B · 迁移 手头有真实项目的人 用你自己已脱敏并经公司同意的场景重做一份(11 §6.4 脱敏四步法:拿掉 / 替换 / 哈希 / 保真)。红线:真实客户名与 PII 不得出现在提交物里
C · 加练 想多练手的人 用案例 E 明源体检(07 §2.5)写一份"放弃标准清单"——体会什么叫"什么时候该说不"

关于路径 C:只写放弃标准,不写整份委托单。 目标是把"说不"练成一种可执行的判断,而不是一种态度。

完成标准(提交前逐条打钩)

☐ 成功标准 ≥3 条,每条都有【数字】和【时间】,且【客户能自己验收】
☐ 干系人地图含 ≥2 位发起人(找不到第二位的,图上必须有"死亡风险"标注)
☐ 每个人的"在乎什么"都写了(不是只有名字)
☐ 有放弃标准,且至少一条是可触发的条件句
☐ 委托单打印出来 ≤1 页(最多 2 页)
☐ 命名 D2-姓名-委托单

卡点急救

卡在哪 怎么救
"我找不出第二发起人" 别编。 写"死亡风险:唯一发起人",并在风险清单里写"下次会议的首要议程 = 确认第二发起人"——这是一份合格的产出
"客户验收不了我这条标准" 三步换主体:① 这条标准对应的客户业务动作是什么?② 那个动作的数量/时长叫什么?③ 从多少到多少?
"一页装不下" 不是删字,是删节:先砍第 7 节(风险)到 3 行,再砍第 1 节(画像)到 2 行。第 2、3、6 节一个字都不能少
"我不知道放弃标准写什么" 套模板句:"如果 <前置条件> 在 <时点> 之前不成立,我们建议暂停并重新评估"。前置条件从"数据拿不到 / 无第二发起人 / 无验收人"里挑

助教值守规则

  • 只回答两类问题:① 规则类(命名 / 截止 / 格式)② "这条标准客户能验收吗"——用 S2 的改造三件套反问,不替改
  • 不回答:案例背景的"标准答案"(会破坏 D8 交叉提问)、技术方案类问题(D4–D5 才讲)
  • 每 15 分钟在群里发一次进度提示("还有 30 / 15 / 5 分钟")
  • 收到提交后只回一个字:✓(不讲评——讲评在次日 08:30 门禁榜 + D3 回炉)

学员动作

  • 45 分钟独立完成(路径 A / B / C 三选一)
  • 自评 G2 四条
  • 提交 → 收到 ✓
  • 在群里写 60 秒收获:「我今天最难的一条标准是什么?我最后怎么改的?」

常见错误与纠偏

错误 纠偏(助教用)
学员把委托单写成 4 页方案书 "跑错站了——今天是 Zone A,方案在 D4–D5。你先把范围砍回一页"
学员提交里出现真实公司名 / 手机号 / 邮箱 立即私聊,要求撤回重交;引用 11 §6.1 红线(违规 = 数据合规事故,03 §8 一票否决项)
学员把 seed 档案的参考标准原样抄来 不禁止,但次日回炉会点名问:"这条 MAE ≥20% 是谁来验收?"——抄的人答不上来
学员只交了成功标准,没交干系人图 打回:blocker 缺一条就是没过,不是"部分完成"

附 A · D2 板书总图(一天下来的白板应该长这样)

┌────────────────────────────────────────────────────────────────────┐
│  D2 · 定边界 —— Zones A 的目标不是写方案,是定义 done               │
├──────────────────────────────┬─────────────────────────────────────┤
│  一句抱怨(客户原话)         │  一页委托单(7 节)                  │
│  "订多了报废,订少了断货"     │  ① 画像  ② 干系人 ★  ③ 成功标准 ★    │
│                              │  ④ 时间盒  ⑤ 范围  ⑥ 放弃标准        │
│                              │  ⑦ 风险                              │
│                              │  ★ = blocker(硬拦)                 │
├──────────────────────────────┴─────────────────────────────────────┤
│  三个问题:谁说了算? · 值不值得做? · 什么算 done?                 │
├────────────────────────────────────────────────────────────────────┤
│  可度量三件套:① 主体是客户 ② 基线→目标 ③ 时间 + 测量集             │
│  时间盒:≤14d 集成 · ≤90d 上线 · ≤120d 交接 · 每周同步               │
│  干系人四类:执行发起人 · 第二发起人 · 一线使用者 · 把关人            │
├────────────────────────────────────────────────────────────────────┤
│  反模式:Sponsor Collapse(唯一发起人)· Infinite Pilots(没有 done) │
│  两套门禁一个标准:课程 G2 ←→ 工具 success_criteria                  │
│  金句:会做的人是供应商,会说不的人才是顾问                           │
├────────────────────────────────────────────────────────────────────┤
│  停车位:________________________________________(今天跑题的术语)  │
└────────────────────────────────────────────────────────────────────┘

附 B · 讲师自查(下课前 5 分钟)

  • ☐ 三条红线全守住了?有没有冒出第 4 个概念却没进停车位?
  • ☐ "客户自己能验收吗"问够 3 次了吗(S2 / S3 巡场 / S4)?
  • ☐ S2 演示的四条命令全部真跑了吗(不含任何口头描述的"应该会输出")?
  • ☐ 有没有演示 gate check --gate site_survey 这个空 PASS?(不该有)
  • ☐ S3 的"独立写 4 分钟"没有被压缩掉吧?
  • ☐ 干系人地图的"第二发起人"逼问,每个桌都压到了吗?
  • ☐ 1 优 1 劣讲评没有点名任何学员吧?
  • ☐ G2 四条、命名规范、截止时间、补交规则都念全了吗?
  • ☐ D3 钩子埋了吗("明天你会看到号称最干净的数据")?
  • ☐ 未提交名单记下来了吗(次日 08:30 前私聊)?

下一节:18-D3逐节教案.md(接数据:先看再装) 本日配套:02-逐日教学大纲.md Day 2(时间盒总表)· 06-学员手册与作业包.md D2 任务卡 · 07-实战剧本与案例库.md §2.1 / §2.4 / §2.5 / §3.1 / §4.1 · 12-附录-术语表与模板库.md §2.1(委托单模板)

18 · D3 逐节教案:接数据(先看再装)

18

course-level-1/18-D3逐节教案.md

本文件是 D3(90 分钟直播 + 45 分钟自练)的逐节执行稿:每节课讲什么、怎么说、屏幕放什么、学员做什么、卡住怎么救、下一节怎么接。 上游时间盒:02-逐日教学大纲.md Day 3|通用骨架与控场:05-讲师手册.md §2 / §4(D3 五条带教要点) 模板与术语:12-附录-术语表与模板库.md §1.6(十二反模式 · 第 9 条 Data Quality Surprises)· §2.2(数据体检报告模板)· §3.5(出错速查) 演练素材:07-实战剧本与案例库.md §2.2(迅捷出行)· §2.3(南湾汽车)· §3.2(D3 数据交接 · 三个坑)· §4.4(车间主任角色卡)· §5(助教评分) 数据红线:11-工具与环境准备.md §6(数据合规与 PII 红线 · 不可协商)|学员侧任务卡:06-学员手册与作业包.md D3|门禁条款:03-评估体系与通关门禁.md §3 G3 行 本日演示数据:examples/quickstart_csv/sample_tickets.csv(20 条虚构工单)+ 工业补充 examples/quickstart_manufacturing/(12 条虚构报警)|演示工作目录:/tmp/fde-d3-demo(不写进仓库)


0. 今天的三条红线(全天不许破)

# 红线 怎么守
1 全天只出现 3 个新概念:schema 探测 · PII 红线 · 覆盖度 任何时刻冒出第 4 个术语 → 写进"停车位"(白板角落),课后答疑再讲。"缺失率""熵""长尾"都算在三个概念之内,不要另开词条
2 任何结论必须写完三选一:能做 / 不能做 / 有条件能做 今天"待定""再评估""建议进一步分析"= 同一件事:没交。G3 第 ③ 条是 blocker(03 §3)
3 不碰真实数据:演示与作业只用课程自带虚构数据 真实客户名与 PII 不进群、不上传、不进任何第三方工具(11 §6.1 三条红线);违规 = 数据合规事故(03 §8 一票否决项)

今天没有硬性休息:D3 直播同样只有 90 分钟,中间不设休息点。 但 S3 上手 35 分钟是天然的"站起来"时间——助教会挨桌扮演客户 IT 主管(07 §3.2),学员会被"逼着站起来接数据"。

为什么今天这么"紧":D2 你定义了什么算 done,D3 要回答一个更冷的问题——你拿到的这堆东西,配不配得上你昨天签的字? 今天全天只有一个动作:先看,再装。看完之后必须敢说三句话之一:能做 / 不能做 / 有条件能做。 宁可少讲一个案例,也要保证每个学员手里有一份自己下的结论。

今日 6 节课总览

节 时间 一句话目标 学员产出 记忆锚点
S1 回炉 0–10 min G2 讲评(1 优 1 劣)+ 全班"先猜后看"预注册 写下三个猜测数字 "先猜,再看——猜错才有收获"
S2 讲与演 10–35 min 看 connect 揭穿"最干净的数据",看见 PII 藏在哪、覆盖度缺在哪 观察笔记 "不亮 ≠ 没有 PII;均匀 ≠ 够用"
S3 上手 35–70 min 亲手做完自己的数据体检(含助教扮演客户 IT 的三个坑) 🎯 产出 3 草稿 "这个 PII 字段,不能收"
S4 复盘 70–80 min 相邻互检,找对方漏掉的 1 个风险 修订清单 "你漏的那个风险,客户会替你发现"
S5 布置 80–90 min 收 G3 + 明日钩子 提交清单 "明天我当场问你:有多少是你编的"
S6 自练 +45 min 独立完成、自评、提交 🎯 产出 3 提交 门禁自查 4 条

今日产出物(🎯 产出 3):数据体检报告(约一页半),6 节结构见 12 §2.2: ⓪ 一句话结论 ① 数据源概况 ② 字段清单与质量 ③ PII 清单与处置 ④ 覆盖度观察 ⑤ 质量风险(≥3 条)⑥ 下一步建议。 通关门禁 G3 原文(03 §3): ① 字段清单含类型与缺失率 ② PII 清单与处置建议 ③ 明确结论"能做 / 不能做 / 有条件能做" ④ ≥3 条质量风险 —— ①②③ blocker;④ warning。 ⚠ 注意 ④ 只是 warning:它不拦你,但会进作品集评分。真正会把你拦在门外的是"结论写待定"。


S1 · 回炉(0–10 min · 10 min)

本节定位:10 分钟干三件事——交出 D2 的账(门禁榜 + 1 优 1 劣),然后用一次全班预注册制造今天的认知冲突。不讲课,只讲评 + 提问。

一句话目标(开场念):"昨天你签了字。今天你要拿出证据,证明你签的字站得住——或者,当场发现自己签错了。"

分钟级时间盒

分钟 动作 目的
0–3 G2 门禁榜(3 个数字)+ 补交规则复述 让"过没过"变成公开事实
3–8 1 优 1 劣讲评(都不点名) 让"好长什么样"可复制,让"坑"提前暴露
8–10 先猜后看预注册:群里打 3 个数字 制造今天上午的认知冲突

讲稿要点

① G2 门禁榜(0–3 min)——只念三个数字

投屏一张表,不要念名单(念名字会把讲评变成社死现场):

指标 数字(讲师课前填) 念法
提交率 __ / __ "今天有 N 位同学没有交——不是骂人,是提醒:门禁是逐关的,缺一关后面全堵"
G2 一次通过率 __% "接近一半的人第一次没过。这是正常的,D2 的门禁就是这么设计的"
被拦最多的一条 blocker 通常是 ② ≥2 位发起人 "第二名被拦的是 ③ 放弃标准缺失——放弃标准是 warning,为什么会拦? 因为它缺了就没人拦 Scope Creep(12 §1.6 第 1 条)"

⚠️ 讲师注意:补交规则要在这一分钟念完整——24 小时内补交 = 正常放行(标注"补交通过");超过 24 小时 = 延期通过,作品集等级最高 B(03 §3)。D2 已有未交者,今天再念一遍,不针对个人。

② 1 优 1 劣讲评(3–8 min)——两份都匿名,都念原文

优的那份(从提交中挑,隐去姓名与公司名),念完立刻指认三个动作——不要只说"写得好":

"第一,成功标准里验收主体是客户:'门店催单率下降 30%(周报口径,门店运营可自查)'——注意括号里那半句,那才是真功夫。 第二,干系人地图上有第二发起人,而且标注了'她怕什么'。 第三,放弃标准写成条件句:'若 30 天内拿不到历史工单导出权限,建议暂停并重谈范围'。 这三条,就是 G2 的 ②③④ 三条。你们抄的不是这份文档,是这三条的动作。"

劣的那份(典型错误,同样匿名),念完把错误落到门禁条款上:

"这份的六个成功标准里,有四条是形容词——'提升客户体验''提高响应速度'。 我不骂它。我只问一句:这条标准,客户自己能验收吗? 客户验收不了的标准, 到了 D7 验收清单那一栏,就是一行空格(12 §2.11)。 还有,干系人图上只有一个人。昨天我说的那三个字,今天再写一遍——死亡风险。"

⚠️ 讲师注意:1 优 1 劣的两种错法必须是当天最高频的两种(见 09 的作业抽样)。不要挑"离谱的错"逗笑全场——要挑"大多数人都犯的错",才有纠偏价值。

③ 先猜后看预注册(8–10 min)——今天最重要的一分钟

投屏这三个问题,让全体在群里打数字(不是打"是/否"):

① 这份工单数据,四列里会被工具标出 PII 的有几列?   猜:__ 列
② 20 条文本里,藏着能定位到真人的信息的有几条?     猜:__ 条
③ 9 个类别里,有几类"够用"(按每类 ≥100 条真实样本)? 猜:__ 类

不许现在解释"为什么是这些数字"。 让学员猜完、群里刷完屏,你再收口:

"记住你打的那三个数。25 分钟后我们一条条对。 我不提前说答案——因为在真实项目里,也没有人提前告诉你答案。 你能不能在这个行业里活下去,取决于一件事:你敢不敢先看,再下结论。"

这就是今天全天唯一的动作:先看,再装。(05 §4 D3 第 1 条)

投屏·板书

  • 左:G2 门禁榜(三个数字,不出现人名)
  • 中:优的那份的三个动作(验收主体是客户 / 第二发起人 / 放弃标准是条件句)
  • 右:三个猜测问题(群里刷数字,投屏只留问题)
  • 白板角落:停车位(今天所有跑题问题记这里)

互动设计

问题 期望答案 冷场备选
"① 四列里几列会被标 PII?" 群里会出现 0/1/2/3 各种答案——这就是冲突的种子 讲师自曝:"我第一次猜 2 列。答案是 0。我错得比你们都离谱"
"② 有几条藏着真人信息?" 多数人猜 0 或 1 提示:"想想你自己的工单——用户会在正文里写什么?"
"③ 9 类里几类够用?" 群里没人敢答(因为不知道"够用"是多少) 直接给口径:"≥100 条/类,这是我们课程的默认目标值(工具里叫 target_per_category)"

⚠️ 第 ③ 问有一个隐藏考点:"够用"是相对口径,不是绝对真理——它是"训练一个分类器的最小样本量"的经验值。 学员问"凭什么 100"时,答:"凭我们要在 D5 做评估。没有分母的指标都是废话——这句话你今天会再听到一次。"

常见错误与纠偏

错误 纠偏
学员追问"我的那份到底过没过" 指门禁榜:"榜上只念数字,个人结论 fde-scope gate check <你的 id> 自己查"(不发私聊截图)
学员问"能不能给我看看别人怎么写的" "D8 的答辩会让你看到——现在给你看,你就不会自己想了"
有人开始讨论"某某的委托单好水" 立刻拉回:"我们只讲结构,不讲人。 讲评的两份都不知道是谁写的"
讲师在讲评上超时(讲到 10 分钟还没收) 硬性:8 分钟必须开始预注册。预注册被挤掉 = D3 上半场白讲

承接语(最后 30 秒)

"你们刚在群里打的三个数字,我一个都没看。 现在我用 25 分钟,把这三个数字一个个跑出来给你们看。 先说结论:你们会有人猜对,也会有人猜错——包括我。"

学员笔记要点

  • G2 的三个动作:验收主体是客户 · 第二发起人 · 放弃标准是条件句
  • 补交规则:24h 内 = 正常放行(标注"补交通过");超时 = 延期通过(作品集等级最高 B)
  • 今天的三条红线:3 个概念(schema 探测 / PII 红线 / 覆盖度)· 结论必须三选一 · 不碰真实数据
  • 群里留下过三个猜测数字——一会儿要对账

S2 · 讲与演(10–35 min · 25 min)

本节定位:全场唯一的"演示"段。目标不是讲清 PII 是什么,是让学员亲眼看见"号称最干净的数据"里藏着什么。 本节产出的不是知识,是"证据长什么样"的样板。

一句话目标(开场念):"上一节你猜了三个数。这一节我把命令行敲给你看,我们当着全场对账。"

分钟级时间盒

分钟 动作 对账哪一问
10–13 跑 connect,读 schema 表:field / type / nullable / PII? 对账 ①(几列被标 PII)
13–18 逐条看值 → 找出藏在 content 里的手机号与邮箱;讲 PII 红线与脱敏四步法 对账 ②(几条藏着真人信息)
18–23 读 categories 与手工 Top/Bottom → 讲"均匀 ≠ 够用";工业数据对照 对账 ③(几类够用)
23–28 讲结论怎么下(三选一 + 条件句);讲"待定"为什么是 blocker ——
28–33 门禁被真实拦截:南湾汽车三条工业门禁实测 制造"数据问题的后果"
33–35 收口:回到 6 节模板;埋 D4 钩子 ——

⚠️ 今天不出 corpus 的主角戏:只在 13–18 分钟借它一个数字(PII entities masked: 2)做交叉验证。 正式锻造是 D4 的内容(02 Day 4)。说清楚"今天只借,明天才学",否则学员会以为语料环节已经过了。

讲稿要点

① 10–13 min|跑 connect:先看"字段",不看"结论"

fde-scope connect --type csv --source examples/quickstart_csv/sample_tickets.csv

投屏读出来(终端里是一张 Rich 表格,这里抄成 Markdown):

field type nullable PII?
id string False (空)
content string False (空)
category string False (空)
channel string False (空)

底部一行摘要(逐字念):

rows≈20 · categories=['物流查询', '退款', '账号问题', '退换货', '支付问题', '订单修改', '会员咨询', '发票咨询', '售后补发'] · channels=['chat', 'email', 'phone'] · sample_size=20

对账 ① 揭晓:

"答案是 0 列。四列一个都没被标。猜 1、2、3 的举手——你看,工具没骗你,是你在骗自己。 为什么?因为 schema 表只按字段名判(12 §2.2 工具路径)。 列名叫 email、phone、id_card 才会亮 ⚠。这份数据的列名是 id / content / category / channel—— 名字听起来一点问题都没有。这就是它危险的地方。"

顺手讲清 schema 三列的含义(这是"schema 探测"这个概念的全部):

列 你在读什么 今天要写进体检报告的
field 有哪些字段 字段清单(第 ② 节)
type 是什么类型(string / int / float / 日期) 类型列
nullable 允不允许空(False = 这一列的样本里没出现空) 缺失率(注意:nullable=False 只是样本没空,不等于全量没空)
PII? ⚠ = 字段名像 PII PII 清单(第 ③ 节)——但要先看完下面的内容

⚠️ nullable=False 这个坑:20 条样本里没空值,不代表 32,400 条里没空值。 sample_size=20 是抽样预览,不是全量。体检报告里写缺失率时,要么问客户要全量统计,要么写"样本内缺失率 0%,需全量复核"——不要写"缺失率 0%"。

② 13–18 min|逐条看值:PII 藏在正文里(今天全场最贵的一分钟)

投屏打开 CSV 的原始行(不要用工具,用编辑器/终端 head,让学员看到"真东西"):

head -4 examples/quickstart_csv/sample_tickets.csv
id,content,category,channel
t-001,我的订单三天了还没发货麻烦帮我查一下物流谢谢,物流查询,chat
t-002,申请退款商品质量有问题已经拍照留存希望尽快处理,退款,email
t-003,无法登录账号提示密码错误但是我确定没改过,账号问题,chat
grep -n "13800138000\|@example.com" examples/quickstart_csv/sample_tickets.csv
4:t-004,商品破损要求换货联系邮箱 customer@example.com,退换货,email
8:t-007,已经申请退款一周了还没到账我的手机是13800138000,退款,phone

对账 ② 揭晓:

"答案是 2 条。第 4 条里有一个邮箱,第 8 条里有一个手机号——都在正文里,不在任何一列的名字里。 同志们,这就是今天最贵的一句话:

投屏,全天常驻:

不亮 ≠ 没有 PII。自由文本必须逐条看值。

接着用工具交叉验证(本节唯一一次出 corpus):

fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --out /tmp/fde-d3-demo/corpus_report.html

输出里有一行(只看这一行,其他明天讲):

✅ PII entities masked: 2

"工具在清洗阶段把这两条揪出来了。注意这个先后顺序—— connect 说'没有 PII',corpus 说'我遮了 2 个'。 两个结论都对,因为它们看的不是一个东西:一个看列名,一个看内容。 这就是为什么体检报告第 ③ 节不能只抄 connect 的输出。"

然后讲红线——今天必须逐条念,不许带过(11 §6.1):

# 红线 现场话术
1 只用两类数据:课程自带虚构数据,或你自己已脱敏并经公司同意的数据 "这份 CSV 是虚构的,脚本里写死了免责声明。你公司的数据不是"
2 真实客户名与 PII 不进群、不上传(含作业、截图、提问里的粘贴内容) "有人上周把工单截图发群里问我——那张截图就是一次数据合规事故"
3 不进任何第三方工具:在线标注平台、在线 JSON 格式化、网盘、聊天机器人 "包括你现在正在用的那个 AI 助手。包括我"

PII 的判断标准只有一句话(11 §6.2):

"这条信息能不能定位到具体某个人? 能 → 按 PII 处理。"

处置方法讲"脱敏四步法"(11 §6.4)——只讲前两步,后两步留给自练路径 B:

步 动作 例
1 拿掉 与任务无关的 PII 直接删列 客户表里的身份证列
2 替换 保持格式、换掉内容 13800138000 → 13800000000
3 哈希 需要保留关联性时 用户 ID → u_3f9a…(同人同哈希)
4 保真 分布、长度、语言风格不变 脱敏后仍能被质量门正常处理

⚠️ 讲师提醒:脱敏不是"遮住了就行"。第 4 步"保真"才是专业分水岭—— 把手机号全部替换成 1 之后,这类样本在语料里就废了(长度分布、格式特征全没了)。 一句话:"你脱敏后的数据,还要能被当成数据用。"

③ 18–23 min|覆盖度:均匀 ≠ 够用

回到 connect 那行摘要里的 categories=[...]——9 个类别。然后当众手数 Top/Bottom(这一步必须是手工的,让学员看到"数"这个动作):

物流查询 3 · 退款 3 · 账号问题 3 · 退换货 3 · 支付问题 3 · 订单修改 2 · 会员咨询 1 · 发票咨询 1 · 售后补发 1
(合计 20)

对账 ③ 揭晓:

"答案是 0 类。9 个类别,一类都不够。按每类 ≥100 条算,这份数据现在能用的比例是 3%(3/100)。 你们刚才猜 70%、80% 的——现在知道为什么我说'没有分母的指标都是废话'了吧。"

然后跑出工具的口径(同一个 corpus 报告,看第二块内容):

python - <<'PY'
import json; d = json.load(open("/tmp/fde-d3-demo/corpus_report.json"))
print("real:", d["real"], "| synthetic:", d["synthetic"], "| total:", d["total"])
print("target_per_category:", d["coverage"]["target_per_category"])
print("diversity_index:", round(d["coverage"]["diversity_index"], 4))
print("gaps:", len(d["coverage"]["gaps"]))
PY
real: 20 | synthetic: 395 | total: 415
target_per_category: 100
diversity_index: 0.9569
gaps: 9

这三个数字要讲透,因为它们是今天第 ③ 关的口径:

数字 含义 现场话术
gaps: 9 9 个类别全部低于目标 "昨天客户说'类别分布很均匀的,放心'——他说的对,也不对"
diversity_index: 0.9569 归一化香农熵,1.0 = 完全均匀 "0.96,确实很均匀。客户没骗你。但均匀说的是'相对分布',它一个字都没说'绝对够不够'"
target_per_category: 100 每类目标样本量 "这是分母。没有分母的 0.96 是自我安慰"

投屏,全天常驻第二句:

均匀 ≠ 够用。熵只告诉你形状,不告诉你体积。

💡 讲师可以补一句工程视角(30 秒,别超):"为什么是熵?因为它是可解释的、你能当着客户面手算的。 客户听不懂的东西,都不该出现在你的报告里(这话 D4 讲客户话术时还会说)。"

工业数据对照(B 组必看,A 组可以不听):跑工业补充数据,让学员看到同一套方法、另一种数据形态:

fde-scope corpus --input examples/quickstart_manufacturing/alarm_corpus.jsonl --out /tmp/fde-d3-demo/alarm_report.html
🔄 Loaded 12 raw rows
✅ PII entities masked: 0
✅ Corpus forged: 12 real + 560 synthetic = 572 total
⚠ Coverage gaps:  过载保护: 1 · 抓取故障: 1 · 视觉异常: 1 · 安全监控: 1 · 节拍异常: 1
                  导航异常: 1 · 运动异常: 1 · 通信故障: 1 · 质量缺陷: 1 · 急停事件: 1
                  执行器故障: 1 · 数据缺失: 1   (共 12 类,每类 need ≥100)

"工业数据里 PII 是 0——不是工业数据干净,是 PII 不在报警日志里。 但你注意:12 类故障,每类 1 条。这就是 B 组今天要面对的同一道题:均匀、清晰、但远远不够。 场景换了,方法没换;红线换了位置,判断标准没换。"

④ 23–28 min|结论怎么下:三选一,且必须带条件

投屏 12 §2.2 第 0 节的示例结论,逐字念:

"有条件能做:现有 32,400 条工单可支撑意图分类,但退款类样本仅 12 条, 需在 D4 补盲 ≥200 条,否则该场景不纳入验收范围。"

然后拆解这句话的三个动作:

动作 这句里的对应 为什么必须有
先给总体判断 "有条件能做" G3 ③ 是 blocker,三选一,没有第四项
给条件(可核对的事实) "退款类样本仅 12 条" 这是从覆盖度表里抄来的真实数字,不是你感觉的
给后果(触发条件句) "否则该场景不纳入验收范围" 这就是 D2 的放弃标准在数据层的回声

然后讲"待定"为什么不可接受:

"有人会说:'我还看不出来,先写待定,D4 再定'。 不行。因为客户不是等你写完报告才做决定——他今天下午就要回答老板'这个项目能不能上'。 你写待定,他就只能说'不知道'。你交付的是判断,不是材料。 犹豫怎么办?犹豫就写条件:'若能补齐 X 字段则能做,否则不能做'——这是判断,不是待定。"

⑤ 28–33 min|门禁被真实拦截:数据问题的后果长什么样

"昨天我说,D3 你会看到'门禁被真实拦截'。现在看。"

COLUMNS=200 fde-scope engage status eng-southbay-manufacturing-seed03
phase: deploy (zone: build) → next: eval
gate: fat_sat (❌ not passed)
progress: 18 phases visible · complete=False
│ site_survey       │ ✅ │
│ success_criteria  │ ✅ │
│ air_gap           │ ✅ │
│ fat_sat           │ ❌ │
│ functional_safety │ ❌ │
│ conformity        │ ❌ │
COLUMNS=200 fde-scope gate check eng-southbay-manufacturing-seed03 --gate conformity
❌ BLOCKED · gate=conformity
  🚫 EU AI Act 高风险系统:CE marking 未完成
  🚫 缺失技术构造文件(Annex IV 技术文档)
  🚫 高风险系统要求危险分析作为 conformity 前提
💡 已把这次阻塞沉淀为草稿 skill-a6009211 — fde-scope skill review 可查看并完善

"南湾汽车这条产线走到 deploy 就停住了。三条 blocker 全是文档与合规——不是算法不行。 你今天的体检报告,就是明天这些文档的第一份底稿。体检报告写不清楚,后面的门一关都过不去。"

顺带讲那一行 💡:门禁被拦下的那一刻,工具会自动把这次阻塞沉淀成一张技能卡草稿 (12 §3.2 的"两个预期行为"之一)。"阻塞本身就是知识—— 这是这门课的设计。你被拦得越多,攒的卡越多。"

⚠️ 讲师注意:--gate 后面只准敲这三条工业门(fat_sat / functional_safety / conformity),因为 南湾汽车是 manufacturing profile。绝对不要在 ticket 档案上演示 --gate site_survey—— 它会打印一个 ✅ PASS,那是"没有可检查的数据"的空过,不是通过(12 §3.2)。 把它当证据写进作品集 = 一眼假。

⑥ 33–35 min|收口 + 埋钩子

投屏体检报告的 6 节骨架(12 §2.2),只念标题:

⓪ 一句话结论  ① 数据源概况  ② 字段清单与质量
③ PII 清单与处置  ④ 覆盖度观察  ⑤ 质量风险(≥3 条)  ⑥ 下一步建议

"35 分钟,你们有 6 节要填。够,因为最难的部分我已经帮你跑完了—— schema 表、PII 计数、覆盖度缺口,工具都给你了。 剩下的是只有人能干的那部分:判断。判断哪些必须脱敏、哪些根本别拿、 这份数据配不配得上你昨天签的字。

明天,我会把你今天补的样本摊开,然后当着你客户的面问你一句: '这些,有多少是你编的?'——今天先把手弄脏。"

投屏·板书

  • 左:schema 表(四列 + PII? 全空)——只留 3 分钟
  • 中:常驻两句话
    • 不亮 ≠ 没有 PII。自由文本必须逐条看值。
    • 均匀 ≠ 够用。熵只告诉你形状,不告诉你体积。
  • 右:体检报告 6 节骨架 + 结论三选一:能做 / 不能做 / 有条件能做
  • 底部:红线三条(11 §6.1)——全天不许擦掉
  • 白板角落:停车位

演示脚本(可直接复制执行)

# 演示前:终端字号最大;演示数据全部是仓库里的虚构样本
# ⚠ samples/preview.json 固定写进"当前目录"下的 samples/(不在 FDE_SCOPE_HOME 里),
#    仓库里这个文件已被 .gitignore 覆盖(.gitignore 第 69 行),所以不会污染 git。

# ① 对账 ①:看字段,不看结论(PII? 四列全空 —— 这就是今天的第一个反转)
fde-scope connect --type csv --source examples/quickstart_csv/sample_tickets.csv
#   → 表格:id / content / category / channel,PII? 一列全空
#   → 摘要:rows≈20 · categories=[9 类] · channels=[chat,email,phone] · sample_size=20
#   → ✅ Sample extracted → samples/preview.json

# ② 对账 ②:逐条看值(PII 藏在正文里,不在列名里)
head -4 examples/quickstart_csv/sample_tickets.csv
grep -n "13800138000\|@example.com" examples/quickstart_csv/sample_tickets.csv
#   → t-004 里 customer@example.com ;t-007 里 13800138000

# ③ 交叉验证:借 corpus 一个数字(其余明天讲)
fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv \
  --out /tmp/fde-d3-demo/corpus_report.html
#   → ✅ PII entities masked: 2      ← 工具在清洗阶段揪出了 connect 没标的那 2 条
#   → ✅ Corpus forged: 20 real + 395 synthetic = 415 total

# ④ 对账 ③:读覆盖度(这个是手工数 + 读 JSON,别用"感觉")
python - <<'PY'
import json; d = json.load(open("/tmp/fde-d3-demo/corpus_report.json"))
print("real:", d["real"], "| synthetic:", d["synthetic"], "| total:", d["total"])
print("target_per_category:", d["coverage"]["target_per_category"])
print("diversity_index:", round(d["coverage"]["diversity_index"], 4))
print("gaps:", len(d["coverage"]["gaps"]))
PY
#   → real: 20 | synthetic: 395 | total: 415
#   → target_per_category: 100 / diversity_index: 0.9569 / gaps: 9

# ⑤ 工业对照(B 组):同一套方法,另一种数据形态
fde-scope corpus --input examples/quickstart_manufacturing/alarm_corpus.jsonl \
  --out /tmp/fde-d3-demo/alarm_report.html
#   → ✅ PII entities masked: 0(工业数据不是干净,是 PII 不在报警日志里)
#   → ✅ Corpus forged: 12 real + 560 synthetic = 572 total
#   → ⚠ Coverage gaps: 12 类,每类 1 条(need ≥100)

# ⑥ 门禁被真实拦截(数据/文档问题的后果)
COLUMNS=200 fde-scope engage status eng-southbay-manufacturing-seed03
COLUMNS=200 fde-scope gate check eng-southbay-manufacturing-seed03 --gate conformity
#   → ❌ BLOCKED:3 条 🚫(CE / Annex IV / 危险分析)+ 一行 💡 技能卡草稿

演示事故预案:

状况 现场处理
学员问"PII? 列全是空的,是不是说明没 PII?" 不要立刻回答——反问"你看了 content 里的值吗?"→ 把 t-004 / t-007 投屏。这一问就是今天的考点
学员问"这些工单是真的吗" 明确回答:"全部虚构,仓库里的示例文件;课程红线就是真实数据不许进课堂(11 §6.1)"
学员问"corpus 是不是 D4 的内容,为什么现在用" "对,今天只借它一个数字(masked: 2)。它的主场是明天"——把话说死,避免学员以为语料环节已过
学员想现场换自己公司的数据来跑 立刻拦住:"要么用课程数据,要么用你已脱敏 + 公司同意的数据,而且只能在自练路径 B 做,不得投屏"(11 §6.4 / §6.5)
命令报 FileNotFoundError: CSV source not found 演示"错了先念一遍错误信息"——原因是不在仓库根目录时相对路径找不到(12 §3.2 ⚠),cd 回根目录即可
学员把 sample_size=20 读成"全量就 20 条" 讲抽样语义:"这是预览。全量口径(总数 / 时间范围)只能问客户——猜出来的数不许进报告"
学员追问"熵是怎么算的" 进停车位。"今天你只需要知道 1.0 = 完全均匀、0.0 = 只有一个类"——公式不是 D3 的内容

互动设计

问题 期望答案 冷场备选
"四列里几列该标 PII?"(揭晓前再问一次) 学员会改口——让他们改,改口本身就是"先看再装"的胜利 直接公布 0 列,然后问"谁猜 0?举手"(通常没人,很有效)
"客户说'分布很均匀',你怎么回?" "均匀不等于够用——我把每类的绝对量给您看" 讲师示范一遍,然后让学员复述这句话
"如果这份数据是你的客户给你的,你收不收?" 有人会说收("先拿着再说")→ 追问"收回来放哪?谁能看?出事谁担责?" 直接引用 11 §6.2 的判断标准一句话
"结论写'待定'行不行?" 全场应该会说"不行"(红线 2 刚讲过) 追问"那你想写待定时,该怎么办?"→ 引出"犹豫就写条件"

学员动作(现场)

  • 群里留下三个猜测数字(S1 已做),本节逐条对照
  • 在自己的笔记里抄下两句话常驻板书(不亮 ≠ 没有 PII / 均匀 ≠ 够用)
  • B 组留意工业对照:同一套方法怎么用在报警日志上
  • 记住那句"明天我会问你:有多少是你编的"

常见错误与纠偏

错误 纠偏
学员把 PII? 全空理解成"这份数据零风险" 重复板书第一句,并让他读一次 CSV 原文——"你自己看第 4 行"
学员问"那我还跑 connect 干嘛,直接跑 corpus 不就行了" 值 30 秒:"connect 只看一眼(快、不落库、能 --dry-run),corpus 要动数据。先看再装是顺序,不是偏好"
学员开始抄工具的表格,不做判断 追问"这一列你处置建议写什么?"——工具给不出这一列(12 §2.2 第 ② 节)
有人问"为什么 D3 就要看工业合规门禁" "不是教你合规,是让你看到后果。你的报告是后面所有文档的第一份底稿"
讲师演示超时(33 分钟还没收口) 硬性:33 分钟必须切到收口。收口可以砍 ⑤,不许砍 ④(结论怎么下 = G3 blocker)

承接语(最后 30 秒)

"工具只能给你三样:字段、计数、缺口。 剩下的三样它给不了你——哪些必须脱敏、哪些根本别拿、这份数据配不配得上你昨天签的字。 35 分钟,轮到你了。助教会挨桌来给你'送数据'——注意他们说的话。"

学员笔记要点

  • 今天只有 3 个概念:schema 探测(字段 / 类型 / nullable)· PII 红线(能不能定位到具体某个人)· 覆盖度(每类绝对量 vs 目标)
  • 两句话常驻:不亮 ≠ 没有 PII(自由文本逐条看值)· 均匀 ≠ 够用(熵只讲形状,不讲体积)
  • 工具的三个数:PII entities masked: 2 · target_per_category: 100 · diversity_index: 0.9569
  • 结论三选一,犹豫就写条件句(禁"待定")
  • 红线三条(11 §6.1):只用虚构或已脱敏数据 / 真实客户名与 PII 不进群不上传 / 不进任何第三方工具
  • 南湾汽车示范:门禁被拦时,工具会自动沉淀一张技能卡草稿

S3 · 上手(35–70 min · 35 min)

本节定位:全场把 S2 的方法用在自己的数据上,并在"接数据"这个动作上被助教当面设坑。 本节的成功判据不是"报告写完了",是"PII 那一栏写了自己的判断"。

一句话目标(开场念):"35 分钟,你只做一件事——把 S2 那三个数字,换成你自己数据上的三个数字,然后写下一句自己的结论。"

分组建档复核(讲师,1 分钟)

D2 已分好组,本节只复核,不重分(07 §2.2 / §2.3):

组 案例(D2 定稿的委托单) 今天练的数据
A 组 案例 B · 迅捷出行(网约车 · ticket) examples/quickstart_csv/sample_tickets.csv(20 条虚构工单,代表"抽样体验")
B 组 案例 C · 南湾汽车(整车厂 · manufacturing) examples/quickstart_manufacturing/alarm_corpus.jsonl(12 条虚构报警)+ 同上的 CSV

⚠️ 讲师提醒:A/B 两组今天都用同一份 CSV 起步(02 Day 3 时间盒)。这不是偷懒—— 目的是让两组在同一份数据上做出不同的结论:A 组看的是"客服工单能不能训分类器", B 组看的是"这套数据方法能不能迁移到工业场景"。B 组额外跑 alarm_corpus.jsonl 找迁移感。 D8 交叉提问时,两组要互相解释对方的数据形态。

分钟级时间盒(学员视角)

分钟 做什么 为什么这么排
0–5 先猜后看(第二轮):写下三个数字——① 我猜 PII 有几条 ② 我猜最长尾的类是哪个 ③ 我猜几类够用(≥100 条) 必须先落笔,再看屏;写下来才有冲突
5–12 跑 connect,抄 schema 表;逐条看值找 PII 工具最快的部分,先拿确定性
12–20 填第 ②③ 节(字段清单 + PII 清单与处置)——处置建议必须自己写 报告里唯一"工具给不出"的部分,精力最好时做
20–27 跑 corpus,数 Top/Bottom,填第 ④ 节(覆盖度)+ 第 ⑤ 节(≥3 条质量风险) 需要动脑归纳,放在中段
27–32 写第 ⓪ 节(一句话结论,三选一)+ 第 ① 节(概况)+ 第 ⑥ 节(下一步建议) 结论要基于前面所有证据,放在最后
32–35 自查 G3 四条 + 准备 S4 交换 留够时间,别卡在最后一分钟

⚠️ 助教巡场时序(三趟,每趟约 10 分钟,覆盖全部桌): 第一趟(5–15 min)以客户 IT 主管身份送数据(三个坑);第二趟(15–25 min)看 PII 处置建议;第三趟(25–35 min)只问一句"你的结论是哪三个字?"

讲稿要点

① 先猜后看(第二轮)——为什么还要猜一次

"S2 我已经当着你们跑过一遍了,为什么还要猜? 因为 S2 我只揭晓了 PII 那一条(2 条)。另外两条——最长尾的类是哪个、几类够用—— 我一个字都没说。而且,你们马上要看的不是同一份数据(B 组还有报警日志)。 更重要的是:在真实项目里,你永远没机会'先看一遍'。 你拿到数据之前,就要能说出你怕什么。"

猜的三个数写在哪里:写进体检报告的最上面,标注 【预注册】 ——这三个数要留着, S4 互检时对方要看,D5 做评估时还要对账("你当时猜 70% 能用,实测 3%")。

② 助教巡场剧本(07 §3.2)——三个坑,逐桌埋

助教扮演客户 IT 主管,把数据"送"给学员(口头 + 指屏幕)。三个坑必须按顺序埋:

# 助教台词(原话) 坑在哪 学员应该做什么 助教怎么判
1 "这是我们能给的全部字段了。" 数据里含 PII(正文里的手机号 / 邮箱 / 工单号) 挑出来说"这个不能收"——点明处置方式(删列 / 替换 / 不入场) 敢不敢说"不收"(11 §6.1 红线 2)
2 "类别分布很均匀的,放心。" 分布确实均匀(熵 0.9569),但每一类都远不够(1–3 条 vs 需 100) 当场用工具输出反驳:把 gaps: 9 与每类绝对量摆出来 是否先看再装(有没有真去数)
3 "时间范围?大概是去年的吧。" "大概"= 一个不能进报告的字段 把"大概"变成确认项:写进第 ① 节"待客户确认",或明确标注"未确认" 有没有把模糊信息变成待办,而不是照抄

助教扮演纪律(讲师提前给助教看这三条):

  1. 不许一次放行——学员说"好的我收下"时,追问"你确定?要不要再翻翻?"(给第二次机会,但只给一次)
  2. 学员反问时照实回答(问"有没有手机号"→"你们自己看"),不许顺着学员说
  3. 学员点破坑时,当场承认并追问一句"那你写进报告的哪一节?"——把口头判断逼成书面判断

③ 车间主任(B 组可选,07 §4.4)

B 组有一个额外彩蛋:讲师(或助教)以焊装车间主任身份路过,说一句:

"你们坐在办公室吹空调,知道焊装线停线赔多少吗?"

触发条件:如果学员说"要停线做数据采集"或"要接 PLC 控制层"→ 主任立刻炸(表演)。 通过标准:学员主动把"旁路采集、不碰 PLC 控制层、只读数据"写进报告的第 ⑥ 节(下一步建议)。 通过暗号:学员问"FAT 阶段你们能安排哪个窗口?"→ 主任给一个 2 周后的停机维护窗口(这一问是 D5 的预演)。

⚠️ 讲师提醒:这个彩蛋只有 B 组有,A 组不要演——A 组的场景里没有车间。 如果时间紧,砍掉彩蛋,不许砍三个坑(三个坑是 G3 的直接考点)。

投屏·板书

  • 左:35 分钟时间盒(学员视角那张表,常驻,让他们自己控节奏)
  • 中:体检报告 6 节骨架(12 §2.2)
  • 右:三个坑的问题清单——只显示"该问的问题",不显示答案:
    ☐ 这份数据里,哪些字段/内容能定位到具体某个人?
    ☐ 类别分布的 Top / Bottom 分别是多少条?
    ☐ 你说的"能用",分母是多少?
    ☐ 时间范围、总量、采集方式——哪些是确认过的?哪些是"大概"?
    
  • 白板角落:停车位

互动设计

环节 讲师动作 目的
0–5 min 全场安静写三个数(不许说话) 把"预注册"变成一次仪式——落笔才算数
巡场第一趟 助教按剧本埋坑 制造"接数据"的真实压力
巡场第二趟 随机抽 2 桌,当众念他们的 PII 处置建议(匿名,念动作不念名字) 让"敢说不收"被公开表扬一次
收尾 1 min 全班举手:"结论写了'有条件能做'的举手?'能做'?'不能做'?" 三个选项都有人举才是健康的——说明有真判断

💡 讲师提示:如果全班都写"能做",立刻停下来问一句: "谁的数据里连一个'待客户确认'都没有?没有待确认项,说明你没细看。"

学员动作(现场)

  • 写下三个预注册数字(先于跑命令)
  • 跑 connect + 逐条看值,产出第 ②③ 节(字段清单 + PII 清单与处置)
  • 跑 corpus,产出第 ④⑤ 节(覆盖度 + ≥3 条质量风险)
  • 写第 ⓪①⑥ 节(结论 / 概况 / 下一步建议)
  • 被助教"送数据"时敢说"这个不能收",并把判断写进报告
  • 自查 G3 四条

常见错误与纠偏

错误 纠偏(讲师/助教用)
学员把 connect 的输出整段贴进报告,不做判断 追问"处置建议那一列呢?"——工具没有这一列,这是你的活
学员写"PII:无" 让他逐条看一遍值(grep 手机号 / 邮箱 / 身份证正则),再回来改
学员的结论是"待定" 不批评,只问"你缺哪个信息才能下结论?写出你的条件"→ 改写成条件句
学员把"大概去年"照抄进第 ① 节 要求改写为"时间范围:待客户确认(口头为'大概去年')"——把模糊变成待办
学员纠结"要不要问客户要全量数据" 记进第 ⑥ 节"下一步建议"——今天不用拿到,但今天必须写下要什么
学员拿自己公司的真实数据来跑(路径 B) 立即私聊,要求撤回重交;引用 11 §6.1(违规 = 数据合规事故,03 §8 一票否决项)
学员只写了 1 条质量风险就停手 "G3 ④ 要 ≥3 条",给三个方向:缺失 / 重复 / 口径不统一 / 长尾不足 / 已知局限

承接语(最后 30 秒)

"停笔。现在做一件事:把你手里的报告,和旁边那位换。 你只有 10 分钟,任务只有一个——找出他漏掉的那个风险。"

学员笔记要点

  • 预注册三个数必须落在纸上,S4 与 D5 都要对账
  • 三个坑的原话:全部字段 / 分布很均匀 / 大概是去年的 → 对应动作:不收 / 反驳 / 变成待办
  • 报告里唯一工具给不出的两列:处置建议(第 ③ 节)与质量风险(第 ⑤ 节)
  • 结论三选一,犹豫就写条件句

S4 · 复盘(70–80 min · 10 min)

本节定位:10 分钟做两件事——相邻互检(找对方漏掉的 1 个风险)与命名反模式。 这一节的价值不在"改好了",在"看见自己的盲区"。

一句话目标(开场念):"你做体检的时候,一定会漏东西。今天让同桌替你找出来——比让客户找出来便宜一万倍。"

分钟级时间盒

分钟 动作 目的
70–74 相邻两人交换,各找出对方漏掉的 1 个风险(必须具体到条款/字段) 用第二双眼睛补盲
74–77 抽 2 组当众念"我发现了什么"(念发现,不念人名) 把个案变成公共知识
77–79 命名反模式:Data Quality Surprises + 三条高频漏项 给错误一个名字,才记得住
79–80 收口 + 接 S5 ——

讲稿要点

① 互检怎么说(70–74 min)——给三句提问模板

轮到互检时,学员常常尬聊。直接投屏三句话,让他们照着问:

1. "你这份数据里,哪一列/哪些内容能定位到具体某个人?——我在你的报告里没看到 X。"
2. "你说'能用',分母是多少?(每类多少条?目标多少条?)"
3. "第 ① 节里,哪几个字段是你**确认过**的?哪几个是'大概'?"

"三句话对应三件事:PII 漏没漏、覆盖度有没有量、事实与推测有没有分开。 找不出问题的,说明你俩漏在了同一个地方——那更值钱,正好一起补。"

② 抽 2 组当众念(74–77 min)——只念"发现"

标准句式(让学员照念):

"我在 <第 X 节> 发现 <具体缺失>,我的建议是 <动作>。"

例(讲师可以示范一遍,用自己"漏掉"的例子最好):

"我在第 ③ 节发现他只写了'涉及手机号',没写处置方式——PII 清单是 blocker, 但 blocker 要的是'清单 与处置建议'。我的建议是补一句'正则替换为 <PHONE>,脱敏后入语料'。"

⚠️ 讲师注意:不许点评人,只点评发现。哪怕发现得很轻,也先肯定"这条确实是漏项"。 10 分钟里被打击一次的人,S6 会直接不交。

③ 命名反模式(77–79 min)——给今天最好的名字

投屏 12 §1.6 第 9 条,逐字念:

| 9 | Data Quality Surprises 数据质量惊吓 | 假设"数据已经治理好了" | 开工先做数据体检(G3) |

"这个反模式叫 Data Quality Surprises——数据质量惊吓。 它的定义只有一句话:假设'数据已经治理好了'。 今天你们看到的三件事,全是它的后果: ① 四列没标 PII,你以为干净——结果正文里躺着手机号和邮箱; ② 客户说'分布很均匀',你以为够用——结果 9 类全部不达标; ③ 客户说'大概是去年的',你以为有范围——结果你连时间范围都没确认。

反制动作只有一个:开工先做数据体检。 就是你们刚才做的那件事。"

四条高频漏项清单(讲师按当天实际提交挑,通常落在这四条):

# 高频漏项 一句话矫正
1 PII 只写"有",没写处置方式 G3 ② 要的是"清单与处置建议"——没写怎么处理 = 没写
2 覆盖度只写"不均匀",没写绝对量 每个类别都要有数字(Top / Bottom 都要)
3 结论写成"待定 / 建议进一步分析" 三选一;犹豫就写条件句
4 事实与推测混在一起 "确认过的"与"大概是"必须分栏写——第 ① 节加一列"确认状态"

④ 收口(79–80 min)

"你们的报告现在至少被两双眼睛看过——你自己的,和同桌的。 待会儿自练时段,你要把它改到能交给客户的程度。 因为明天,你要拿它换一沓语料。"

投屏·板书

  • 左:三句互检提问模板(常驻 10 分钟)
  • 中:Data Quality Surprises → 开工先做数据体检(G3)
  • 右:四条高频漏项(讲师按当天实际挑,写满四条)
  • 白板角落:停车位

互动设计

环节 讲师动作 目的
交换 计时 4 分钟,时间到必须停 防止互检变成聊天
当众念 只抽 2 组(10 分钟里超过 2 组就变成拖堂) 保持节奏
命名 念完反模式后问一句"谁今天被'惊吓'到了?举个手" 用笑声收尾,同时把概念钉住

学员动作(现场)

  • 交换报告,找出对方漏掉的 1 个风险(具体到节 / 字段)
  • 记录对方给自己找出的漏项(待会儿 S6 要改)
  • 抄下反模式名与四条高频漏项

常见错误与纠偏

错误 纠偏
互检变成"你写得真好"式互夸 拉回:"今天不是互夸,是互相找漏。找不出来才尴尬"
学员发现漏项后开始重写对方报告 拦住:"只记不改——他的报告他改,你的时间用来找下一个漏项"
有人借机指出"某人数据来源不合规" 立刻私下处理(走 11 §6.7 违规处置流程),不当众指控
超时(10 分钟讲成 15 分钟) 硬性:11 分钟必须切 S5。没念完的组,S6 群里补

承接语(最后 30 秒)

"报告你已经有底稿了。接下来的 10 分钟,我告诉你明天你要拿什么来换它。"

学员笔记要点

  • 反模式 Data Quality Surprises:假设数据已治理好 → 反制 = 开工先做数据体检(G3)
  • 四条高频漏项:PII 没处置 / 覆盖度没绝对量 / 结论待定 / 事实与推测混写
  • 互检三句:哪列能定位到人?分母是多少?哪些是"大概"?

S5 · 布置 G3 + 明日预告(80–90 min · 10 min)

本节定位:把今天的产出物变成一条可提交的规则(G3 四条 + 命名 + 截止 + 补交),并埋死 D4 的钩子。 这一节不许讲新知识。

一句话目标(开场念):"接下来 10 分钟全是规则——听清楚,今天不用问第二遍。"

分钟级时间盒

分钟 动作 目的
80–84 念全 G3 四条(blocker / warning 分开念) 让"过没过"可自查
84–86 命名规范 + 截止 + 补交规则 减少后台扯皮
86–89 明日预告:D4 的三个钩子 建立连续性
89–90 移交 S6 + 助教值守规则 ——

讲稿要点

① G3 四条怎么念(80–84 min)——blocker 与 warning 分开念

投屏(03 §3 G3 行原文):

① 字段清单含类型与缺失率
② PII 清单与处置建议
③ 明确结论"能做 / 不能做 / 有条件能做"
④ ≥3 条质量风险

①②③ = 🚫 blocker(硬拦)
④   = ⚠️ warning(能过,但进作品集评分)

"念法解释一下:①②③ 缺一条,你的门就是红的——不是'部分完成',是不通过。 ④ 是 warning:它不拦你,但会在 D8 评分表上扣你的分(03 §4)。 所以别问'④ 能不能少写一条'——能不能过是一回事,拿几分是另一回事。"

今天就顺手自查一次(现场 30 秒,别拖):

COLUMNS=200 fde-scope gate check <你的档案id>
#   id 从哪来:COLUMNS=200 fde-scope engage list
#   ⚠ 在 qualification 阶段,不带 --gate 时会打印
#     "Phase 'qualification' has no gate." —— 这是正常输出,不是报错

⚠️ 讲师必讲的一段(12 §3.2 / §3.5): "ticket 档案上不要手动去查工业门禁。 比如 --gate site_survey,它会回你一个 ✅ PASS—— 那是'没有可检查的数据'的空过,不是通过。别把这个 ✅ 当成证据写进作品集, 一眼就能被人看穿。判断'我该过哪几关',只认 03 §3 的 G0–G8 课程门禁。"

② 命名 + 截止 + 补交(84–86 min)

项 规则
命名 D3-姓名-数据体检报告(例:D3-张三-数据体检报告.md)
提交 群里提交(只交报告本身,不交数据文件、不交截图、不交 CSV)
截止 直播次日 21:30(运营催交时间)
补交 24 小时内补交 = 正常放行(标注"补交通过");超 24 小时 = 延期通过,作品集等级最高 B(03 §3)
红线 报告里不得出现真实客户名与 PII(含截图)——11 §6.5:截图前 3 秒检查姓名 / logo / 域名 / 工单编号

③ 明日预告(86–89 min)——三个钩子,逐条说

"明天 D4,'把矿石炼成金属'。三件事先说在前面:

第一,我会当场问你一句:'你补的那些样本,有多少是你编的?' ——不是刁难。客户一定会问这句。你答不上来,你今天就白补了。

第二,明天我要你写一段不超过 200 字的人话**,和一个'老板'讲清楚你干了什么。** 那段话里不许出现这些词:语料、覆盖度、合成数据、去重、准确率、模型、推理、向量、embedding、token。 一个都不许。12 §2.3 里有完整禁用词表——今晚可以先看一眼。

第三,明天的坏消息是:指标一定不好看。 我今天先把这话说死——指标难看是正常的,难看正是它存在的价值。"

④ 移交 S6(89–90 min)

"接下来的 45 分钟归你们。助教在群里值守——只回答两类问题:规则类,和'这条风险算不算一条'。 案例背景的标准答案和方案类问题,明天再问。"

投屏·板书

  • 左:G3 四条 + blocker / warning 标注
  • 中:命名 / 截止 / 补交 / 红线(四行表)
  • 右:明天三个钩子:① 有多少是你编的 ② 200 字人话(禁用词表)③ 指标一定不好看
  • 白板角落:停车位

互动设计

问题 期望答案 冷场备选
"④ 是 warning,那能不能不写?" 应该安静——答案是"能过,但会扣分" 直接公布:"能过,会扣分。你自己选"
"空 PASS 能不能写进作品集?" "不能"(刚讲过) 再念一遍板书:"判断该过哪几关,只认 G0–G8"

学员动作(现场)

  • 抄下 G3 四条与命名规范
  • 现场跑一次 gate check <你的 id>(感受一下"没有门"的正常输出)
  • 记下明天三个钩子(尤其禁用词表)

常见错误与纠偏

错误 纠偏
学员问"我该查哪个 gate" "课程只认 G0–G8(03 §3);工具里那 10 个是另一套,别混"
学员把报告连数据文件一起交 打回:"只交报告本身——数据文件里可能有 PII,交上来就是事故"
学员现在就想写 D4 的话术 "先别写——明天你会推翻今天写的。今天把数据收尾"
讲师念规则念到 87 分钟还没进预告 硬性:86 分钟必须进预告。预告被挤掉 = D4 的第一个钩子白埋

承接语(最后 30 秒)

"矿石今天已经摊在桌上了。明天我们点火。"

学员笔记要点

  • G3 四条:①②③ blocker(类型+缺失率 / PII 处置 / 明确结论)· ④ warning(≥3 条风险)
  • 命名 D3-姓名-数据体检报告;截止次日 21:30;超 24h 补交延期通过(封顶 B)
  • 报告不得出现真实客户名与 PII(含截图)
  • 明日三钩子:有多少是你编的 · 200 字人话(禁用词表) · 指标一定不好看

S6 · 自练(+45 min)

本节定位:不讲课,学员自己做完并提交。助教在群里值守答疑。 这一节的成功判据只有一个:提交率。 讲师课后统计,未交者次日 08:30 前私聊。

45 分钟怎么分(投屏建议)

分钟 做什么 为什么这么排
0–10 按 S4 互检的漏项改报告(PII 处置 + 事实/推测分栏) 记忆最新,改起来最快
10–20 补齐第 ⑤ 节质量风险到 ≥3 条(写足 4 条更稳) 归纳类工作,需要连续思考
20–30 写第 ⓪ 节结论(三选一 + 条件句)+ 第 ⑥ 节下一步建议 结论必须基于已改完的证据
30–38 通读 + 删掉所有"大概 / 可能 / 有待观察" 删模糊词 = 最后一次自检
38–45 自评 G3 四条 + 提交 留够提交时间,别卡在最后一分钟

三条路径(学员按自己情况选一条)

路径 适合谁 做什么
A · 完成(推荐) 所有人 用 examples/quickstart_csv/sample_tickets.csv(A 组)/ 加 alarm_corpus.jsonl(B 组)完成体检报告 → 自评 → 提交
B · 迁移 手头有真实数据的人 用你自己已脱敏并经公司同意的数据重做一份(11 §6.4 脱敏四步法:拿掉 / 替换 / 哈希 / 保真)。红线:真实客户名与 PII 不得出现在提交物里,也不得投屏
C · 加练 想多练手的人 跑 fde-scope connect --type csv --source examples/quickstart_manufacturing/station_samples.jsonl --dry-run,体会"不读数据先看计划";再对 alarm_corpus.jsonl 写一份只含第 ③④ 节的迷你体检(12 类故障的覆盖度缺口 + 工业场景的 PII 判断)

关于路径 C:只写两节(PII 与覆盖度)。 目标是把"同一套方法换一个场景"这件事练成肌肉记忆—— 工业数据里 PII entities masked: 0 不代表没有红线,只代表红线不在报警日志里。

完成标准(提交前逐条打钩)

☐ 第 ⓪ 节结论是三个词之一(能做 / 不能做 / 有条件能做),且带条件句
☐ 第 ② 节每个字段都有【类型】和【缺失率】(样本内缺失率须标注"样本内")
☐ 第 ③ 节每个 PII 都有【处置建议】(不是只写"涉及手机号")
☐ 第 ④ 节给出 Top / Bottom 的绝对条数,并指出长尾盲区
☐ 第 ⑤ 节质量风险 ≥3 条,每条都能对应到一个具体字段或类别
☐ 全文没有"待定 / 建议进一步分析 / 可能 / 大概"(除非明确写成"待客户确认")
☐ 三个预注册数字还在报告里(标注【预注册】)
☐ 命名 D3-姓名-数据体检报告

卡点急救

卡在哪 怎么救
"我不知道缺失率怎么算" 用 connect 的 nullable 列 + 样本实际空值数:样本内缺失 = 空值数 / 样本行数,表头写清"样本内(n=20)"——不要写成全量缺失率
"PII 处置建议写什么" 套四步法:拿掉(与任务无关的列)/ 替换(保持格式换内容)/ 哈希(要保留关联时)/ 保真(脱敏后仍可用)。逐条挑一个写
"我只有 2 条质量风险,凑不出 3 条" 从这五个方向找:缺失(空值/字段缺)、重复(跨月重复工单)、口径不统一(标签定义不一致)、长尾不足(覆盖度缺口)、已知局限(方言/口语化)
"结论我写不出来" 三步走:① 哪一类现在就能用?② 哪一类缺多少?③ 缺的这类要不要纳入验收范围?把 ③ 的答案写成条件句
"我的数据没有 PII,第 ③ 节写什么" 写"未检出"并写清依据:"按字段名与样本值双向检查,样本内未检出具定位性的 PII;全量需客户确认"——别写"无 PII"
"时间范围客户没给" 写成 "待客户确认" 是一个合格答案——但必须出现在第 ⑥ 节"下一步建议"里,别只写在第 ① 节

助教值守规则

  • 只回答两类问题:① 规则类(命名 / 截止 / 格式 / 工具报错)② "这条算不算一条质量风险"
  • 不回答:案例背景的"标准答案"(会破坏 D8 交叉提问)、D4 之后的实现与方案类问题
  • 每 15 分钟在群里发一次进度提示("还有 30 / 15 / 5 分钟")
  • 收到提交后只回一个字:✓(不讲评——讲评在次日 08:30 门禁榜 + D4 回炉)
  • 遇到真实客户名 / PII 出现在提交里 → 立即私聊要求撤回重交,并记录合规日志(11 §6.7)

学员动作

  • 45 分钟独立完成(路径 A / B / C 三选一)
  • 自评 G3 四条
  • 提交 → 收到 ✓
  • 在群里写 60 秒收获:「我今天猜错的那一个数字是什么?我原来以为 ___,实测 ___。」

常见错误与纠偏

错误 纠偏(助教用)
学员把体检报告写成"工具输出汇编" "工具能给的你都给了,工具给不了的你一个字没写。 处置建议、质量风险、结论——这三样才是你的报告"
学员的结论是"数据质量一般,建议进一步分析" 打回:"待定"= 未达(红线 2)。追问"你缺什么才能下结论?"→ 改成条件句
学员提交里出现真实公司名 / 手机号 / 邮箱 立即私聊 + 撤回,引用 11 §6.1 / §6.7(违规 = 数据合规事故)
学员把 seed 档案(如迅捷出行)的参考数字原样抄来 不禁止,但次日回炉会点名问:"你这份数据的 diversity_index 是多少?"——抄的人答不上来
学员只交了字段表,没交结论 打回:③ 是 blocker,缺一条就是没过(03 §3)
学员问"复现一次数字不一样怎么办" 先用同一条命令同一样本复现;不一致就写进报告"复现差异"——这是 G5(可复现)的提前预演

附 A · D3 板书总图(一天下来的白板应该长这样)

┌────────────────────────────────────────────────────────────────────┐
│  D3 · 接数据 —— 先看再装:看完必须说三句话之一                       │
├──────────────────────────────┬─────────────────────────────────────┤
│  先猜后看(三个数)           │  数据体检报告(6 节)                │
│  ① 几列会被标 PII?           │  ⓪ 结论 ★  ① 概况  ② 字段清单        │
│  ② 几条藏着真人信息?         │  ③ PII ★  ④ 覆盖度  ⑤ 风险 ≥3        │
│  ③ 几类够用(≥100/类)?      │  ⑥ 下一步建议                        │
│                              │  ★ = blocker(硬拦)                 │
├──────────────────────────────┴─────────────────────────────────────┤
│  对账结果:① 0 列   ② 2 条   ③ 0 类(20 条 vs 每类需 100 → 3%)      │
├────────────────────────────────────────────────────────────────────┤
│  两句话常驻:                                                        │
│  ▸ 不亮 ≠ 没有 PII。自由文本必须逐条看值。                           │
│  ▸ 均匀 ≠ 够用。熵只告诉你形状,不告诉你体积。                        │
│  工具的四个数:masked=2 · target_per_category=100 · diversity=0.9569 │
│                gaps=9                                                │
├────────────────────────────────────────────────────────────────────┤
│  结论三选一:能做 / 不能做 / 有条件能做("待定" = 没交)              │
│  犹豫就写条件:"若能补齐 X 则能做,否则不纳入验收范围"                 │
├────────────────────────────────────────────────────────────────────┤
│  红线三条(11 §6.1):只用虚构或已脱敏数据 · 真实名与 PII 不进群不上传 │
│                      · 不进任何第三方工具                             │
│  反模式:Data Quality Surprises(假设数据已治理好)→ 开工先做体检     │
│  三个坑:全部字段(→ 不收)· 分布很均匀(→ 反驳)· 大概是去年(→ 待办)│
├────────────────────────────────────────────────────────────────────┤
│  停车位:________________________________________(今天跑题的术语)  │
└────────────────────────────────────────────────────────────────────┘

附 B · 讲师自查(下课前 5 分钟)

  • ☐ 三条红线全守住了?有没有冒出第 4 个概念却没进停车位?
  • ☐ S1 的先猜后看预注册做了吗(群里真的刷过三个数字)?
  • ☐ S2 的对账三问逐条揭晓了吗(0 列 / 2 条 / 0 类)?
  • ☐ PII entities masked: 2 是真跑出来的,不是口头说的吧?
  • ☐ "待定 = 没交"这句至少说过 2 次吗(S2 + S5/S6)?
  • ☐ 红线三条(11 §6.1)逐条念过吗?
  • ☐ 有没有演示 gate check --gate site_survey 这个空 PASS?(不该有)
  • ☐ 南湾汽车的三条工业门禁(fat_sat / functional_safety / conformity)在 manufacturing 档案上演示的吧?
  • ☐ S3 助教的三个坑每个桌都埋到了吗?有没有一次就放行?
  • ☐ S4 互检没有被压缩掉吧?念发现时没有点到任何人名吧?
  • ☐ G3 四条、命名规范、截止时间、补交规则都念全了吗?
  • ☐ D4 三个钩子埋了吗(有多少是你编的 / 200 字人话禁用词 / 指标一定不好看)?
  • ☐ 未提交名单记下来了吗(次日 08:30 前私聊)?

下一节:19-D4逐节教案.md(造语料:把矿石炼成金属) 本日配套:02-逐日教学大纲.md Day 3(时间盒总表)· 06-学员手册与作业包.md D3 任务卡 · 07-实战剧本与案例库.md §2.2 / §2.3 / §3.2 / §4.4 · 11-工具与环境准备.md §6(数据合规与 PII 红线)· 12-附录-术语表与模板库.md §2.2(数据体检报告模板)

19 · D4 逐节教案:造语料(把矿石炼成金属)

19

course-level-1/19-D4逐节教案.md

本文件是 D4(90 分钟直播 + 45 分钟自练)的逐节执行稿:每节课讲什么、怎么说、屏幕放什么、学员做什么、卡住怎么救、下一节怎么接。 上游时间盒:02-逐日教学大纲.md Day 4|通用骨架与控场:05-讲师手册.md §2 / §4(D4 五条带教要点) 模板与术语:12-附录-术语表与模板库.md §1.6(十二反模式 · 第 4 条 Demo-Debt Spiral 的姐妹症状「数据凑数」)· §2.3(客户话术模板 + 禁用词表)· §3.5(出错速查) 演练素材:07-实战剧本与案例库.md §2.2(迅捷出行)· §2.3(南湾汽车)· §3.3(D4 语料汇报 · 老板三追问)· §4.4(车间主任角色卡)· §5(助教评分) 数据红线:11-工具与环境准备.md §6(数据合规与 PII 红线 · 不可协商)|学员侧任务卡:06-学员手册与作业包.md D4|门禁条款:03-评估体系与通关门禁.md §3 G4 行 本日演示数据:examples/quickstart_csv/sample_tickets.csv(20 条虚构工单)+ 工业补充 examples/quickstart_manufacturing/alarm_corpus.jsonl(12 条虚构报警)|演示工作目录:/tmp/fde-d4-demo(不写进仓库)


0. 今天的三条红线(全天不许破)

# 红线 怎么守
1 全天只出现 3 个新概念:质量门 · 去重与清洗 · 补盲合成 今天是术语爆炸的重灾区——"微调""蒸馏""指令集""幻觉"一律进停车位(白板角落),课后答疑再讲。"语料"这个词是内部行话,跟客户说话时它本身就在禁用词表里(12 §2.3)
2 每个数字必须能指到出处 415 / 20 / 395 / 2 / 0.96 / 9——每一个都要点得开(报告的哪一屏 / JSON 的哪一行)。指不出出处的数字 = G4 ① 不过(03 §3;12 文末三条纪律 ①)
3 合成是补盲区,不是凑数量——报总数必须真实量、合成量、比例一起报;不碰真实数据 只说"我们做了 415 条"不说"其中 395 条是补的" = 反模式数据"凑数"(02 Day 4)。真实客户名与 PII 不进群、不上传、不进任何第三方工具(11 §6.1);违规 = 数据合规事故(03 §8 一票否决项)

今天没有硬性休息:D4 直播同样只有 90 分钟,中间不设休息点。 但 **S2 的数字对账(0 → 415 → 395)**是全天的天然停顿点——三个数对完,喝口水,再往 JSON 里钻。

为什么今天这么"险":D3 你只看了矿石,今天你要动手炼金属——炼的过程会制造新数字,而新数字最容易失控。 今天全天只有一个动作:把 20 条变成 415 条,然后老实交代每一部分是从哪来的。 宁可少讲一种合成手法,也要保证每个学员手里有一份自己跑出来、自己讲得清的报告。

今日 6 节课总览

节 时间 一句话目标 学员产出 记忆锚点
S1 回炉 0–10 min G3 讲评(1 优 1 劣)+ 全班"先猜后看"预注册 写下三个猜测数字 "先猜,再看;猜错的地方就是学到的地方"
S2 讲与演 10–35 min 跑 corpus,把 20 条炼成 415 条;逐屏对账、逐条溯源 观察笔记 "合成是补盲区,不是凑数量"
S3 上手 35–70 min 亲手跑出报告 + 写 200 字客户话术(助教扮演老板三追问) 🎯 产出 4 草稿 "每个数字都要能指到出处"
S4 复盘 70–80 min 三人一组互当老板,抓禁用词 修订清单 "你嘴里冒一个术语,老板心里就塌一块"
S5 布置 80–90 min 收 G4 + 明日钩子 提交清单 "明天的指标一定不好看——难看正是它的价值"
S6 自练 +45 min 独立完成、自评、提交 🎯 产出 4 提交 门禁自查 4 条

今日产出物(🎯 产出 4):两份东西—— ① 语料报告(corpus 跑出来的 HTML + 从里面摘出来的"数字链"一页):原始 N → 可用 M(去重淘汰 X、质量门淘汰 Y)→ 合成补充量 → 切分 332 / 41 / 42,每个数字带出处。 ② 客户话术 ≤200 字:向非技术客户说明"能用多少 / 补了什么 / 为什么可信"(12 §2.3 三句骨架,逐词避开禁用词表 10 词)。 通关门禁 G4 原文(03 §3): ① 报告数字与实际运行一致 ② 有覆盖盲区说明与补盲策略 ③ 客户话术 ≤200 字且零术语 ④ 合成数据比例如实标注 —— ①②③ blocker;④ warning。 ⚠ 注意 ④ 只是 warning:它不拦你,但会进作品集评分。真正会把你拦在门外的是 ①——抄来的数字(12 §2.3 里那组 32,400 / 21,800 是模板占位,照抄 = ① 不过)。


S1 · 回炉(0–10 min · 10 min)

本节定位:10 分钟干三件事——交出 D3 的账(门禁榜 + 1 优 1 劣),然后用一次全班预注册把今天的认知冲突提前埋好。不讲课,只讲评 + 提问。

一句话目标(开场念):"昨天你们先猜后看,三个数字全猜错。今天我想看看——你们从昨天的错误里学到了什么没有。"

分钟级时间盒

分钟 动作 目的
0–3 G3 门禁榜(3 个数字)+ 补交规则复述 让"过没过"变成公开事实
3–8 1 优 1 劣讲评(都不点名) 让"好长什么样"可复制,让"坑"提前暴露
8–10 先猜后看预注册:群里打 3 个数字 制造今天上午的认知冲突

讲稿要点

① G3 门禁榜(0–3 min)——只念三个数字

投屏一张表,不要念名单(念名字会把讲评变成社死现场):

指标 数字(讲师课前填) 念法
提交率 __ / __ "今天有 N 位同学没有交——不是骂人,是提醒:门禁是逐关的,缺一关后面全堵"
G3 一次通过率 __% "被拦最多的那一条,今天要拿出来当反面教材——不是因为你蠢,是因为那是最容易犯的错"
被拦最多的 blocker 通常是 ③ 明确结论(写了"待定") "第二名是 ② PII 清单只写'涉及手机号',没写处置建议——清单看的是处置,不是发现"

⚠️ 讲师注意:补交规则要在这一分钟念完整——24 小时内补交 = 正常放行(标注"补交通过");超过 24 小时 = 延期通过,作品集等级最高 B(03 §3)。D3 已有未交者,今天再念一遍,不针对个人。

② 1 优 1 劣讲评(3–8 min)——两份都匿名,都念原文

优的那份(从提交中挑,隐去姓名与公司名),念完立刻指认三个动作——不要只说"写得好":

"第一,结论是条件句:'若能补齐 9 类中任意 5 类的样本量,则先做这 5 类的意图识别,其余不纳入本期验收范围。'——注意,它把'能不能做'变成了'有条件能做'。 第二,PII 那条写了处置:'正文里的手机号 → 替换(保持 11 位格式)'——不是只写'发现手机号'。 第三,质量风险里有一条是长尾:'售后补发类只有 1 条,任何以该类为分母的指标都不可信。' 这三条,就是 G3 的 ②③④。你们抄的不是这份文档,是这三条的动作。"

劣的那份(典型错误,同样匿名),念完把错误落到门禁条款上:

"这份的结论写着'数据质量一般,建议尽快启动数据治理'。 我不骂它。我只问一句:"尽快"是哪天? 明天你要跟客户说'能用多少'的时候,"尽快"能换成哪个数字?——一个字都换不了。 ③ 是 blocker,这份的门是红的。"

⚠️ 讲师注意:1 优 1 劣的两种错法必须是当天最高频的两种(见 09 的作业抽样)。不要挑"离谱的错"逗笑全场——要挑"大多数人都犯的错",才有纠偏价值。

③ 先猜后看预注册(8–10 min)——今天最容易翻车的一分钟

投屏这三个问题,让全体在群里打数字(不是打"是/否"):

① 昨天的 20 条里,今天会被清洗淘汰掉几条?              猜:__ 条
② 今天这份"语料"最终会有多少条?(20 条 + 补出来的)      猜:__ 条
③ 最终的这份里,有多少条是"模拟出来的"(不是原始采集的)?   猜:__ 条

不许现在解释。 让学员猜完、群里刷完屏,你再收口:

"记住你打的那三个数。25 分钟后我们一条条对。 昨天你们猜了三个数,全错了。今天你们学乖了——所以今天,你们会错得更离谱。"

因为昨天你只是在'看',今天你要亲手'造'。看的人和造的人,对数量的直觉完全是两码事。

投屏·板书

  • 左:G3 门禁榜(三个数字,不出现人名)
  • 中:优的那份的三个动作(条件句结论 / 处置写明 / 长尾不可信)
  • 右:三个猜测问题(群里刷数字,投屏只留问题)
  • 白板角落:停车位(今天所有跑题术语记这里)

互动设计

问题 期望答案 冷场备选
"估淘汰几条?" 各种数字都有(0 / 3 / 5) 直接点名两个学员报数,不解释
"415 会不会太多?" 没人敢答 "没关系——我也不会现在告诉你"

常见错误与纠偏

错误 纠偏
有人追问"是不是 0 条被淘汰"就急着公布 不公布。预注册的价值就在"没看到答案之前"——公布了,后面的对账就没了力道
讲评拖到 8 分钟以上还没进预注册 硬停:8 分钟一到,直接切预注册(05 §2 控场)

承接语(最后 30 秒)

"现在,把 corpus 这条命令敲下去。你们猜的三个数,马上就要见分晓。"

学员笔记要点

  • 三个预注册数字(要留着——S2 对账时用,报告里也要标【预注册】)
  • 优的那份的三个动作:条件句结论 / 处置写明 / 长尾不可信

S2 · 讲与演(10–35 min · 25 min)

本节定位:全场唯一一次"讲师当主角"。把 corpus 从一条命令跑成一条可对账的数字链,每个数字都由学员手里的预注册来对照。不追功能全貌,只追一件事:每个数字你能不能指到出处。

一句话目标(开场念):"今天不看代码。今天只做一件事——把这台机器吐出来的每一个数字,都当场点开。"

分钟级时间盒

分钟 动作 对账哪一问
10–13 跑 corpus,逐行读控制台 6 行 对账 ①②③
13–18 投屏报告 4 屏(KPI / 覆盖度 / 合成补盲 / 数据分割) 讲"数字链闭环"
18–22 翻 corpus_report.json,看每条 trace:谁被洗过、谁被补的、怎么补的 讲"来源可查"
22–28 LLM 两幕演示:无 key 硬报错 → 连不上自动回退(报告逐字节相同) 讲"降级是设计"
28–33 收口:数字链 + 三道闸 + 工业对照 + "test 里 0 条真实的" 埋 D5
33–35 钩子 + 禁用词表上墙 埋 S3

⚠️ 今天的主角只有一条命令:corpus。--llm 是配角(22–28 分钟亮相一次),gate 只在 S5 露一次脸。 任何时刻有人问"能不能改成……"→ 一律"停车位,S6 或课后讲"。

讲稿要点

① 10–13 min|跑 corpus:逐行读控制台

fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --out /tmp/fde-d4-demo/corpus_report.html

投屏控制台,逐行念(终端里会折行,内容以这里为准):

🔄 Loaded 20 raw rows
✅ PII entities masked: 2
✅ Dropped (dedup+gate): 0
✅ Corpus forged: 20 real + 395 synthetic = 415 total
⚠ Coverage gaps:   • 物流查询: 3 (need ≥100)……
📊 Report → /tmp/fde-d4-demo/corpus_report.html (+ /tmp/fde-d4-demo/corpus_report.json)
行 逐字念 含义
Loaded 20 raw rows "进去 20 条" 原始矿石(就是 D3 那 20 条虚构工单)
PII entities masked: 2 "清洗阶段遮了 2 个——就是昨天你亲手找出来的那 2 条" 昨天的账,今天兑现
Dropped (dedup+gate): 0 "淘汰 0 条" 对账 ① 揭晓
20 real + 395 synthetic = 415 total "出来 415 条:20 条原始,395 条是补的" 对账 ②③ 揭晓
Coverage gaps: 9 行 "9 个类别全都不够——这是坏消息,也是明天的主角" 留到 D5
Report → … "报告落在 /tmp——不写进仓库" 工作目录纪律

对账 ① 揭晓:

"答案是 0 条。猜 3 条、猜 5 条的举手。 为什么一条都没淘汰?因为这份数据是'干净'的——20 条没有实质重复、没有低于质量门 3.0 分的。 注意我刚才那句话:"这份数据是干净的"。这句话在真实项目里,十次有九次是错的。 淘汰 0 条在我们课里是设计(给你的数据是好的);在客户现场,淘汰率才是你第一个要看的数字——它告诉你客户的数据有多脏。"

对账 ②③ 揭晓:

"答案是 415,其中 395 条是补的。 猜 30、猜 60 的——现在知道自己错在哪了吗?你们以为'补'是把缺的补一点。 不是。这台机器的逻辑是:哪一类不够 100 条,就往 100 条补。"

② 13–18 min|投屏报告 4 屏:每个数字都有出处

第 1 屏 · KPI 横排(8 个格子,逐字念数字):

总量 真实样本 合成样本 已剔除 PII 脱敏数 覆盖类别 多样性指数 缺口数
415 20 395 0 2 9 0.96 9

"这 8 个数字就是你的报告封面。今天只需要记住一个关系: 20 是真实,415 是总量。真实占比 = 20 ÷ 415 ≈ 4.8%。 这个数不好看。但它必须由你主动说出来——你不说,等客户问出来的时候,你说的每一句话都要打折。"

第 2 屏 · 覆盖度分析——9 行,每一行都是 ⚠ 缺口(物流查询 3 / 退款 3 / 账号问题 3 / 退换货 3 / 支付问题 3 / 订单修改 2 / 会员咨询 1 / 发票咨询 1 / 售后补发 1)。

第 3 屏 · 合成补盲——注意第三列:

缺口类别(示例) 现有 目标 缺口大小
物流查询 3 100 +97
订单修改 2 100 +98
会员咨询 1 100 +99

"看清楚第三列。 它写的是缺口有多大(+97、+98、+99),不是补了多少。 实际补进去的是 395 条;而这 9 行加起来是 883 条——补不满。 为什么补不满?两个机制:补的手法有上限(每类最多补 50 条),而且像"换说法""加情绪"这类变形补出来的会互相撞车,被去重(阈值 0.92)掉。 这是全场最容易吹牛的地方:'我们补了 883 条'——假的。+97 是缺口,不是补入量。"

第 4 屏 · 数据分割:train 332 / eval 41 / test 42 / golden 0。

"这里我要说今天最诚实的一句话:test 那 42 条里,真实样本是 0 条。 意思是:你不能说"这个语料在真实数据上验证过"。你能说的是—— 切分比例是 8:1:1,train / eval / test 各多少条,都写在报告里。 真实数据上的验证,是明天(D5)的事。今天谁说"验证过了",谁就是没看报告。"

顺手补一枪"均匀 ≠ 够用"的工业版(投屏工业数据):

fde-scope corpus --input examples/quickstart_manufacturing/alarm_corpus.jsonl --out /tmp/fde-d4-demo/alarm.html
# → Loaded 12 raw rows … 12 real + 560 synthetic = 572 total,12 个缺口各 1 (need ≥100)

"这份工业数据的多样性指数是 1.0,满分。为什么满分?因为它12 个类别每类正好 1 条——均匀到极致,也贫瘠到极致。 这就是"均匀 ≠ 够用"的升级版:指数告诉你形状,不告诉你体积。"

③ 18–22 min|翻 JSON:每条都能溯源

ls -l /tmp/fde-d4-demo/
# corpus_report.html   ← 给人看的
# corpus_report.json   ← 给机器和审计看的(文件名固定,见下方提示)

python3 -c "import json;d=json.load(open('/tmp/fde-d4-demo/corpus_report.json'));print(sorted(d.keys()))"
# ['coverage', 'dropped', 'eval', 'golden', 'pii_entities_masked', 'real', 'synthetic', 'test', 'total', 'train']

先看点名的两条真实样本(provenance 是 real)——指出 PII 脱敏后的样子:

{"id":"t-007","content":"已经申请退款一周了还没到账我的手机是[REDACTED](PHONE)","category":"退款","channel":"phone","quality_score":5.0,"provenance":"real","trace":["normalize","pii_scrub","dedup","quality_gate"]}
{"id":"t-004","content":"商品破损要求换货联系邮箱 [REDACTED](EMAIL)","category":"退换货","channel":"email","quality_score":4.0,"provenance":"real","trace":["normalize","pii_scrub","dedup","quality_gate"]}

"trace 是这条数据的加工履历:规范化 → 脱敏 → 去重 → 质量门。 昨天你在报告里写"手机号 → 替换",今天它长这样:REDACTED。昨天的承诺,今天兑现了。"

再看四条合成样本(provenance 是 synthetic)——并让学员念出 trace:

id content trace
syn-售后补发-0006 URGENT: 商品缺件少发了配件麻烦补发 ["synthesize:adversarial"]
syn-售后补发-0011 商品缺件少发了配件麻烦补发 太糟糕了。 ["synthesize:emotion_escalation"]
syn-物流查询-0008 (上次回复没有解决)我的订单三天了还没发货麻烦帮我查一下物流谢谢 还是同样的问题。 ["synthesize:multi_turn"]
syn-会员咨询-0005 客服你好,咨询一下会员权益有哪些等您回复。 ["synthesize:paraphrase"]

"四条,四种手法:加对抗前缀(URGENT:)、加情绪(太糟糕了。)、加多轮上下文((上次回复没有解决)…还是同样的问题。)、换说法。 还注意一件事:合成样本的 id 里带着它是替哪个类别补的——syn-售后补发-* 就是为"售后补发"补的。 G4 ② 要的"补盲策略",每条都能这样答出来:它为什么存在?因为售后补发只有 1 条。"

全量 trace 计数(投屏,逐行念):

动作 次数 说明
normalize / dedup / quality_gate 各 20 每条真实样本都过一次
pii_scrub 2 只有 2 条身上有 PII
synthesize:paraphrase 271 换说法
synthesize:emotion_escalation 59 加情绪
synthesize:adversarial 45 加对抗前缀
synthesize:multi_turn 20 多轮上下文包裹

"271 + 59 + 45 + 20 = 395。四种补法加起来,正好等于合成总量。这就是数字链闭合的样子。"

类别分布也念一遍:

补满(封顶 50) 没补满
支付问题 / 订单修改 / 账号问题 / 物流查询 / 退换货 / 退款:各 50 售后补发 42 · 会员咨询 29 · 发票咨询 24

"为什么后三类补不满 50?它们的补法基于真实种子做变形,变形出来的会撞车——被去重(阈值 0.92)撞掉的就没了。 所以"补盲"不是"想要多少要多少"。这句话是明天的伏笔。"

④ 22–28 min|LLM 两幕演示:降级是设计,不是事故

第一幕 · 没有 key → 当场拒绝,不产报告

fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --llm --out /tmp/fde-d4-demo/llm_nokey.html
LLM not configured: set FDE_SCOPE_MIMO_API_KEY (Xiaomi MiMo Token Plan, tp-… format)
or FDE_SCOPE_LLM_BASE_URL+FDE_SCOPE_LLM_API_KEY (OpenAI-compatible) to enable LLM mode.

(退出码 2,一个报告都不落盘。)

"注意:没有 key 不是'偷偷降级',是'当场拒绝'。 工具宁可什么都不给你,也不给你一份"你以为跑了模型"的报告。"

第二幕 · 有 key 但连不上 → 自动回退,报告照出

FDE_SCOPE_MIMO_API_KEY=tp-fake-key-for-demo FDE_SCOPE_LLM_BASE_URL=http://127.0.0.1:9 \
  fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --llm --out /tmp/fde-d4-demo/llm_fallback.html

shasum -a 256 /tmp/fde-d4-demo/corpus_report.html /tmp/fde-d4-demo/llm_fallback.html
# 两个文件的 sha256 完全相同(effd056d…)
grep -c "synthesize:llm" /tmp/fde-d4-demo/llm_fallback.html
# 0

"两幕合起来一句话: 有 key 且能用 → trace 里出现 synthesize:llm;没 key → 拒绝开工;有 key 但连不上 → 自动回退到规则路径,报告和第一幕之前一模一样(哈希都相同)。 这就是 12 §3.5 里那句'网络错误但流程继续 = LLM 自动降级到规则路径(设计如此)'的现场版。"

⚠️ 两条现场纪律,现在说死: ① 演示里的 tp-fake-key-for-demo 是一眼假的占位;真实 key 永远不投屏(11 §6.6)。 ② corpus_report.json 是固定文件名,落在 --out 的目录里——刚才两次跑,JSON 是互相覆盖的。要两份都留,就把 --out 指到两个目录,或跑完立刻 cp 走。

⑤ 28–33 min|收口:一条数字链,三道闸

数字链(投屏,全天常驻):

20(原始)→ 淘汰 0(去重+质量门)→ 20 real → + 395 模拟 → 415 总量 → 切分 332 / 41 / 42
真实占比 ≈ 4.8% | 模拟占比 ≈ 95.2% | PII 脱敏 2 | 缺口 9 | 多样性 0.96

三道闸(出处:fde_scope/templates/corpus_config.yaml):

闸 值 作用
去重 阈值 0.92 相似度超过就合并——变形类补法的产出会被它碰掉
质量门 真实 ≥ 3.0 / 合成 ≥ 3.5 不过线就淘汰(今天淘汰 0 条)
目标线 每类 100(min_samples_per_category) 不是闸,是目标线——是我们设的,可以调

""每类 100"不是行业标准,是我们设的线。 为什么是 100?因为它是"能撑住一次小规模评测"的量级。 它可以是 30,也可以是 300——但改了它,必须重跑、重报。不许只改嘴上说的数字。"

⑥ 33–35 min|埋 S3 钩子 + 禁用词表上墙

投屏,全天常驻(12 §2.3 禁用词表):**

对客户说话时,一个都不许出现:
语料 · 覆盖度 · 合成数据 · 去重 · 准确率(裸用)· 模型 · 推理 · 向量 · embedding · token

"接下来 35 分钟,你们自己跑、自己写。先跑,再写字。"

投屏·板书

  • 左:数字链(20 → 0 → 20 → +395 → 415 → 332/41/42)
  • 中:三道闸(去重 0.92 / 质量门 3.0·3.5 / 目标线 100 可调)
  • 右:禁用词表 10 词
  • 白板角落:停车位

演示脚本(可直接复制执行)

# 0) 工作目录(不写进仓库)
rm -rf /tmp/fde-d4-demo && mkdir -p /tmp/fde-d4-demo

# 1) 先看:干跑(不落盘,只告诉你会用什么输入、什么配置)
fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --dry-run
#    DRY-RUN would forge input=examples/quickstart_csv/sample_tickets.csv config=fde_scope/templates/corpus_config.yaml

# 2) 正式跑(规则路径)——记住控制台六行
fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --out /tmp/fde-d4-demo/corpus_report.html

# 3) 对账:把 JSON 里最关键的三组数取出来
python3 -c "import json;d=json.load(open('/tmp/fde-d4-demo/corpus_report.json'));print({k:d[k] for k in ('total','real','synthetic','pii_entities_masked','dropped')});print(d['coverage']['target_per_category'], len(d['coverage']['gaps']))"
#    {'total': 415, 'real': 20, 'synthetic': 395, 'pii_entities_masked': 2, 'dropped': 0}
#    100 9

# 4) 第一幕:没有 key → 硬报错,不产报告
fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --llm --out /tmp/fde-d4-demo/llm_nokey.html

# 5) 第二幕:假 key + 死端点 → 自动回退,报告与规则路径逐字节相同
FDE_SCOPE_MIMO_API_KEY=tp-fake-key-for-demo FDE_SCOPE_LLM_BASE_URL=http://127.0.0.1:9 \
  fde-scope corpus --input examples/quickstart_csv/sample_tickets.csv --llm --out /tmp/fde-d4-demo/llm_fallback.html
shasum -a 256 /tmp/fde-d4-demo/corpus_report.html /tmp/fde-d4-demo/llm_fallback.html   # 两个哈希相同
grep -c "synthesize:llm" /tmp/fde-d4-demo/llm_fallback.html                            # 0

# 6) 工业对照(12 条虚构报警,12 个类别)
fde-scope corpus --input examples/quickstart_manufacturing/alarm_corpus.jsonl --out /tmp/fde-d4-demo/alarm.html

⚠️ 两个必须当场说清的点: ① corpus_report.json 文件名固定,落在 --out 的目录里——第 2、5、6 步会连续覆盖它。要留住某一次,就换 --out 目录,或跑完先 cp 走。 ② 演示用的 tp-fake-key-for-demo 是一眼假的占位;真实 key 绝不投屏、绝不进课件、绝不进任何截图(11 §6.6)。

演示事故预案

学员问 现场处理
"415 就是数据量吗?" 反问:"这 415 条拿去做产品,出错了找谁?"——415 是可用语料量,20 才是你的数据底数。两个数永远一起报(红线 3)
"395 条是 AI 生成的吗?" 分层答:今天的规则路径不是模型生成的(是换说法/加前缀/加情绪的规则);只有 trace 里出现 synthesize:llm 的才是。今天这份报告里 synthesize:llm = 0
"刚才两次跑,JSON 是不是被覆盖了?" 承认,并给命令:换 --out 目录,或跑完 cp 走(12 §3.5)
"要不要现场填个真 key 试试?" 不。 真实 key 不进演示环境;要试 LLM 到课后个人环境(11 §6.6)
"多样性指数怎么算的?" 停车位。今天只要知道两个端点:1.0 = 每类一样多;越接近 0 = 越集中。算法细节课后讲
"有人想拿真实工单来跑" 拦住:真实数据先脱敏、且经公司同意,且不得投屏、不得发群(11 §6.1)

互动设计

环节 讲师动作 目的
对账 每揭晓一个数,先让猜对的人举手,再解释为什么 用"猜错"制造记忆点
溯源 随机点一个学员:"415 这个数,你在报告哪一屏能看到?" 逼出"指到出处"的习惯
两幕 第二幕跑完,让学员自己念出"两个哈希相同" 让"降级是设计"由学员说出口

学员动作(现场)

  • 在笔记上抄下数字链(20 → 0 → 20 → +395 → 415 → 332/41/42)
  • 打开 /tmp/fde-d4-demo/corpus_report.html,亲手点开 4 屏
  • 记下三个预注册数字的对错

常见错误与纠偏

错误 纠偏
学员把 Dropped: 0 理解成"数据没问题" 纠正:"给你的数据是干净的"是课程设计。真实项目里,先看淘汰率
学员以为 +97 是补入量 立刻纠偏:+97 是缺口。补入量看 synthetic 总数与 trace 计数
学员以为 415 全都能用 补一句:test 里 0 条真实、9 类全有缺口——415 是"补过的话",不是"够用的话"
学员问"为什么每类 100" 目标线、可调(配置在 fde_scope/templates/corpus_config.yaml)——改了要重跑重报
有人想抄 12 §2.3 的样板数字 拦住:32,400 / 21,800 是模板占位。你的数是 20 / 415 / 395

承接语(最后 30 秒)

"现在轮到你们了。35 分钟后我要看到两份东西:一份自己跑出来的报告,和一段 200 字以内、一个术语都不许有的人话。"

学员笔记要点

  • 数字链 + 三道闸 + 禁用词表 10 词
  • corpus_report.json 文件名固定、落在 --out 目录(会被覆盖)
  • 降级三种形态:没 key 拒绝开工 / 有 key 但连不上 → 规则路径 / 正常 → synthesize:llm

S3 · 上手(35–70 min · 35 min)

本节定位:学员第一次独立完成"锻造 + 汇报"全流程。讲师退到助教位,助教进入"扮演模式"——这一次的角色是老板(07 §3.3)。

一句话目标(开场念):"35 分钟,两件事:跑出来,然后说人话。"

分钟级时间盒(学员视角)

分钟 动作 交付到哪一步
0–5 再猜一次三个数(预注册写进交付页顶部,标【预注册】) 预注册 2.0
5–12 --dry-run → 正式跑 → 抄控制台六行 数字链底稿
12–22 读报告 4 屏,填数字链表(每个数 + 出处) 数字链表(G4 ①)
22–30 写 ≤200 字客户话术(三句骨架) 话术草稿(G4 ③)
30–35 自查 G4 四条 + 命名 + 准备提交 ——

讲稿要点

① 0–5 min|再猜一次

"上一轮是全班一起猜。这一轮你自己猜——把你自己的三个数写在交付页顶部(标【预注册】)。 猜完再跑。猜错的地方,就是你今天真正学到的地方。"

② 5–12 min|跑:先 --dry-run,再正式跑

  • 命令里的三个部分各自认领:--input(你的数据)--out(报告落哪)--config(今天用默认,路径 B/C 才动)
  • 把控制台六行抄进笔记——S6 的报告里要引用它们(G4 ① 的出处)

③ 12–22 min|读 4 屏,填数字链表

让学员自己填这张表——这就是 G4 ① 的底稿:

数字 值 出处(哪一屏 / 哪个文件)
原始行数 20 控制台 Loaded 20 raw rows
淘汰 0 控制台 Dropped (dedup+gate): 0
真实 20 报告 KPI「真实样本」;JSON real
合成 395 报告 KPI「合成样本」;JSON synthetic
总量 415 报告 KPI「总量」;JSON total
合成手法分解 paraphrase 271 / emotion 59 / adversarial 45 / multi_turn 20 JSON 各条的 trace
切分 332 / 41 / 42 报告「数据分割」屏
缺口 9(含 +97…+99) 报告「覆盖度分析」「合成补盲」两屏
PII 2 控制台 + KPI「PII 脱敏数」

"填不满这张表,就不要开始写话术。数字链是先有表,后有话。"

④ 22–30 min|写话术:三句骨架(12 §2.3)

① 能用多少 —— "你们的 20 条真实工单,加上我们补的部分,一共 415 条可以用来做练习。"
② 补了什么 —— "补的 395 条,是照着你们的真实工单改出来的:换说法、加情绪、加上下文——
              每条都能查到它是从哪一条改来的、怎么改的。"
③ 为什么可信 —— "这 415 条里,哪几类够用、哪几类还差多少,我们都写进了报告;
                9 类目前都还没到我们定的 100 条目标线,差的部分我们也如实标了。"

讲师逐句拆解给学员听:

"① 是真实量与总量一起报(红线 3);② 是补盲策略的人话版(G4 ②);③ 是把"不好看"主动说出来——主动说,叫诚实;被问出来,叫隐瞒。"

三条纪律,现在重申(12 文末): ① 每个数字能在作品集里指到出处;② 没跑过的数字不写;③ "演示/虚构案例"标注不许删。 另外——不许抄 12 §2.3 示例里的 32,400 / 21,800,那是模板占位。抄它 = G4 ① 不过。"

⑤ 30–35 min|自查 G4 + 助教巡场三趟

趟 时间 盯什么 说什么
第 1 趟 ~8 min 命令跑没跑起来 只回答报错,不代替敲命令
第 2 趟 ~20 min 数字链有没有出处 抽查一句:"395 这个数,你在哪一屏看到的?"
第 3 趟 ~28 min 老板三追问(07 §3.3) 原话照念,见下

老板三追问(07 §3.3 原话,助教照念):

1. "你说的'能用多少',从头到尾是哪几个数字?"
2. "补的那些样本,是你编的吗?"
3. "我一个字没听懂,重讲一遍,说人话。"

助教扮演纪律(三条):

  • 追问 2 必须真问、不提示数字——只追问一句:"哪个数你指得出来?"(考诚实标注与合成比例)
  • 追问 3 之后加一句收尾追问:"这 415 条,什么时候能用?"——考条件句
  • 判定标准照 07 观察点:重讲一遍仍不崩,才算真懂

投屏·板书

  • 左:数字链表(空表,等学员自己填)
  • 中:三句骨架:① 能用多少 ② 补了什么 ③ 为什么可信
  • 右:禁用词表 10 词(常驻)
  • 白板角落:停车位

互动设计

环节 讲师动作 目的
巡场 助教只问不答:"这个数你从哪看到的?" 逼学员自己指到出处
角色 助教站起来演老板,姿态照 07 §4.4 制造现场压力
计时 22 分钟必须切话术,30 分钟必须切自查 保节奏

学员动作(现场)

  • 跑 corpus(用课程虚构数据),抄六行控制台
  • 填数字链表(每个数带出处)
  • 写 ≤200 字话术
  • 接受助教"老板三追问"至少一轮

常见错误与纠偏

错误 纠偏
学员跳过 --dry-run 直接跑 无伤大雅,但要求补记一句"我改了哪个输入"
学员把数字抄错(415 写成 451) 一句话:"数字对不上,G4 ① 就是红的"——回报告核对
话术里出现禁用词 递给对方禁用词表,让他自己划掉重写(比讲师划有效)
学员说"这 415 条都够用了" 追问:"9 类里几类够了?"——答不上来说明没看覆盖度
学员问"能不能不报合成比例" 引用 G4 ④ + 12 三条纪律 ③:"标注不许删"

承接语(最后 30 秒)

"停。保存你的两份东西。接下来 10 分钟,我们把你们写的话术,扔给'老板'。"

学员笔记要点

  • 数字链表(含出处列)
  • 三句骨架
  • 老板三追问的应对:每个回答后面都能追一句"这个数在报告里"

S4 · 复盘(70–80 min · 10 min)

本节定位:把"说人话"从个人任务变成集体肌肉记忆——三人一组互当老板,见一个术语举一次手。

一句话目标(开场念):"接下来你说,我们听。听到一个禁用词,举起一根手指——不用打断,我看得见。"

分钟级时间盒

分钟 动作 目的
70–76 三人一组:1 人念话术,2 人当老板(听术语、追问数字) 全员动嘴
76–79 抽 2 组念"抓到的词 + 替换说法" 把错误变成公共资产
79–80 命名反模式 + 收口 钉住概念

讲稿要点

① 70–76 min|三人一组

  • 每组 3 人:1 人念话术,2 人听
  • 听的人两个任务:① 听到禁用词举手 ② 抓住一个数字追问"哪来的"
  • 交换到 3 人都念过一遍(每人 2 分钟,正好)

② 76–79 min|念"抓到的词 + 替换说法"

抽 2 组,只念词和替换,不点评人:

抓到的词 现场替换示例
合成数据占比 95% "这里面 395 条,是我们照着你们的真实记录补出来的"
覆盖度不够 "9 类问题里,现在没有一类达到我们定的练习量"
去重 "几乎一样的重复记录,我们只留了一条"
准确率 "准不准,不是我们说了算,是你们的数据说了算——怎么验,报告里写了"(这是 D5 的事,今天别下结论)

③ 79–80 min|命名反模式

"今天有一个反模式,全班必须记住它:数据"凑数"——用合成量掩盖真实缺口。 它是 12 §1.6 第 4 条 Demo-Debt Spiral 的姐妹症状:一个是不敢碰真数据,一个是用假数据撑场面。 反制只有一句话:报总数的时候,真实量和合成量必须一起出现。"

四条高频漏项(投屏):

  1. 只说总量、不说比例
  2. 数字链缺环(说不清 395 怎么来的)
  3. 裸用"准确率"(没有分母)
  4. 覆盖度只有形容词("基本覆盖"——没有数字)

投屏·板书

  • 左:抓到的词 + 替换说法(现场写成两列)
  • 中:反模式 数据"凑数" → 真实量 + 合成量 + 比例,三个一起报
  • 右:四条高频漏项
  • 白板角落:停车位

互动设计

环节 讲师动作 目的
举手 规定"举手指、不打断" 让抓词不伤人
抽组 只抽 2 组(超了必拖堂) 保节奏
提问 念完反模式问一句:"谁今天被自己写的 95% 吓到过?" 用笑声收尾,把概念钉住

学员动作(现场)

  • 互当老板 + 举手抓词
  • 记下别人抓到的词
  • 抄下反模式名与四条高频漏项

常见错误与纠偏

错误 纠偏
互检变成"你写得真好"式互夸 拉回:"今天不是互夸,是互相抓词。抓不出来才尴尬。"
有人嘲笑别人冒了术语 制止:"冒词很正常——你今天划掉几个,就是赚了几个。"
超时(10 分钟讲成 15 分钟) 硬性:79 分钟必须收口。没念完的组,S6 群里补

承接语(最后 30 秒)

"话术你磨过了。现在,我说说明天拿什么来换它。"

学员笔记要点

  • 反模式 数据"凑数" → 真实量 + 合成量 + 比例,三个一起报
  • 四条高频漏项

S5 · 布置 G4 + 明日预告(80–90 min · 10 min)

本节定位:把今天的产出物变成可提交的规则(G4 四条 + 命名 + 截止 + 补交),并埋死 D5 的钩子。这一节不许讲新知识。

一句话目标(开场念):"10 分钟全是规则——听清楚,今天不用问第二遍。"

分钟级时间盒

分钟 动作 目的
80–84 念全 G4 四条(blocker / warning 分开念)+ 工具里没有"语料门" 让"过没过"可自查
84–86 命名 + 截止 + 补交 + 红线 减少后台扯皮
86–89 明日预告:D5 三个钩子 建立连续性
89–90 移交 S6 + 助教值守规则 ——

讲稿要点

① G4 四条怎么念(80–84 min)——blocker 与 warning 分开念

投屏(03 §3 G4 行原文):

① 报告数字与实际运行一致
② 有覆盖盲区说明与补盲策略
③ 客户话术 ≤200 字且零术语
④ 合成数据比例如实标注

①②③ = 🚫 blocker(硬拦)
④   = ⚠️ warning(能过,但进作品集评分)

"念法解释一下:①②③ 缺一条,门就是红的。 ① 最容易翻车——别抄样板数字(12 §2.3 里的 32,400 / 21,800 是模板,你的数是 20 / 415 / 395)。 ② 别写"基本覆盖"——9 个缺口、+97…+99、用了哪几种补法,写出来。 ③ 超 1 个字也算超——200 字是红线,先删形容词,再删术语。 ④ 是 warning:它不拦你,但会在 D8 评分表上扣分(03 §4)。"

顺手确认一件事:工具里没有"语料门"(现场只演示一次):

fde-scope gate check <你的档案id> --gate corpus
#   →  KeyError: "Unknown gate: 'corpus'"

"别敲。 工具的门禁只有 gate list 里那 10 个(都是 D3 见过的场地/合规类)。 G4 是人工判的——由我、助教和 D8 评委按上面四条判。 谁把 --gate corpus 的报错当成'我失败了',那是自己吓自己。"

② 命名 + 截止 + 补交 + 红线(84–86 min)

项 规则
命名 D4-姓名-语料报告 / D4-姓名-客户话术(两个文件)
提交 群里提交——只交报告与话术;不交数据文件、不交 corpus_report.json(JSON 是语料本体,不对外)
截止 直播次日 21:30(运营催交时间)
补交 24 小时内补交 = 正常放行(标注"补交通过");超 24 小时 = 延期通过,作品集等级最高 B(03 §3)
红线 报告/话术里不得出现真实客户名与 PII;不得贴真实 key(11 §6.4 / §6.6)

③ 明日预告(86–89 min)——三个钩子,逐条说

"明天 D5,'用证据说话'。三件事先说在前面:

第一,今天的坏消息明天会变得更难看。 你补了 395 条,明天一验,指标一定不好看—— 难看是正常的,难看正是它存在的价值(05 §4 D4 第 5 条)。

第二,明天每人都会跑一次评估——先做一个小动作:把你的测试集里那 42 条先看一眼(12 §2.4)。 如果里面有 expected_category,先删掉,或者改用 --agent mimo。不删的话,评分会一直显示 0.000,人会慌(12 §3.5)。

第三,明天会有人跳起来反对你。 不是你的老板——是真的业务负责人。他只会问一句话: '你拿这些数字,凭什么让我相信能上线?' 你只能用数据回应,不许讲情怀。"

④ 移交 S6(89–90 min)

"接下来的 45 分钟归你们。助教只回答两类问题:规则类,和'这个数算不算有出处'。方案类问题,明天再问。"

投屏·板书

  • 左:G4 四条(①②③ blocker / ④ warning)
  • 中:命名 + 截止 + 补交
  • 右:D5 三个钩子(指标难看 / 先删 expected_category / 有人会反对你)
  • 白板角落:停车位

互动设计

环节 讲师动作 目的
复述 随机抽一人复述"①②③里哪个最容易翻车、为什么" 确认听进去了
演示 --gate corpus 只跑一次,报错出来立刻解释 防止课后乱敲

学员动作(现场)

  • 记下 G4 四条、命名规范、截止时间
  • 记下 D5 三个钩子

常见错误与纠偏

错误 纠偏
学员问"③ 199 字行不行" 行——但自己先数一遍(含标点);不确定就把计数器截图一并交
学员问"④ 我不写行不行" "④ 是 warning,不拦你;但 D8 评分表里有它"
学员担心"我手里是真实数据怎么办" 引用红线:真实数据先脱敏 + 公司同意,且不投屏、不传群(11 §6.1)

承接语(最后 30 秒)

"今天的产出,明天要用。别到明天早上才发现自己说不清 395。"

学员笔记要点

  • G4 四条 + 命名 + 截止 + 补交
  • D5 三钩子:指标难看 / 先删 expected_category / 有人会反对你

S6 · 自练(+45 min)

本节定位:独立完成、自评、提交。目标只有一个:两份产出都能过 G4 ① 与 ③。

一句话目标:把"跑过了"变成"说得清"。

45 分钟怎么分(投屏建议)

分钟 干什么 产物
0–10 定稿话术(删形容词、逐词对禁用词表) 话术终稿
10–20 补齐数字链表(每个数字带出处) 数字链表
20–32 写 G4 ②:盲区说明 + 补盲策略(9 个缺口 / 四种手法 / 上限 50 与撞车的解释) 报告第 ② 节
32–40 通读报告:删"大概 / 差不多 / 基本";核对每个数字 报告终稿
40–45 自评 G4 + 提交 + 群里发 60 秒收获 提交

三条路径(学员按自己情况选一条)

路径 谁选 做什么
A 完成 大多数人 用课程虚构数据跑通 + 两份产出 + 提交
B 迁移 手里有已脱敏且经公司同意的数据 把 --input 换成自己的(先 --dry-run 看一眼);不得投屏、不得传群、不得进任何第三方工具;报告里只写结论与统计,不贴原始样本
C 加练 想再挖一层 改目标线重跑:cp fde_scope/templates/corpus_config.yaml /tmp/fde-d4-demo/config_c30.yaml → 把 min_samples_per_category: 100 改成 30 → 用 --config 指向它重跑。观察两件事:总量怎么变(实测 20 real + 231 synthetic = 251 total)、缺口是不是还在(还是 9 个,但显示 (need ≥30))。练的是"线是可以谈的"

完成标准(提交前逐条打钩)

☐ 数字链表每个数字都有出处(控制台 / 报告哪一屏 / JSON 哪一行)
☐ 报告写了真实量 20、合成量 395、总量 415 与真实占比(≈4.8%)
☐ 报告写了缺口 9 个、补满 6 类(各 50)、未满 3 类(42 / 29 / 24)及原因
☐ 报告写了"test 42 条里真实样本为 0"(诚实标注,不许删)
☐ 话术 ≤200 字,逐词对过禁用词表(语料 / 覆盖度 / 合成数据 / 去重 / 准确率 / 模型 / 推理 / 向量 / embedding / token)
☐ 三个预注册数字标注【预注册】并给出实测值
☐ 全文删掉"大概 / 差不多 / 基本 / 尽量"
☐ 命名 D4-姓名-语料报告 / D4-姓名-客户话术

卡点急救

卡在哪 怎么救
"395 数不出头" 三处一致法:控制台 +395、KPI「合成样本 395」、JSON synthetic: 395——同一份数据三处同值,任说一处都能指
话术超字 先砍形容词("非常好用的""特别重要的"),再砍并列;合成手法如实报的说法是:"改了说法、加了情绪、加了上下文"
报告里找不到 pii_scrub 的痕迹 不要写你不确定的东西。只写你能指到的:"KPI 显示 PII 脱敏数 2;样本内有 2 条被替换为 [REDACTED]"
"缺口为什么补不满?" 机制解释:每类补的上限 50 条(synth_per_gap)+ 变形类补法会撞车(去重阈值 0.92)→ 所以 42 / 29 / 24
"我想试 --llm" 没 key 会拒绝开工(退出码 2)。课后到个人环境试;不要在共享终端填真 key
"test 里 0 条真实的,要不要写" 必须写。 少写一句,明天被人问出来,就是全场最小的事故

助教值守规则

  • 只回答两类问题:① 规则类(命名 / 截止 / 格式 / 报错 / 数字对不上)② "这个数算不算有出处"
  • 不回答:D5 之后的方案类问题;"我能不能不写 ④"这类豁免请求(④ 是 warning,写不写自己决定)
  • 每 15 分钟在群里发一次进度提示("还有 30 / 15 / 5 分钟")
  • 收到提交后只回一个字:✓(不讲评——讲评在次日 08:30 门禁榜 + D5 回炉)
  • 遇到真实客户名 / PII / 真实 key 出现在提交里 → 立即私聊要求撤回重交,并记录合规日志(11 §6.7)
  • 学员问"我这份语料能用吗" → 只回一句:"先问自己:真实多少、补了多少、缺口几个。"

学员动作

  • 45 分钟独立完成(路径 A / B / C 三选一)
  • 自评 G4 四条
  • 提交 → 收到 ✓
  • 在群里写 60 秒收获:「我今天补的那部分,占比 ___%(真实 ___ 条 / 补 ___ 条)。」

常见错误与纠偏

错误 纠偏(助教用)
报告写成"工具输出汇编" "工具能给你的你都给了,工具给不了的你一个字没写。 盲区与策略、话术、比例——这三样才是你的报告"
话术里出现"合成数据占比 95%" 递禁用词表,让他自己划掉重写
只交报告不交话术 打回:③ 是 blocker,缺一条就是没过
提交里带了 corpus_report.json 提醒:不交 JSON(它是语料本体);如要展示改用报告截图(截图前 3 秒检查姓名 / logo / 域名)
把 415 说成"我们的数据量" 纠正:415 是可用语料量;数据底数是 20——两个数永远一起报

附 A · D4 板书总图(一天下来的白板应该长这样)

┌────────────────────────────────────────────────────────────────────┐
│  D4 · 造语料 —— 20 条炼成 415 条,每条都要讲得清从哪来               │
├──────────────────────────────┬─────────────────────────────────────┤
│  数字链(预注册对账)         │  报告 4 屏                           │
│  20 → 淘汰 0 → 20 real        │  KPI · 覆盖度 · 合成补盲 · 数据分割   │
│  + 395 模拟 → 415 total       │  test 42 里真实 0 条(照实说)        │
│  → 切分 332 / 41 / 42         │  ⚠ +97 是缺口,不是补入量            │
│  真实占比 ≈ 4.8%              │                                     │
├──────────────────────────────┴─────────────────────────────────────┤
│  两句话常驻:                                                        │
│  ▸ 每个数字都要能指到出处。                                          │
│  ▸ 合成是补盲区,不是凑数量。                                        │
│  工具的数:real=20 · synthetic=395 · total=415 · masked=2            │
│            gaps=9 · target=100 · diversity=0.9569                    │
├────────────────────────────────────────────────────────────────────┤
│  三道闸:去重阈值 0.92 | 质量门 3.0(合成 3.5)| 目标线 100(可调)  │
│  两种来源:real(20)| synthetic(395 = paraphrase 271 + emotion 59  │
│            + adversarial 45 + multi_turn 20)                        │
│  降级三形态:没 key = 拒绝开工 | 连不上 = 规则路径 | 能用 = llm    │
├────────────────────────────────────────────────────────────────────┤
│  话术三句:① 能用多少 ② 补了什么 ③ 为什么可信                       │
│  禁用词(对客户):语料 · 覆盖度 · 合成数据 · 去重 · 准确率(裸用)  │
│                    · 模型 · 推理 · 向量 · embedding · token          │
│  反模式:数据"凑数"(用合成量掩盖真实缺口)→ 真实量+合成量+比例一起报 │
│  老板三追问:哪几个数字?是你编的吗?说人话。                         │
│  工具里没有"语料门":G4 是人工判的。                                 │
├────────────────────────────────────────────────────────────────────┤
│  红线三条(11 §6.1):只用虚构或已脱敏数据 · 真实名与 PII 不进群不上传 │
│                      · 不进任何第三方工具                             │
│  停车位:________________________________________(今天跑题的术语)  │
└────────────────────────────────────────────────────────────────────┘

附 B · 讲师自查(下课前 5 分钟)

  • ☐ 三条红线全守住了?有没有冒出第 4 个概念却没进停车位?
  • ☐ S1 的预注册做了吗(群里真的刷过三个数字)?
  • ☐ S2 对账逐条揭晓了吗(淘汰 0 条 / 415 / 395)?
  • ☐ 控制台六行是真跑出来的,不是口述的吧?
  • ☐ 报告 4 屏逐屏点开了吗(KPI / 覆盖度 / 合成补盲 / 数据分割)?
  • ☐ 有没有当场点开 corpus_report.json,把某一条的 trace 指给学员看?
  • ☐ "+97 是缺口,不是补入量"说出口了吗?
  • ☐ "test 42 条里真实 0 条"说出口了吗?
  • ☐ LLM 两幕都演了吗(无 key 拒绝开工 / 假 key + 死端点自动回退 + 两个哈希相同)?
  • ☐ "合成是补盲区,不是凑数量"这句至少说过 2 次吗(S2 + S4)?
  • ☐ 禁用词表 10 词投屏过吗?S4 的三人一组做了吗?
  • ☐ 老板三追问真问过至少一轮吗(07 §3.3 原话)?
  • ☐ --gate corpus 只演示了一次吗(不该反复敲)?
  • ☐ G4 四条、命名规范、截止、补交规则都念全了吗?
  • ☐ 红线三条(11 §6.1)逐条念过吗?
  • ☐ D5 三个钩子埋了吗(指标难看 / 先删 expected_category / 有人会反对你)?
  • ☐ 未提交名单记下来了吗(次日 08:30 前私聊)?

下一节:20-D5逐节教案.md(验证与评估:用证据说话) 本日配套:02-逐日教学大纲.md Day 4(时间盒总表)· 06-学员手册与作业包.md D4 任务卡 · 07-实战剧本与案例库.md §2.2 / §2.3 / §3.3 / §4.4 · 11-工具与环境准备.md §6(数据合规与 PII 红线)· 12-附录-术语表与模板库.md §2.3(客户话术模板与禁用词表)

20 · D5 逐节教案:验证与评估(用证据说话)

20

course-level-1/20-D5逐节教案.md

本文件是 D5(90 分钟直播 + 45 分钟自练)的逐节执行稿:每节课讲什么、怎么说、屏幕放什么、学员做什么、卡住怎么救、下一节怎么接。 上游时间盒:02-逐日教学大纲.md Day 5|通用骨架与控场:05-讲师手册.md §2 / §4(D5 五条带教要点) 模板与术语:12-附录-术语表与模板库.md §1.4(评估与指标术语)· §1.6(十二反模式 · #4 Demo-Debt / #11 No HITL / #10 Scope Creep)· §2.4(评估测试集模板 · 版本 A / 版本 B)· §2.5(Bad Case 清单)· §2.6(验证记录)· §3.5(出错速查) 演练素材:07-实战剧本与案例库.md §2.2(迅捷出行)· §3.4(D5 发难剧本 · 五连刁难)· §4.2(反对意见业务主管角色卡 · 含暗号)· §5(助教评分 · 通用观察表) 数据红线:11-工具与环境准备.md §6(数据合规与 PII 红线 · 不可协商)|学员侧任务卡:06-学员手册与作业包.md D5|门禁条款:03-评估体系与通关门禁.md §3 G5 行 本日演示数据:学员自造 test_set.jsonl(虚构,5 行起步)+ 工业只读对照 examples/quickstart_manufacturing/station_samples.jsonl(5 个工位 · 虚构)|演示工作目录:/tmp/fde-d5-demo(不写进仓库) ⚠ 环境提示(今天必踩):eval 不挑目录,但 kpi 要认 .fde_scope/ ——命令一律从仓库根执行,测试集用 /tmp/... 绝对路径(实测在 /tmp 里跑 kpi 会得到 Engagement not found,退出码 2)。


0. 今天的三条红线(全天不许破)

# 红线 怎么守
1 全天只出现 3 个新概念:真实数据原型 · 评估指标(带业务口径)· bad case(改进抓手) 「准确率 / 召回 / F1 / 混淆矩阵 / 金标集 / 基线」一律进停车位(白板角落),课后答疑再讲。对客户说"拿你们真实的 200 条单子试过,60% 能直接回",不说"F1 = 0.87"——裸用"准确率"就在 12 §2.3 的禁用词表里
2 指标是地图,不是成绩单——第一次跑难看是正常的;不许为了好看换数据、换口径、删坏例 换一批好看的测试集 / 删掉失败样本 / 只贴平均分不挖坏例子 = Demo-Debt(12 §1.6 #4)的入场券。G5 ① 要求同命令同结果——你动一次口径,① 就是不过(03 §3)
3 关键决策留人确认(HITL)必须写进方案——被问到"答错了谁负责"不许用"我们模型很准"接 No HITL(12 §1.6 #11)是反模式:今天演练的第一问就是它(07 §3.4 第 1 问)。回答里没有 HITL 兜底设计 = 这一轮不通过,当场补

今天没有硬性休息:D5 直播同样只有 90 分钟,中间不设休息点。 但 S2 的"幕 3 全绿陷阱" 是全天的天然停顿点——当学员发现"最差的 agent 也能拿满分卷"时,停 10 秒,让他们自己说一句感受,再往下走。

为什么今天"最反直觉":前四天你都在做加法(接数据、造语料、写交付物),今天你要给自己找茬—— 而且工具会主动配合你骗自己:假分数长得跟真分数一模一样,难看的话一句不说。 今天全天只有一个动作:把"我觉得挺好的"换成"我怎么知道的"。

今日 6 节课总览

节 时间 一句话目标 学员产出 记忆锚点
S1 回炉 0–10 min G4 讲评(1 优 1 劣)+ 打预防针:今天数字一定难看 写下"我最怕看到的数字" "指标是地图,不是成绩单"
S2 讲与演 10–35 min 六幕连演:0.000 陷阱 → 全绿陷阱 → 可复现 → 平均值陷阱 → 没有证据门 观察笔记 "指标好看 ≠ 系统好;0.000 有两种含义"
S3 上手 35–70 min 自造测试集 → 跑 eval → 按组跑 kpi → 录 2 分钟原型 🎯 产出 5 草稿 "先删 expected_category,再跑 mock"
S4 复盘 70–80 min 助教扮演反对的业务主管,五连发难 应答改写清单 "用数据回应,不许讲情怀"
S5 布置 80–90 min 收 G5 + 明日钩子 提交清单 "明天开始,你要为凌晨 2 点值班的人写文档"
S6 自练 +45 min 独立跑通 + 挖 Top3 bad case + 一页验证记录 🎯 产出 5 提交 门禁自查 G5 三条

今日产出物(🎯 产出 5):四样东西—— ① 原型证据:一个能演示的原型(≤2 分钟录屏,或现场演示)——跑在真实数据原型上(你们自己那批脏数据),不是策展测试集。 ② 评估结果:eval --agent mock 跑出来的报告(指标表 + Top bad case 类)。 ③ Top3 bad case:每条含四要素——现象 → 根因假设 → 下一步动作 → 预计改善。 ④ 一页"验证记录":含被拒绝的需求(12 §2.6 四行表)。 通关门禁 G5 原文(03 §3): ① 评估可复现(同命令同结果)② bad case Top3 每条含**"下一步动作"** ③ 有一页**"验证记录"(含被拒绝的需求) —— ①② blocker;③ warning。 ⚠ 注意 ③ 只是 warning:它不拦你,但答辩评分表里"边界感"一项看的就是它**(12 §2.6)。 真正会把你拦在门外的是 ②——"只描述现象、不给下一步动作" 的 bad case 清单,写得再漂亮也是 ② 不过。


S1 · 回炉(0–10 min · 10 min)

本节定位:10 分钟干三件事——交出 D4 的账(门禁榜 + 1 优 1 劣),然后打今天的预防针,最后让每个人写下自己的"恐惧数字"。不讲课,只讲评 + 提问。

一句话目标(开场念):"昨天你们的语料报告我看了。今天我要先给你们打个预防针——接下来你跑出来的指标,会比你想象的难看。这不是坏消息,这是它唯一的用处。"

分钟级时间盒

分钟 动作 目的
0–3 G4 门禁榜(通过 / 补交 / 未交 三个数字)+ 补交规则复述 让"过没过"变成公开事实
3–8 1 优 1 劣讲评(都不点名) 让"好长什么样"可复制,让"坑"提前暴露
8–10 预防针 + 写下"我最怕看到的数字" 把恐惧提前说出口,S2 才有冲突可收

讲稿要点

① 0–3 min|G4 门禁榜:三个数字 + 一条规则

  • 只念三个数:通过 __ 人 / 补交 __ 人 / 未交 __ 人(不念名字,名单课后私聊)
  • 复述补交规则(03 §3 文末,全年只讲这一次也要讲清):

    "24 小时内补交 = 正常放行(标注"补交通过");超过 24 小时 = 延期通过,作品集等级最高 B;特殊情况走豁免,但豁免会写进证书备注。"

  • 一句话收口:"门禁不是考核,是防掉队。今天 D5 如果你缺东西,明天 D6 会直接卡住——因为你要给一个已经跑起来的东西写运维文档。"

② 3–8 min|1 优 1 劣(都不点名)

优(要念出细节,让全班知道"好长什么样")——挑一份数字链完整的:

"这份报告里写:'原始 20 行,淘汰 0 条,真实 20 + 合成 395 = 415,切分 332 / 41 / 42。' 然后它多写了一行——'其中 test 42 条里真实样本为 0'。 这一行是全班最值钱的一行。没人问它,它自己说了。 这就是 G5 要的东西:不是好看,是可信。"

劣(不点名,讲模式)——挑一份只有结论没有出处的:

"另一份报告写:'语料质量良好,覆盖度达标,学员可直接用于训练。' 我拿红笔圈了三个词:良好 / 达标 / 直接。这三个词在这里都是形容词,不是证据。 我逐条问它出处,三条都指不出来——指不出出处的数字 = G4 ① 不过(12 文末三条纪律 ①)。 今天 D5 是同一件事的升级版:昨天你指不出语料的出处,今天你就要指不出指标的出处。"

③ 8–10 min|预防针 + "我最怕看到的数字"

念 05 §4 D5 第 1 条(原话):

"第一次评估指标难看是正常的——指标是地图,不是成绩单。"

然后让每个人在群里打一个数字或一句话:"今天我最怕看到的指标是什么?"

这个动作是本节的灵魂:先落笔,后对照。S2 幕 3 结束时,会有人发现——自己怕的那个数字,恰恰是全场唯一真的那个。

投屏·板书

  • 左半屏:G4 门禁榜(三个数字,手写)+ 补交规则一行
  • 右半屏:今日路线(S1→S6 六格,S2 那格画 6 个小圆点代表六幕)
  • 白板角落(今天叫停车位):画个框写"准确率 · 召回 · F1 · 混淆矩阵 · 金标集"——今天冒出来的术语一律扔这儿
┌────────────────────────────┬──────────────────────────────────┐
│ G4 门禁榜                  │ D5 路线(六格)                   │
│  通过 __ / 补交 __ / 未交 __│ ①回炉 ②讲演 ③上手 ④复盘 ⑤布置 ⑥自练│
│ 24h 内补交=正常放行        │        S2 = ●●●●●●(六幕)        │
│ 逾期=延期通过(封顶 B)       │                                  │
├────────────────────────────┴──────────────────────────────────┤
│ 停车位(今天的术语):准确率 · 召回 · F1 · 混淆矩阵 · 金标集      │
├───────────────────────────────────────────────────────────────┤
│ 今天最怕看到的数字:_______________(先写,不许改)              │
└───────────────────────────────────────────────────────────────┘

互动设计

  • 群接龙:"我最怕看到的数字"——三条示例先给出去降低门槛:
    • "我怕 intent_accuracy 出来 0.000"(正常反应,S2 幕 2 会告诉他为什么可能"假 0")
    • "我怕客户问我这数怎么来的,我答不上"(这个才是真问题)
    • "我怕结果是好的,但我知道那是假的"(最成熟的一种——今天全场就练这个)
  • 讲师不点评任何一条,只说:"记住你写的那句。四十分钟后我们回来对。"

常见错误与纠偏

错误 纠偏
讲师把 G4 未交名单念出来 只说数字不说名字——安全底线,掉队者课后私聊
预防针说成"今天会很难" 措辞必须是 "难看是正常的,难看有用"——不是难度警告,是心理授权
学员问"那指标好看怎么办" 反问:"如果它好看,你先告诉我它测的是不是你以为的那个东西。" 这就是 S2 幕 2 的引子

承接语(最后 30 秒)

"你们每个人手里现在都有一个数字。四十分钟后,我会当场跑六遍。 其中一遍会让你发现自己写的那个数没那么可怕;另外一遍会让你发现——它压根没在测你以为它在测的东西。 走。"

学员笔记要点

  • G4 门禁榜数字 + 补交规则(24h 内=正常放行 / 逾期=延期通过(封顶 B)/ 豁免进证书)
  • "指标是地图,不是成绩单"(05 §4 D5 第 1 条)
  • 我写下的"最怕看到的数字":____________
  • 一句待验证的话:"如果指标好看,先问它测的是不是我以为的东西。"

S2 · 讲与演(10–35 min · 25 min)

本节定位:25 分钟连续跑六幕,六幕围绕一句话——"我怎么知道它行?" 全程零 key、零网络,.venv/bin/python -m fde_scope.cli 真跑真投屏。

一句话目标(开场念):"今天我不讲道理,我讲证据。接下来六遍命令,每一遍都会教你们一件事——工具不会主动骗你,但它也不会主动拦你。"

分钟级时间盒

分钟 幕 动作 这一幕教什么
10–14 幕 1 eval 版本 A(5 行 · 无 expected_category) 全绿的表长什么样;谁是表里唯一的真信号
14–19 幕 2 eval 版本 B(含 expected_category) intent_accuracy 恒 0.000 的假分数
19–23 幕 3 --accuracy 0.9 vs --accuracy 0.0(逐字节对拍) 最差的 agent 也能拿满分卷——今天最重要的一幕
23–25.5 幕 4 同一命令连跑 3 次 G5 ①"可复现"长什么样(同命令同结果)
25.5–31 幕 5 kpi:平均值 → 逐工位拆解 平均分掩盖 bad case;0.0 有两种含义
31–35 幕 6 gate check + G5 条文 没有"证据门"这个工具——G5 是人工判的

讲稿要点

① 幕 1(10–14 min)|全绿的表,和唯一的真信号

先跑,不解释。让表格自己说话:

┏━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ metric                ┃ value ┃ label                            ┃
┡━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ corpus_coverage       │ 0.000 │ 意图覆盖率(0-1)                │
│ corpus_quality_avg    │ 0.000 │ 平均质量分(1-5)                │
│ corpus_diversity      │ 0.000 │ 语义多样性指数                   │
│ intent_accuracy       │ 1.000 │ 意图识别准确率                   │
│ reply_adoption_rate   │ 1.000 │ 回复采纳率(人工未修改直接使用) │
│ escalation_rate       │ 0.200 │ 人工升级率(越低越好)           │
│ first_contact_resolve │ 1.000 │ 首次接触解决率                   │
│ avg_handle_time       │ 0.000 │ 平均处理时长(对比人工基线)     │
│ customer_satisfaction │ 3.000 │ 客户满意度(CSAT)               │
│ cost_per_ticket       │ 1.000 │ 单工单成本                       │
└───────────────────────┴───────┴──────────────────────────────────┘

停 10 秒,问全班一句:"这张表里,哪个数字是真的?"

然后逐个点掉(这是今天的第一次"祛魅"):

你看到 你以为是 它其实是
intent_accuracy 1.000 "意图识别 100% 准" 没测——你没填 expected_category,这一行按"无信号 = 不扣分"记 1.0(12 §2.4「读表前必看」)
reply_adoption_rate 1.000 "回复 100% 被采纳" 没测——adopted 没数据,默认 1.000
first_contact_resolve 1.000 "100% 一次解决" 没测——默认值就是 true
avg_handle_time 0.000 "快到 0 秒" 没测——没有一条记了时长;cost_per_ticket 1.000 同理(与人工基线持平 = 没数据时的中性值)
customer_satisfaction 3.000 "满意度 3 分" 没测——1–5 分制的中性中点
corpus_* 0.000 ×3 "语料很差" 没接语料报告——eval 不自带语料维度(这是 D4 的活)
escalation_rate 0.200 "20% 的升级率" ✅ 真的——escalated: true 是你在数据里真写的:5 条里 1 条

"看清楚了吗?十行里九行是填充物,只有一行是真的。 而这一行——升级率高是坏消息(越低越好)。所以今天第一次跑,唯一的真信号是一条坏消息。 这不是 bug。这是这份表唯一诚实的部分。"

② 幕 2(14–19 min)|expected_category:那个让你得 0.000 的字段

"昨天有人问我:'既然 expected_category 是标准答案,我填上不就更准了吗?' 来,我们填上。"

跑版本 B(前 4 行加上 expected_category),结果:

│ intent_accuracy       │ 0.000 │ 意图识别准确率                   │
│ escalation_rate       │ 0.250 │ 人工升级率(越低越好)           │

"intent_accuracy 从 1.000 掉到 0.000。滑天下之大稽——我给它标准答案,它反而变笨了? 不是变笨。是判分口径变了(12 §2.4):填了 expected_category 之后, 判分规则变成子串匹配——它会去 agent 的回复里找有没有"退款售后"这四个字(fde_scope/eval/metrics.py score_intent_accuracy)。 而 mock 的回复是 已为您处理:我要退货,怎么操作?…(mock 回复)——它只复读你的问题,从来不报类别名。 所以在真模型上,版本 B 是必须的;在 mock 上,版本 B 只会给你一个 0.000 的假分数。"

收口(这句要慢):

"两个版本,一个给 mock,一个给真模型。复制错了,你得到的是一个看起来像'系统很烂'、实际上什么也没测的数字。 这也正是 D4 那条纪律的第二次现身:指不出出处的数字不要写。 现在你知道'出处'有两个方向——数据从哪来,还有这个数是怎么算出来的。"

③ 幕 3(19–23 min)|全绿陷阱:把 agent 调到最差,表格一格不动

"接下来这一幕是今天全场最重要的一幕。我要把 mock 调到最差——--accuracy 0.0,意思是它对每一条都回答'抱歉,我不太理解您的问题'。"

先跑 --accuracy 0.9(默认),再跑 --accuracy 0.0,两张表逐字节对拍:

$ diff out_a.txt out_a0.txt
(无输出 —— 两份输出完全相同)

逐字念出关键三行(两次都一样):

│ intent_accuracy       │ 1.000 │ 意图识别准确率                   │
│ escalation_rate       │ 0.200 │ 人工升级率(越低越好)           │
⚠ Top bad case category: 门店投诉

"同一个卷子,一个正常答题的 agent,一个只会说'我不理解'的 agent,拿到了一模一样的分数。 而且——注意看这两张表的最后一节:一张 bad case 都没有,⚠ Top bad case 这一行压根没出现。 最差的 agent,拿到了最漂亮的一张成绩单,和一句'没有坏例子'。

为什么?因为 --accuracy 只决定 mock 回哪句套话,它压根不是被测对象——它是"演员",不是"考生"。 真正的判分口径只认你数据里那几个字段(escalated / adopted / handle_time_seconds ……), 而那张 5 行的表里,只有一个字段是真填的。你用一张只有一个真信号的表,测不出任何关于 agent 的事。"

这一段必须停 10 秒。然后给三条结论(学员照着抄):

  1. 指标好看 ≠ 系统好。 好看可能只是"没测到"。
  2. 0.000 有两种含义:全错,或者根本没这一列。(幕 5 会看到第三种:真的一个都没有。)
  3. mock 的任何数字都不能写进作品集(12 §2.4 的 ⚠ 原话)。mock 是管道验证器,不是效果证明。真效果要等接入真模型那一跑——而今天我们的任务,是把这条管子铺直、铺诚实。

"所以 G5 ① 为什么是 blocker?因为如果你的评估是'一按就好看'的,它就永远不会告诉你坏消息—— 而 FDE 的价值,恰恰是第一个知道坏消息的人。"

④ 幕 4(23–25.5 min)|"可复现"长什么样(G5 ①)

同一条命令连敲 3 次,把三份输出的关键几行贴在一起:

run 1: intent_accuracy 1.000 | escalation_rate 0.200 | Top bad case: 门店投诉
run 2: intent_accuracy 1.000 | escalation_rate 0.200 | Top bad case: 门店投诉
run 3: intent_accuracy 1.000 | escalation_rate 0.200 | Top bad case: 门店投诉

"同命令、同数据、同结果——这就是 G5 ① '可复现'的全部含义。 注意:可复现不是'结果好',是'结果不随机'。一个稳定地难看的分数,比一个忽好忽坏的漂亮分数值钱一百倍—— 因为前者能当基线用,后者只能当 PPT 用。 顺带说清一件事:mock 天然可复现(固定种子 0)。等你接过真模型,同一个问题问两次可能得到不同答案—— 那时候'可复现'要靠另外三样东西撑:固定的测试集、固定的提示词版本、固定的模型版本。这三样今天写进你的验证记录。"

⑤ 幕 5(25.5–31 min)|平均值陷阱:0.7236 背后藏着 0.5111

切到工业场景(B 组的战场),跑 kpi 读聚合值:

FDE Scope v0.1.0 — KPIs · eng-southbay-manufacturing-seed03 (manufacturing)

│ oee                         │     0.7236 │ OEE 设备综合效率(A×P×Q,世界级≥85%)│
│ mtbf                        │    39.7500 │ MTBF 平均无故障时间(h)             │
│ mttr                        │     3.0000 │ MTTR 平均修复时间(h,越低越好)     │
│ first_pass_yield            │     0.9549 │ FPY 一次合格率                       │
│ dpmo                        │ 10925.9765 │ DPMO 百万机会缺陷数(越低越好)      │
│ grasp_success_rate          │     0.7931 │ 抓取成功率(DexNet ~80% 基准)       │
│ task_completion_rate        │     0.9203 │ 任务完成率                           │
│ collision_intervention_rate │     0.0108 │ 碰撞/干预率(越低越好)              │

"'OEE 0.7236(72%)'——一个可以写进周报的数字。世界级是 ≥85%,所以这份报告读起来像'还行,有提升空间'。 现在我们把它拆开,一个工位一个工位地看。"

(讲师现场用 Python 逐行拆,屏幕贴出)

station               oee      fpy    grasp     coll     dpmo
BODY-WELD-01       0.7772   0.9583   0.8444   0.0067    10417
BODY-WELD-02       0.7856   0.9615   0.8478   0.0046     9615
PAINT-01           0.8747   0.9900   0.0000   0.0011     3333
ASSY-COBOT-01      0.7033   0.9419   0.7895   0.0147    11628
ASSY-HUMANOID-01   0.5111   0.9078   0.7333   0.0321    18440

三句话,一句比一句重:

  1. 平均值掩盖了最该修的那一个。 聚合 OEE 0.7236,看着"还行";ASSY-HUMANOID-01 是 0.5111, 碰撞率 0.0321 是全厂最高的 3~7 倍。如果只看平均分,你永远不会知道要先修它。 → 这就是今天要挖 Top3 bad case 的理由:平均分是用来汇报的,bad case 是用来干活的(05 §4 D5 第 2 条)。
  2. PAINT-01 的 grasp_success_rate 0.0000 不是"抓取全失败"——喷涂工位根本没有抓取这一列数据。 → 0.0 有三种含义了:全错(幕 2 的 intent 0.000)、没这一列(这里)、真的一条都没发生。 所以看到 0 不要下结论,先问一句:这个 0 是怎么来的?
  3. 数错了对象,工具不报错。 我们试过把工业样本喂给工单 engagement:工具一声不吭,照常打印 工单 KPI 表,四行全是 0.0000,退出码 0。 → 工具不会替你检查口径。 G5 ① 之所以是你要自己扛的责任,原因就在这。

再看一次对的那一跑(工单 engagement × 工单字段样本):

│ intent_accuracy     │   0.7500 │ 意图识别准确率         │
│ reply_adoption_rate │   0.7500 │ 回复采纳率             │
│ escalation_rate     │   0.2500 │ 人工升级率(越低越好) │
│ avg_handle_time     │ 285.0000 │ 平均处理时长           │

"这才叫'测到了':四个数都有明确对象——4 条样本里 3 条意图对、3 条被采纳、1 条升级、平均 285 秒(人类基线 480 秒)。 看 escalation_rate 0.2500 和 avg_handle_time 285 ——这两个数业务方看得懂,也业务方在乎。 这就是课件里那句'评估指标(意图准确率/采纳率与业务口径)'的意思: 能把技术数字翻译成业务数字的人,才配叫 FDE。"

⑥ 幕 6(31–35 min)|gate check 说"没有门"——G5 是人工判的

$ fde-scope gate check eng-swift-ticket-seed05
Phase 'prototype_real_data' has no gate.
(退出码 0)

"看出来了吗?工具里没有'证据门'。 十条工具门禁里,通用三条是 success_criteria / slo / handoff_signoff—— eval 不在其中。 也就是说:没有任何一条命令会拦住你'糊弄评估'这件事。

这跟 D4 那天是同一个结构:工具能替你跑数,不能替你负责。 G5 三条(① 可复现 ② Top3 带下一步动作 ③ 一页验证记录)全部是人判的—— 判的人是你的助教,判据是你能当场演示、能指到出处、能说出为什么。"

投屏·板书

  • 六幕全跑真命令,每一幕结束后把那一幕的一句话写在白板上(六句话就是今天的骨架):
幕1 全绿的表,九行是填充物           幕4 可复现 = 不随机,不是 "结果好"
幕2 expected_category → 假 0.000     幕5 平均分掩盖 bad case;0 有三种含义
幕3 最差的 agent 也能拿满分卷        幕6 工具里没有证据门 → 谁判?人判
  • 白板右侧常驻三个词:真实数据原型 / 业务口径 / bad case
  • 停车位随时收术语(今天预期会冒出来:F1、召回、混淆矩阵、A/B 测试、置信区间——全扔进去,课后答疑)

演示脚本(可直接复制执行)

⚠ 全部从仓库根执行(kpi 要认 .fde_scope/);测试集放 /tmp/fde-d5-demo(不写进仓库)。 六幕合计约 25 分钟,逐条复制即可,不需要任何 API key。

# ── 准备:演示工作目录(不写进仓库)──────────────────────────────────
mkdir -p /tmp/fde-d5-demo && cd /tmp/fde-d5-demo

# 幕 1 的测试集:5 行起步,只写 id / input / category(= 版本 A)
# ⚠ 不要加 expected_category —— 那是版本 B,只在 --agent mimo 时用(12 §2.4)
cat > test_set_a.jsonl <<'EOF'
{"id": "c-001", "input": "我要退货,怎么操作?", "category": "退款售后", "expected_output": "指导退货流程", "baseline_handle_time_seconds": 480.0}
{"id": "c-002", "input": "我的快递到哪了", "category": "物流查询", "expected_output": "查询物流状态", "baseline_handle_time_seconds": 480.0}
{"id": "c-003", "input": "这家店的服务太差了!我要投诉", "category": "门店投诉", "expected_output": "记录投诉并升级", "escalated": true, "baseline_handle_time_seconds": 480.0}
{"id": "c-004", "input": "积分怎么兑换", "category": "会员积分", "expected_output": "说明积分规则", "baseline_handle_time_seconds": 480.0}
{"id": "c-005", "input": "我要退货咯,咋个弄嘞", "category": "退款售后", "expected_output": "指导退货流程", "baseline_handle_time_seconds": 480.0}
EOF

# 幕 2 的测试集:前 4 行 + expected_category(= 版本 B 的错用现场)
cat > test_set_b.jsonl <<'EOF'
{"id": "c-001", "input": "我要退货,怎么操作?", "category": "退款售后", "expected_category": "退款售后", "expected_output": "指导退货流程", "baseline_handle_time_seconds": 480.0}
{"id": "c-002", "input": "我的快递到哪了", "category": "物流查询", "expected_category": "物流查询", "expected_output": "查询物流状态", "baseline_handle_time_seconds": 480.0}
{"id": "c-003", "input": "这家店的服务太差了!我要投诉", "category": "门店投诉", "expected_category": "门店投诉", "expected_output": "记录投诉并升级", "escalated": true, "baseline_handle_time_seconds": 480.0}
{"id": "c-004", "input": "积分怎么兑换", "category": "会员积分", "expected_category": "会员积分", "expected_output": "说明积分规则", "baseline_handle_time_seconds": 480.0}
EOF

# ── 六幕(切回仓库根执行;把 <repo> 换成你的仓库路径)────────────────
cd <repo>

# 幕 1:版本 A —— 全绿的表 + 唯一的真信号 escalation_rate 0.200
.venv/bin/python -m fde_scope.cli eval --agent mock --test-set /tmp/fde-d5-demo/test_set_a.jsonl

# 幕 2:版本 B —— intent_accuracy 掉到 0.000(子串匹配,mock 不报类别名)
.venv/bin/python -m fde_scope.cli eval --agent mock --test-set /tmp/fde-d5-demo/test_set_b.jsonl

# 幕 3:全绿陷阱 —— 对拍两份输出,逐字节相同;最差的 agent 拿满分卷
.venv/bin/python -m fde_scope.cli eval --agent mock --test-set /tmp/fde-d5-demo/test_set_a.jsonl > /tmp/fde-d5-demo/out_a.txt 2>&1
.venv/bin/python -m fde_scope.cli eval --agent mock --test-set /tmp/fde-d5-demo/test_set_a.jsonl --accuracy 0.0 > /tmp/fde-d5-demo/out_a0.txt 2>&1
diff /tmp/fde-d5-demo/out_a.txt /tmp/fde-d5-demo/out_a0.txt && echo "(无输出 = 两份完全相同)"

# 幕 4:可复现 —— 同命令连跑 3 次,只看关键几行
for i in 1 2 3; do
  .venv/bin/python -m fde_scope.cli eval --agent mock --test-set /tmp/fde-d5-demo/test_set_a.jsonl \
    | grep -E 'intent_accuracy|escalation_rate|Top bad'
done

# 幕 5a:平均值 —— 聚合 OEE 0.7236(B 组);演示用只读样本
.venv/bin/python -m fde_scope.cli kpi eng-southbay-manufacturing-seed03 \
    --samples examples/quickstart_manufacturing/station_samples.jsonl

# 幕 5b:口径不匹配 —— 工业样本喂给工单 engagement:静默全 0.0000,退出码 0
.venv/bin/python -m fde_scope.cli kpi eng-swift-ticket-seed05 \
    --samples examples/quickstart_manufacturing/station_samples.jsonl

# 幕 5c:逐工位拆解 —— 看 ASSY-HUMANOID-01 的 0.5111 与 PAINT-01 的 grasp 0.0000
.venv/bin/python - <<'PY'
import json
from fde_scope.profiles import get_profile
rows = [json.loads(l) for l in open("examples/quickstart_manufacturing/station_samples.jsonl", encoding="utf-8") if l.strip()]
p = get_profile("manufacturing")
print(f"{'station':<17}{'oee':>8}{'fpy':>9}{'grasp':>9}{'coll':>9}{'dpmo':>9}")
for r in rows:
    k = p.compute_kpis([r])
    print(f"{r['station']:<17}{k['oee']:>8.4f}{k['first_pass_yield']:>9.4f}{k['grasp_success_rate']:>9.4f}{k['collision_intervention_rate']:>9.4f}{k['dpmo']:>9.0f}")
PY

# 幕 6:没有证据门 —— gate check 明说"这个阶段没有门"(退出码 0)
.venv/bin/python -m fde_scope.cli gate check eng-swift-ticket-seed05

# ── 备用幕(S6 卡点/答疑用,非必讲)────────────────────────────────
# 无 key 跑真模型:直接拒绝开工,退出码 2(不会静默降级)
.venv/bin/python -m fde_scope.cli eval --agent mimo --test-set /tmp/fde-d5-demo/test_set_a.jsonl

# 文件名写错:RAW FileNotFoundError + 完整 traceback(呼应 .jsonl.txt 的坑)
.venv/bin/python -m fde_scope.cli eval --agent mock --test-set /tmp/fde-d5-demo/nope.jsonl

命令与预期输出对照(讲师速查)

幕 命令 必出现的证据 退出码
1 eval --agent mock --test-set test_set_a.jsonl intent_accuracy 1.000 · escalation_rate 0.200 · ⚠ Top bad case category: 门店投诉 0
2 同上但用 test_set_b.jsonl intent_accuracy 0.000 · escalation_rate 0.250 · Top bad case 退款售后 0
3 加 --accuracy 0.0 后 diff 无输出(两份逐字节相同) 0
4 for i in 1 2 3 循环 三次关键行完全一致 0
5a kpi eng-southbay-manufacturing-seed03 … oee 0.7236 · grasp_success_rate 0.7931 0
5b kpi eng-swift-ticket-seed05 × 工业样本 工单表 四行全 0.0000,不报错 0
5c 逐工位脚本 ASSY-HUMANOID-01 0.5111 · PAINT-01 grasp 0.0000 0
6 gate check eng-swift-ticket-seed05 Phase 'prototype_real_data' has no gate. 0
备 eval --agent mimo(无 key) LLM not configured: set FDE_SCOPE_MIMO_API_KEY … 2
备 eval --test-set …/nope.jsonl FileNotFoundError: … '/tmp/fde-d5-demo/nope.jsonl' 1

互动设计

  • 幕 1 结束:举手投票——"这张表里哪个数字是真的?"(先投,再点破;投放完再讲,效果差十倍)
  • 幕 3 结束:停 10 秒,让学员在群里打一个词形容此刻感受(预期出现:"离谱 / 后怕 / 原来如此")
  • 幕 5 结束:抛一句给 B 组——"如果这是你们厂的真实数据,你明天早上先敲谁的办公室门?"(答案要落到 ASSY-HUMANOID-01,不接受"整体优化")
  • 全程不许念指标定义——定义在 12 §1.4,自己看。讲台上只说这个数怎么来的 / 能不能信

学员动作(现场)

  • 边看边记六句话(每幕一句,就是板书那六行)——S6 的报告里要引用
  • 幕 1 结束前,把自己 S1 写的"最怕看到的数字"对一次:是被点破了(好),还是没被点到(记下来,S6 问助教)
  • 幕 3 结束前,在自己笔记上写下一行:"如果我的评估里只有一个真信号,那个信号是:________"
  • 幕 5 结束前,写出**"我要先修的那个工位 / 那类单子"**——它就是你 S3 的 Top1 bad case 的候选

常见错误与纠偏

错误 纠偏(讲师/助教用)
有学员喊"1.000 不是挺好吗" 别驳,反问:"这个 1.000 是怎么算出来的?" 让他自己翻到 12 §2.4「读表前必看」
学员看到 0.000 就慌 先分类再下结论:全错 / 没这一列 / 真的一条都没发生——三个问题按顺序问一遍
有人问"那我到底该看哪个指标" 一句话:"先看那个你觉得最难看的,再看它是不是真的。"
讲师跑 5b 时把"全 0.0000"说成工具 bug 必须纠正:这是口径没对齐,工具不替你把关(这是 G5 ① 需要人扛的直接理由)
有人要求现场跑 --agent mimo 不跑(没 key,退出码 2)。告诉他:12 §3.5 有记录,课后到个人环境试
学员把 mock 的 0.7500 抄进作品集 立刻拦住,念 12 §2.4 的 ⚠ 原话:"别把 mock 跑出来的任何数字写进作品集。"

承接语(最后 30 秒)

"25 分钟,六幕。你们现在手里有六句话,和一张你自己的测试集。 接下来 35 分钟,我不说话——你们跑,我们(助教)扮客户。 记住一件事:今天你只要能说清'我怎么知道的',你就赢了;说得再好听说不清,等于没说。"

学员笔记要点

  • 六幕六句(板书原文抄一遍):
    1. 全绿的表,九行是填充物——唯一真信号是 escalation_rate
    2. expected_category 填错版本 → 假 0.000(子串匹配;mock 从不报类别名)
    3. 最差的 agent 也能拿满分卷——指标好看 ≠ 系统好
    4. 可复现 = 不随机,不是"结果好"(同命令同结果)
    5. 平均分掩盖 bad case(0.7236 藏着 0.5111);0 有三种含义
    6. 工具里没有证据门——G5 三条是人判的
  • 0.000 的三种含义:全错 / 没这一列 / 真的一条都没发生
  • 我的 0.000 自查顺序:这个数怎么算的 → 这一列存在吗 → 真的是 0 吗
  • 一条纪律:mock 的数字不进作品集(它是管道验证器,不是效果证明)
  • 我的 Top1 bad case 候选:________________(来自幕 5 的"先修哪一个")

S3 · 上手(35–70 min · 35 min)

本节定位:学员第一次独立跑评估并给自己挖坑。讲师退到助教位;助教进入"扮演模式"——这一次的角色是反对的业务主管(07 §4.2),从本节后半段开始巡场发难。

一句话目标(开场念):"35 分钟,三件事:造 5 行数据、跑一遍、录 2 分钟。不许改数据让它好看——难看的地方,就是你今天最值钱的产出。"

分组建档复核(讲师,1 分钟)

D2 已分好组,本节只复核,不重分。D5 两组跑的指标完全不同,务必分开投屏:

组 案例(D2 定稿的委托单) 今天跑的指标 命令
A 组 案例 B · 迅捷出行(网约车 · ticket) 意图准确率 / 采纳率 / 升级率 / 平均时长 kpi eng-swift-ticket-seed05 --samples <自造样本>
B 组 案例 C · 南湾汽车(整车厂 · manufacturing) OEE / FPY / DPMO / 抓取成功率 / 碰撞率 kpi eng-southbay-manufacturing-seed03 --samples examples/quickstart_manufacturing/station_samples.jsonl(只读)

⚠️ 讲师提醒:B 组今天不改样本,只做拆解——从聚合 0.7236 里找出 ASSY-HUMANOID-01。 A 组今天必须自造样本(4 行就够)——因为**"字段不匹配会静默出 0"这个坑,只有自己填过字段的人才会记住**。 两组数据在 S4 复盘时要互换解释(A 组讲"升级率意味着什么",B 组讲"OEE 拆到工位意味着什么")。

分钟级时间盒(学员视角)

分钟 动作 交付到哪一步
0–5 写 5 行 test_set.jsonl(版本 A:不含 expected_category) 测试集 v1(G5 ① 的地基)
5–12 跑 eval --agent mock;抄下三条真信号(escalation_rate / Top bad case / 哪些是默认值) 评估结果底稿(🎯 ②)
12–20 按组跑 kpi:A 组自造 4 行样本;B 组拆 5 个工位 KPI 对照表
20–28 写 Top3 bad case 四要素(现象 → 根因假设 → 下一步动作 → 预计改善) Bad Case 清单(G5 ②)
28–33 录 ≤2 分钟原型演示(或写演示脚本),跑在真实数据原型上 原型证据(🎯 ①)
33–35 自查 G5 三条 + 命名 + 准备 S4 ——

⚠️ 助教巡场时序(三趟,每趟约 10 分钟,覆盖全部桌): 第一趟(38–48 min)以反对的业务主管身份,专问一句 "你说这个数——统计的是哪批数据?谁标注的?"(07 §4.2 原话); 第二趟(48–58 min)看 Top3 的**"下一步动作"**是否可执行("再优化一下"不算动作); 第三趟(58–70 min)只做一件事:找一份"只有现象没有动作"的 bad case 清单,当场指出来(这就是 ② 不过的样子)。

讲稿要点

① 0–5 min|先删 expected_category,再动手

"动手前,先把昨天那份 test_set.jsonl 打开看一眼——如果你的文件里每一行都有 expected_category, 现在把它删掉。(12 §2.4:版本 B 只在 --agent mimo 时用。) 为什么?你们刚在幕 2 看过:填上它、再用 mock 跑,你会得到一个 0.000 的假分数, 而那个 0.000 什么也没测——它测的是'mock 不说类别名',不是'系统不行'。"

给三条起步纪律(照 12 §2.4 的零基础三步走):

  1. 5 行就够起步——从你自己的 D3/D4 数据里挑 5 条真实感最强的(虚构或脱敏)
  2. 存成 .jsonl,记事本存文件时把类型改成"所有类型",否则会存成 .jsonl.txt(实测报 FileNotFoundError,见卡点急救)
  3. 一行一个 JSON,id 和 input 必填,其余按需——category 不填就是 uncategorized

"还在措辞上有疑问的,看 12 §2.4 的字段表。今天不许在这个环节花超过 5 分钟—— 测试集是会长大的,不是一次写对的。"

② 5–12 min|跑一遍,然后分清"真信号"和"默认值"

"跑完之后,别看总分,先做两件事: 第一,圈出表里唯一的真信号——就是你在数据里真填过字段的那一行。多数人只有一行。 第二,把'默认值'全部划掉——不是删,是划掉,让它们留在纸上。 因为G5 ① 要的不是好看的表,是一张你自己读得懂的表。"

给学员一张"读表三步"(贴在屏幕上,S6 还要用):

步 问 如果答案 那么这个数
1 这一行的字段,我在数据里填过吗? 没填 默认值,划掉(= 没测)
2 填了的话,判分口径是什么?(子串?阈值?) 说不清 不许写进报告
3 换一批数据,这个数会变吗? 不会 它是常数,不是指标

"第三问是照妖镜:一个不随数据变化的数字,不是指标,是背景噪音。"

③ 12–20 min|按组跑 kpi:两个战场,两种口径

A 组(ticket)——自造 4 行样本,亲手踩一次字段坑:

# 先故意用"看起来像"的字段名跑一遍(观察:全 0.0000,工具不报错)
.venv/bin/python -m fde_scope.cli kpi eng-swift-ticket-seed05 --samples /tmp/fde-d5-demo/ticket_samples.jsonl

# 再换成正确字段名(intent_correct / adopted / escalated / handle_time_seconds)
.venv/bin/python -m fde_scope.cli kpi eng-swift-ticket-seed05 --samples /tmp/fde-d5-demo/ticket_samples_ok.jsonl

正确字段的 4 行样本(虚构,直接照抄就能跑):

{"id": "s-1", "intent_correct": true,  "adopted": true,  "escalated": false, "handle_time_seconds": 240.0}
{"id": "s-2", "intent_correct": true,  "adopted": false, "escalated": false, "handle_time_seconds": 300.0}
{"id": "s-3", "intent_correct": false, "adopted": true,  "escalated": true,  "handle_time_seconds": 420.0}
{"id": "s-4", "intent_correct": true,  "adopted": true,  "escalated": false, "handle_time_seconds": 180.0}

预期结果(实测):

│ intent_accuracy     │   0.7500 │ 意图识别准确率         │
│ reply_adoption_rate │   0.7500 │ 回复采纳率             │
│ escalation_rate     │   0.2500 │ 人工升级率(越低越好) │
│ avg_handle_time     │ 285.0000 │ 平均处理时长           │

"看着四个数,回答两个业务问题:① 这四条里,有几条最后还得人来收尾?(1 条,25%) ② 平均每条花多久?人工基线是 480 秒(8 分钟)——我们省了多少?(285 秒 ≈ 省了 41%) 这就是'业务口径':同一个 285,工程视角叫'平均处理时长',业务视角叫'你们说省时间,省在哪、省多少'。"

B 组(manufacturing)——只做拆解,找"最该先修的那一个":

"B 组今天不写数据,做侦探:给定的聚合 OEE 0.7236 里,藏着 5 个工位。 把它拆开,回答一个问题:如果明天只能修一个工位,修哪个?用哪两个数字支撑你的结论?"

(预期结论:ASSY-HUMANOID-01(OEE 0.5111 / 碰撞率 0.0321);数据里它还标注着"新部署、还在爬坡"—— 这正是'根因假设'的入口。)

④ 20–28 min|Top3 bad case:把"最该先修的 3 个"讲成"烧钱最快修的 3 个"

念 05 §4 D5 第 2 条(原话):

"bad case > 平均分:把'最该先修的 3 个'讲成'烧钱最快修的 3 个'。"

四要素按 12 §2.5 模板,一条一条写:

要素 写法 反面(= G5 ② 不过)
现象 "方言表达'退货咯咋个弄嘞'未识别(7 条命中同类)" "识别效果不佳"
根因假设 "训练语料无方言改写样本,模型对口语变体不敏感" "模型能力不行"
下一步动作 "补 60 条方言改写语料,D7 前跑一轮对比" "后续优化"
预计改善 "该类意图准确率预计 0.62 → 0.80" "会有提升"

"'下一步动作'这一格是 G5 ② 的判分点——它必须满足三个条件:有人做、有数量、有期限。 '补 60 条、D7 前、跑一轮对比'——三个都有。'后续优化'——一个都没有。这就是过和不过的距离。"

顺手把 bad case 的出处说清(免得学员以为是玄学):

"今天你看到的 ⚠ Top bad case category: 门店投诉 和'建议补充 ~50 条', 是工具按失败条数 × 30、封顶 300、下限 50 的机械公式算出来的(fde_scope/eval/bad_case_miner.py)。 所以它可能说'补充 uncategorized 类语料 ~90 条'这种废话——它是线索,不是结论。结论是你的。"

⑤ 28–33 min|原型证据:≤2 分钟,跑在真实数据原型上

"🎯 产出 ① 只要一样东西:一个能演示的原型 + 一段 ≤2 分钟的演示。 今天不要求真模型——mock 也行,哪怕是你把 S2 那条命令录一遍。 但有一条硬要求:录屏里必须出现'真实数据原型'——你们自己那批脏数据(脱敏的),不是为了演示而挑干净的那 5 条。 为什么?因为反模式 Demo-Debt 的反制手段就一句(12 §1.6 #4):在真实脏数据上做原型,不搭布景。 录屏的三条规范:① 不出现真实客户名 / PII / 域名 ② 时长 ≤2 分钟 ③ 结尾一句'这段演示证明了什么'。"

三种可接受的演示形态(学员任选):

形态 怎么做 适合谁
A 终端演示 录 eval + kpi 两条命令的真跑过程 最快,5 分钟能出
B Web 工作台 fde-scope web 本地起前端,走一遍 engagement 视图 想展示"交付物长什么样"
C 方案投屏 不上工具,用 deploy --dry-run 的计划输出讲"部署时会做什么" 环境不方便录屏的

讲师提醒:录屏前 3 秒检查——姓名、公司 logo、文件路径里的客户名、终端历史里的 key。 这条和 11 §6 是同一条红线,违规 = 数据合规事故。

⑥ 33–35 min|自查 G5 三条 + 命名

  • 念 G5 三条原文(03 §3),逐条点名:

    ① 评估可复现(同命令同结果)(blocker) ② bad case Top3 每条含"下一步动作"(blocker) ③ 有一页"验证记录"(含被拒绝的需求)(warning)

  • 命名规范(S5 会再念一次,这里先写在屏幕上): D5-姓名-评估报告 / D5-姓名-BadCase清单 / D5-姓名-验证记录(+ 录屏文件 D5-姓名-原型演示.mp4)
  • 35 分钟到点即停——没写完的进 S6,不许占用 S4 的演练时间

投屏·板书

  • 左半屏:读表三步表(这个数填过吗 → 口径是什么 → 换数据会变吗)
  • 右半屏:Top3 四要素表(现象 / 根因假设 / 下一步动作 / 预计改善)+ 一行红字 "再优化一下"不算动作
  • 白板下方:两条命令并排(eval / kpi),中间画箭头写 "管道 vs 业务"
  • 停车位保持开放(预期新增:召回、F1、A/B、显著性)
┌────────────────────────────┬──────────────────────────────────┐
│ 读表三步                   │ Top3 bad case 四要素             │
│ 1 这行的字段我填过吗?      │  现象        ← 有数量(7 条命中) │
│ 2 判分口径是什么?          │  根因假设    ← 可被推翻的假设     │
│ 3 换数据会变吗?            │  下一步动作  ← 有人做/有数量/有期限│
├────────────────────────────┴──────────────────────────────────┤
│ eval(管道通不通)  →→→  kpi(业务动没动)                      │
│ ⚠ "再优化一下"不算动作 | mock 的数字不进作品集                │
├───────────────────────────────────────────────────────────────┤
│ G5:① 可复现(blocker) ② Top3 带动作(blocker) ③ 验证记录(warning)│
└───────────────────────────────────────────────────────────────┘

互动设计

  • 第一趟巡场(助教 = 反对的业务主管):只问一句、只问一遍—— "你说这个数——统计的是哪批数据?谁标注的?"(07 §4.2 原话) 学员答上来了:承认一部分,然后换角度继续问(不许一次放行);答不上来:"那你准备怎么查、什么时候给答复?"
  • 中间穿插一次全班快问(约 15 分钟处):"现在,谁的 Top3 里三条都有'下一步动作'了?举手。" (预期只有 1/3 举手——这个数字本身要念出来,作为 S4 的开场素材)
  • B 组内部互查:两人交换"我为什么选这个工位",必须互相复述对方的两个支撑数字

学员动作(现场)

  • 5 行 test_set.jsonl(版本 A)落盘
  • 跑通 eval --agent mock,抄下三条真信号(含哪些是默认值)
  • 按组跑 kpi(A 组自造 4 行;B 组拆 5 工位)
  • 写 Top3 bad case 四要素(至少 1 条有完整"下一步动作")
  • 录/写 ≤2 分钟原型演示(真实数据原型;不出现客户名与 PII)
  • 自查 G5 三条,按命名规范改文件名

常见错误与纠偏

错误 纠偏(助教用)
学员把 expected_category 留在 5 行里,跑出 0.000 后想删数据重来 拦住:"别删,把这次 0.000 记下来——它就是你的第一条'假分数'教材。删掉 expected_category 再跑一遍,两份都留着"
有人问"我的 bad case 就是模型不行,怎么写根因" "'模型不行'不是根因,是无法反驳的结论。 换成能被推翻的假设:'缺方言样本'——这个明天就能验证"
Top3 写成三条同因 提醒:"Top3 是三个'烧钱最快'的点,不是三条同义句。 如果三条都在讲方言,合并成一条,再去找第二、第三个"
学员说"我没有真数据,拿什么做真实数据原型" "就用课程虚构数据 + 你自己写的脏话变体(像 我要退货咯,咋个弄嘞)。重点是数据是脏的,不是数据是谁的"
有人把 A 组的样本喂给 B 组的 engagement 现场演示幕 5b:全 0.0000,不报错——"看,工具不会拦你。这是它今天教你的最后一课"
录屏里出现了真实客户名 立即要求删除重录,并记录合规日志(11 §6.7)——不做例外

承接语(最后 30 秒)

"停。合上电脑。 刚才助教上来问了你们一句:'这个数统计的是哪批数据?谁标注的?'—— 这句话,接下来 10 分钟只会问得更狠。 站起来活动一下手腕,你马上要用数据跟一个不想听你讲技术的人对话。"

学员笔记要点

  • 今天的 eval 表里,真信号有 __ 行,默认值有 __ 行(自己数)
  • 读表三步:填过吗 → 口径是什么 → 换数据会变吗
  • Top3 四要素模板(现象 / 根因假设 / 下一步动作 / 预计改善)+ 判分点:"下一步动作"必须有人做、有数量、有期限
  • 我选的"最该先修"的那一个:____________(A 组:哪类单子 / B 组:哪个工位)
  • 原型证据三条规范:不出现客户名/PII · ≤2 分钟 · 结尾一句"证明了什么"
  • G5 三条 + 命名规范(D5-姓名-评估报告 / -BadCase清单 / -验证记录)

S4 · 复盘(70–80 min · 10 min)

本节定位:把"用数据说话"从个人能力变成集体肌肉记忆——助教当面扮演反对的业务主管(07 §4.2 / §3.4),学员被追问时禁止讲情怀。

一句话目标(开场念):"接下来我问,你们答。谁要是说'我们模型很准的'——我当场换角度再问一遍。"

分钟级时间盒

分钟 动作 目的
70–74 助教示范一轮:抽 1 名学员,用 07 §3.4 的三问连问 让全班看到"追到底"长什么样
74–78 三人一组对练:1 人演学员,2 人轮流念刁难(每组换 2 轮) 全员动嘴
78–80 抽 1 组念"最难的那个问题 + 我的回应";命名反模式收口 把错误变成公共资产

讲稿要点

① 70–74 min|助教示范:三条刁难原话(07 §3.4 逐字)

助教不笑、不寒暄,直接问(学员须用数据回应,禁止讲情怀):

# 助教(反对的业务主管)说 合格的回应必须含 反面(当场点名)
1 "AI 答错了谁负责?出了舆情你们赔吗?" 评估指标 + bad case 率 + HITL 设计 "我们模型很准的,放心"
2 "你们根本不懂我们业务,先把知识库做好再说。" 数据体检结论 + 真实数据原型结果 跟对方争辩
3 "预算砍一半,功能一个不能少。" 成功标准优先级 + 当场划掉哪个放弃标准 全盘答应

(另外两条留给对练:"60% 拦截率太低了,我要 95%" → 基线对比 + 渐进路线 + 反问成本;"上一个供应商的 Pilot 做了半年,然后没有然后了" → 时间盒 ≤90d + 验收清单 + 明确 done)

扮演纪律(讲师必须提前跟助教对齐,07 §3.4 原话):

"助教必须追到底——学员一给数字就换角度再问;学员说'不知道'时,追问'那你准备怎么查、什么时候给答复'(诚实 + 行动 = 通过)。"

暗号(只在学员说对时松口,07 §4.2 原话):

学员说 "我们可以在 90 天验收清单里加这一条" → 助教松口:"这条我要签字。"

② 74–78 min|三人一组对练

  • 每组 3 人:1 人当学员,另外 2 人轮流念刁难,念的人不许自己编——照着屏幕上的五条念
  • 学员的硬规则(写屏幕上):
    1. 不许讲情怀("我们很有热情""一定会努力")
    2. 不许裸承诺("95% 我们能做"——除非能给出基线与路径)
    3. 说"不知道" = 合法,但必须补一句 "我 X 时间前给你答复"
  • 两轮后换人,保证 3 人都被问过一次

③ 78–80 min|抽组念 + 命名反模式

抽 1 组,只念两样东西:最难的问题 + 我们当时的回应。

抓到的模式 命名(12 §1.6) 现场替换
"放心,我们很准的" No HITL(假设全自动) "关键决策留人确认:退款 > 政策线走人工"
被"预算砍半"一问就全答应 Scope Creep "每加一项,砍一项;我当场划掉 X"
"这个演示效果特别好" Demo-Debt "这是真实脏数据上的结果,难看的部分在这儿"

投屏·板书

  • 屏幕五条刁难原文(07 §3.4),一屏放下,对练全程不切屏
  • 右侧三行红字: ① 不许讲情怀 ② 不许裸承诺 ③ "不知道"+时限 = 通过
  • 底部一行:暗号:"我们可以在 90 天验收清单里加这一条" → "这条我要签字。"

互动设计

  • 助教示范时,让全班当"裁判":每人手里举个牌子(或群里打 1/0),判断"刚才这句是用数据还是用情怀"
  • 对练期间讲师走动听,只挑三种人:说得最早停的、笑得最多的、说"我们很准"的——各请一组复演一遍
  • 结尾全班齐念一遍三行红字(今天唯一一次齐念,效果比讲三遍好)

学员动作(现场)

  • 被助教/同伴追问至少 1 轮,当场记录自己答不上的那一个问题
  • 把应答改写成一版"带数字"的(例:"拦截率 60% 是有基线支撑的——人工现在 42%,我们目标 60%")
  • 写下一条可加进 90 天验收清单的条款(哪怕是"每季度复核一次 bad case 清单")
  • 在群里按 07 §5 格式发一条点评(只点评同伴,不点评自己)

常见错误与纠偏

错误 纠偏
学员被问住后开始道歉 打断:"不用道歉,给动作。 你要说的只有一句:'我什么时候给你答复、怎么查'"
学员反过来质疑客户"你们不懂技术" 这是本节最严重的问题——当场停:"跟客户辩技术,是最贵的一种输。 你要做的是把对方的情绪翻译成条件"
助教一次就放行 讲师当场提醒暗号纪律:"学员一给数字就换角度再问"——放行即失职
有学员始终不开口 助教单独陪练 1 分钟(不点破、不说名字),只问最简单的第 5 条

承接语(最后 30 秒)

"今天最难的十分钟过去了。你们被问住了几次,我不关心—— 我关心的是:你有没有一次是用数据把问题顶回去的。 接下来 10 分钟,把今天所有东西封箱。顺便预告一句:明天,你要为凌晨 2 点还在值班的人写文档。"

学员笔记要点

  • 五条刁难里,我答不上来的那一句:____________
  • 三行纪律:不许讲情怀 · 不许裸承诺 · "不知道"+时限 = 通过
  • 我的"带数字回应"改写版(一句话):____________
  • 暗号条款(可加进 90 天验收清单):____________
  • 今天被点名的反模式:No HITL / Scope Creep / Demo-Debt(各对应什么,写一行)

S5 · 布置 G5 + 明日预告(80–90 min · 10 min)

本节定位:收口 + 交底。念清 G5 三条、命名规范、截止与补交;埋 D6 三个钩子。

一句话目标(开场念):"今天收的是证据:一条能重跑的命令、三个带动作的坏例、一页敢写拒绝的记录。"

分钟级时间盒

分钟 动作 目的
80–84 念 G5 三条(①② blocker / ③ warning)+ 命名规范 + 截止 让判据不可含糊
84–87 验证记录模板(12 §2.6)投屏逐行讲 ③ 是 warning,但答辩要看
87–90 D6 三个钩子 制造明天的注意力缺口

讲稿要点

① 80–84 min|G5 三条 + 命名 + 截止

  • G5 原文(03 §3,逐字念):

    ① 评估可复现(同命令同结果)② bad case Top3 每条含**"下一步动作"** ③ 有一页**"验证记录"**(含被拒绝的需求) —— ①② blocker;③ warning。

  • 点名各自的不通过形态(学员最需要听的):
    • ① 不过:给不出命令 / 给不出测试集 / 换台机器跑不出来
    • ② 不过:Top3 里有任何一条只写现象不写动作;动作里没有人、数量、期限三要素
    • ③ 扣分:验证记录里只写"我们接受了 A、B、C"——没有一条"我拒绝了什么"(12 §2.6 原话:"被拒绝的需求要写进来。答辩评分表里'边界感'一项,看的就是你敢不敢写'我拒绝了什么'。")
  • 命名 + 提交物清单(四个文件,一次说清):
提交物 文件名 对应 G5
评估报告(指标表 + 真信号/默认值标注) D5-姓名-评估报告 ①
Bad Case 清单(Top3 × 四要素) D5-姓名-BadCase清单 ②
验证记录(一页) D5-姓名-验证记录 ③
原型演示(≤2 分钟视频或演示脚本) D5-姓名-原型演示.mp4 🎯 ①
  • 截止与补交(与 D4 同规则,复述一遍):直播次日 21:30 前提交;24 小时内补交 = 正常放行(标注"补交通过");逾期 = 延期通过(作品集等级最高 B);豁免进证书备注。

② 84–87 min|一页验证记录:四行表(12 §2.6)

投屏这张表,逐行讲怎么填:

时间 演示/验证对象(角色) 结果 下一步
D5 上午 客服主管(钱锋角色) 接受 纳入 90 天验收清单
D5 上午 数据总监(邓琳角色) 接受(附条件) 补 PII 处置说明
D5 下午 运维负责人 拒绝(理由:无回滚方案) 不做,转 D6 讨论
D5 下午 业务 VP(罗成角色) 未决 下次评审给答复

汇总一行(照抄结构):"演示 3 次覆盖 3 类角色;接受 2 项,拒绝 1 项;未决 1 项。"

"注意第三行——'拒绝'那行是这页纸的重点。它不是'我们没做',是'我们决定不做,并写了理由'。 这两者在答辩现场的差别是:一个叫边界感,一个叫漏项。"

③ 87–90 min|D6 三个钩子

念 05 §4 D5 第 3–5 条与 D6 引子(原话):

  1. (角色扮演收口)"今天你们被反对过一次了。明天开始,你要为凌晨 2 点值班的人写文档。"
  2. "先想一个问题,明天开场我要问:'你走了以后,谁修?'"
  3. "还有一个更难受的问题留给你:你今天这套东西,半夜三点坏了——修它的人认识它吗?"

补一句与工具相关的预告(别破梗,只说现象):

"另外,明天我们会碰到一个今天完全没碰的字母组合:SLO。 你们今天跑出来的 escalation_rate 0.2500、avg_handle_time 285,明天要变成一纸承诺—— 承诺里会写清楚'坏了多久算坏、谁来修、修不好怎么办'。今天先睡,明天见。"

投屏·板书

  • 左:G5 三条(①② 标红 blocker,③ 标黄 warning)+ 四件提交物名
  • 右:验证记录四行表(拒绝那行加粗)
  • 底部:D6 三个问题("你走了以后,谁修?" / "半夜三点坏了,谁看?" / "SLO 是什么?")
┌────────────────────────────────┬──────────────────────────────┐
│ G5(03 §3)                    │ 一页验证记录(12 §2.6)      │
│ ① 可复现      🔴 blocker        │ 时间|对象(角色)|结果|下一步 │
│ ② Top3 带动作 🔴 blocker        │ … | 运维负责人 | 拒绝 | 不做 │
│ ③ 验证记录    🟡 warning        │ 汇总:接受 2 拒绝 1 未决 1    │
├────────────────────────────────┴──────────────────────────────┤
│ 四件:评估报告 · BadCase清单 · 验证记录 · 原型演示             │
│ 截止 次日 21:30 | 24h 内=正常放行 | 逾期封顶 B | 豁免进证书  │
├───────────────────────────────────────────────────────────────┤
│ D6 三问:你走了以后谁修?|半夜三点坏了谁看?|SLO 是什么?      │
└───────────────────────────────────────────────────────────────┘

互动设计

  • 念完 G5 后问一句:"今天谁的 Top3 还没有一条完整'下一步动作'?举手。"(不点名,只记数字——S6 助教会重点盯这部分人)
  • 验证记录环节让大家当场写一行:"我今天已经拒绝过的一项需求是:______"(写不出来的人,S6 优先补这一条)
  • D6 预告用沉默收尾:问完"你走了以后,谁修?"停 3 秒再下课

学员动作(现场)

  • 记下四件提交物的准确文件名与截止时间
  • 当场写一行:我今天拒绝的需求是:____________
  • 在日历上标 D6 日期 + "带齐 D5 四件"
  • 群里回一句:"四件齐。" 或 "还差 ____。"(诚实报缺口)

常见错误与纠偏

错误 纠偏
学员问"验证记录是 warning,能不能不交" 不劝——只说一句(12 §2.6):"答辩评分表里'边界感'一项看的就是它。"
有人说"我没有拒绝过任何需求" 这是最常见的假通过信号——追问:"客户提过要全自动吗?你说'先留着人工复核'了吗?那就是一次拒绝。"
学员想用 D4 的语料报告代替评估报告 明确区分:D4 报告测"数据",D5 报告测"系统"——两码事,都要交
助教替学员写 Bad Case 不许。助教只能问"你这条的动作、数量、期限分别是什么?"

承接语(最后 30 秒)

"今天你们第一次用证据说话。明天开始,你要为凌晨 2 点值班的人写文档。 下课。四十五分钟自练,助教在群里。"

学员笔记要点

  • G5 三条(①② blocker / ③ warning)+ 各自的不通过形态
  • 四件提交物文件名 + 截止 + 补交规则
  • 验证记录四行表结构;"拒绝"那一行是重点
  • 我今天拒绝的需求:____________
  • D6 三问(抄一遍):
    1. 你走了以后,谁修?
    2. 半夜三点坏了,谁看?
    3. SLO 是什么?

S6 · 自练(+45 min)

本节定位:独立完成、自评、提交。目标只有一个:四件产出都能过 G5 ①②,验证记录过 ③。

一句话目标:把"跑过了"变成"扛得住追问"。

45 分钟怎么分(投屏建议)

分钟 干什么 产物
0–10 补齐 Top3 bad case 四要素(重点是**"下一步动作"的人/数量/期限**) D5-姓名-BadCase清单
10–18 标注评估报告:真信号 vs 默认值,每个数带出处 D5-姓名-评估报告
18–28 写一页验证记录(含至少 1 条被拒绝的需求) D5-姓名-验证记录
28–38 录/剪 ≤2 分钟原型演示(检查:客户名?PII?域名?) D5-姓名-原型演示.mp4
38–43 自评 G5 三条 + 逐条打钩 + 改文件名 ——
43–45 提交 + 群里发 60 秒收获 提交

三条路径(学员按自己情况选一条)

路径 谁选 做什么
A 完成 大多数人 四件产出齐活 + 提交(别加戏,先交出去)
B 迁移 手里有已脱敏且经公司同意的数据 把真实业务数据做成 5 行 test_set.jsonl 跑一遍;报告里只写统计与结论,不贴原始样本;不得投屏、不得传群、不得进任何第三方工具(11 §6.1);录屏前 3 秒自检客户名/PII
C 加练 想再挖一层 ① 把 --accuracy 从 0.9 调到 0.0 再跑一次,逐格对比两次表格,写 100 字说明"为什么 mock 的数字不能进作品集";② 给你的测试集补上 handle_time_seconds 与 csat,观察 avg_handle_time 与 customer_satisfaction 两行怎么从默认值变成真信号。练的是:一眼分辨真信号与默认值

路径 C 的第二步特别值钱:你会亲手看到"同一张表,加上两列字段,两个数字就从假变真"—— 这就是"评估设计"这个词的全部含义。

完成标准(提交前逐条打钩)

☐ 测试集 5 行以上,且是版本 A(不含 expected_category)
☐ 评估报告里每个数字都标了【真信号】或【默认值】,真信号附一行"怎么算的"
☐ Top3 bad case 每条四要素齐全;"下一步动作"三要素:有人做 / 有数量 / 有期限
☐ 一页验证记录四行表填满;至少 1 条"被拒绝的需求"(含理由)
☐ 原型演示 ≤2 分钟,跑在真实数据原型上;无客户名 / 无 PII / 无域名
☐ 全程没有把 mock 的数字当作"效果证明"(措辞自查:"验证了管道"而不是"证明了效果")
☐ 命名:D5-姓名-评估报告 / -BadCase清单 / -验证记录 / -原型演示.mp4

卡点急救

卡在哪 怎么救
FileNotFoundError: ... 'xxx.jsonl' 99% 是存成了 .jsonl.txt(记事本默认存"文本文档")——把类型改成"所有类型",或存完重命名去掉 .txt(12 §2.4 零基础三步)
表格里怎么全是 1.000 / 3.000 / 0.000 这是默认值三兄弟,不是错误。对照 12 §2.4「读表前必看」逐行划掉,只留真信号。要看到真信号就填字段:adopted / escalated / handle_time_seconds / csat
intent_accuracy 恒 0.000 先查是不是留了 expected_category:删掉它(mock 路线);或改 --agent mimo(需要 key,共享终端不许填)
想跑 --agent mimo 但没 key LLM not configured … + 退出码 2(拒绝开工,不会静默降级)。课后到个人环境配 key 再试;12 §3.5 有完整记录
kpi 跑出来全是 0.0000 两种可能:① 字段名不匹配(拿工单 KPI 表对比样本字段:intent_correct / adopted / escalated / handle_time_seconds)② engagement 不存在(报 Engagement not found,退出码 2)。工具都不会替你把关
在 /tmp 里跑 kpi 报 Engagement not found kpi 认的是 .fde_scope/——命令从仓库根执行,样本用绝对路径
不知道"根因假设"怎么写 写一个明天能被推翻的句子:不写"模型不行",写"缺 X 类样本"——推翻它的动作就是"补 X 类样本再跑一次"
录屏老超 2 分钟 砍掉开场客套——只留三样:跑命令 → 指一个数字 → 说"这证明了什么"。2 分钟够用
"我拒绝的需求写什么?" 从演练里抄:拒绝"全自动"(改 HITL)、拒绝"95% 拦截率"(改渐进路线)、拒绝"砍预算不砍功能"(改放弃标准)——选你真说过的那一条

助教值守规则

  • 只回答两类问题:① 规则类(命名 / 截止 / 字段 / 报错 / 数字对不上)② "这条算不算'下一步动作'"
  • 不回答:D6 之后的方案类问题;"我能不能不交 ③"这类豁免请求(③ 是 warning,交不交自己决定)
  • 每 15 分钟在群里发一次进度提示("还有 30 / 15 / 5 分钟")
  • 收到提交后只回一个字:✓(讲评在次日 08:30 门禁榜 + D6 回炉)
  • 提交里出现真实客户名 / PII / 真实 key → 立即私聊要求撤回重交,并记录合规日志(11 §6.7)
  • 学员问"我这评估算通过吗" → 只回一句:"① 能重跑吗?② 三条都有动作吗? 两条都是'是',就是过。"

学员动作

  • 45 分钟独立完成(路径 A / B / C 三选一)
  • 自评 G5 三条 + 完成标准逐条打钩
  • 提交 → 收到 ✓
  • 在群里写 60 秒收获(照 07 §5 模板): 「对方最难的那个问题是什么?我用了什么回应?下次我会改什么?」

常见错误与纠偏

错误 纠偏(助教用)
报告写成"工具输出汇编" "工具给你的你都贴了,工具给不了的呢? 真信号/默认值的判断、Top3 的根因、拒绝的理由——这三样才是你的报告"
把 1.000 当成绩写进结语 递「读表前必看」表,让他自己划掉,然后问:"划掉之后,你手里还剩几个真数字?"
Top3 全是同一类(如全是方言) "合并成一条,再找两条别的——Top3 是三个不同的烧钱口"
验证记录只有"接受",没有"拒绝" 追问三连(全自动 / 95% 拦截率 / 砍预算不砍功能),逼出一条真的
21:30 前赶不上 别慌:24 小时内补交 = 正常放行(标注"补交通过")——但要在群里报一句"我补交",别静默
提交里带了真实客户名 撤回重交 + 合规日志,不做例外(11 §6.1 / §6.7)

附 A · D5 板书总图(一天下来的白板应该长这样)

┌────────────────────────────────────────────────────────────────────┐
│  D5 · 验证与评估 —— 我怎么知道它行?                                │
├────────────────────────────────┬───────────────────────────────────┤
│  六幕(S2)                     │  读表三步(S3)                    │
│  ① 全绿的表:九行是填充物        │  1 这行的字段我填过吗?             │
│  ② expected_category → 假 0.000 │  2 判分口径是什么?                 │
│  ③ 最差的 agent 也能拿满分卷     │  3 换数据会变吗?                   │
│  ④ 可复现 = 不随机,非"结果好"   │  → 三问过不了 = 这个数不许写报告    │
│  ⑤ 平均分掩盖 bad case           │                                    │
│  ⑥ 工具里没有证据门 → 人判       │  0 的三种含义:全错 / 没这一列 /     │
│                                 │                真的一条都没发生     │
├────────────────────────────────┴───────────────────────────────────┤
│  真信号 vs 默认值(12 §2.4)                                        │
│  intent_accuracy 没填→1.000 | adoption 没数据→1.000 | FCR 默认 1.000│
│  avg_handle_time 0.000=没数据 | CSAT 3.000=中性中点                 │
│  cost_per_ticket 1.000=与基线持平 | corpus_* 0.000=没接语料报告     │
│  escalation_rate 0.200 = ✅ 真信号(且是坏消息)                     │
├────────────────────────────────────────────────────────────────────┤
│  Top3 bad case 四要素:现象 → 根因假设 → 下一步动作 → 预计改善       │
│  「下一步动作」必须:有人做 · 有数量 · 有期限                        │
│  ⚠ "再优化一下"不算动作 | "模型不行"不是根因(不可推翻)             │
├────────────────────────────────────────────────────────────────────┤
│  实测数字(讲师速查):                                              │
│  eval A: intent 1.000 / escalation 0.200 / Top 门店投诉              │
│  eval B: intent 0.000 / escalation 0.250 / Top 退款售后              │
│  --accuracy 0.9 vs 0.0 → diff 无输出(逐字节相同)                   │
│  kpi 工业: OEE 0.7236 … 拆到工位: HUMANoid 0.5111 / PAINT grasp 0.0000│
│  kpi 工单×工业样本 → 四行全 0.0000,不报错(口径不匹配静默)          │
│  gate check → "Phase 'prototype_real_data' has no gate."(工具无门)│
├────────────────────────────────────────────────────────────────────┤
│  三条红线:[1] 只 3 个新概念 [2] 指标是地图不是成绩单(不许换口径/删坏例)│
│           [3] HITL 必须写进方案(No HITL = 反模式)                   │
│  G5:① 可复现 🔴 ② Top3 带动作 🔴 ③ 验证记录(含拒绝)🟡             │
│  「平均分是用来汇报的,bad case 是用来干活的。」                      │
│  「指标好看 ≠ 系统好。0.000 有两种含义。」                            │
│  停车位:________________________________(今天跑题的术语)          │
└────────────────────────────────────────────────────────────────────┘

附 B · 讲师自查(下课前 5 分钟)

  • ☐ 三条红线全守住了?有没有冒出第 4 个概念却没进停车位(准确率 / F1 / 召回最容易漏)?
  • ☐ S1 的**"我最怕看到的数字"**全班写了吗?
  • ☐ 幕 1 跑完**停 10 秒问"哪个数字是真的"**了吗(先投票再点破)?
  • ☐ 幕 2 的 expected_category 立场说清了吗(版本 A 给 mock / 版本 B 给真模型)?
  • ☐ 幕 3 的 diff 空输出当场跑出来了吗(这是今天最重要的一幕)?
  • ☐ 幕 3 那三个结论(好看≠好 / 0 有两种含义 / mock 数字不进作品集)说出口了吗?
  • ☐ 幕 4 三次重跑真的跑了吗(别口述)?
  • ☐ 幕 5 的 ASSY-HUMANOID-01 0.5111 与 PAINT-01 grasp 0.0000 都指到了吗?
  • ☐ 幕 5b 的"全 0.0000 且不报错"演示了吗(口径不匹配静默)?
  • ☐ 幕 6 的 gate check 输出**"has no gate"**念出来了吗(工具里没有证据门)?
  • ☐ "指标是地图,不是成绩单"(05 §4 D5 第 1 条)说出口了吗?
  • ☐ "bad case > 平均分 / 把最该先修的 3 个讲成烧钱最快修的 3 个"(第 2 条)说了吗?
  • ☐ S4 助教追到底了吗(学员一给数字就换角度)?暗号用了吗("这条我要签字")?
  • ☐ S4 三行纪律(不许讲情怀 / 不许裸承诺 / 不知道+时限=通过)齐念了吗?
  • ☐ 验证记录模板讲了吗?"拒绝"那一行有没有强调?
  • ☐ G5 三条、四件命名、截止、补交规则都念全了吗?
  • ☐ D6 三个钩子埋了吗(你走了以后谁修 / 半夜三点坏了谁看 / SLO)?
  • ☐ kpi 是从仓库根执行的吗(在 /tmp 里会给 Engagement not found)?
  • ☐ 未提交名单记下来了吗(次日 08:30 前私聊)?

下一节:21-D6逐节教案.md(运维化:让东西稳得住) 本日配套:02-逐日教学大纲.md Day 5(时间盒总表)· 06-学员手册与作业包.md D5 任务卡 · 07-实战剧本与案例库.md §2.2 / §3.4 / §4.2 / §5 · 11-工具与环境准备.md §6(数据合规与 PII 红线)· 12-附录-术语表与模板库.md §1.4 / §1.6 / §2.4 / §2.5 / §2.6

21 · D6 逐节教案:运维化(让东西稳得住)

21

course-level-1/21-D6逐节教案.md

①本文件是 D6(90 分钟直播 + 45 分钟自练)的逐节执行稿:讲师按节念、助教按节做;文中所有命令与输出均为本仓库实测。 ②上游时间盒:02 Day 6|通用骨架与控场:05 §2 / §4(D6 五条带教要点) ③模板与术语:12 §1.4(SLO / 错误预算 / 告警路由 / Runbook / 值班交接)· §1.6(#3 Hero Engineer · #7 Probabilistic Degradation)· §2.7(SLO 卡)· §2.8(Runbook)· §2.9(值班交接卡)· §3.5(出错速查) ④演练素材:07 §2.3(案例 C · 南湾汽车)· §3.5(凌晨 2 点盲测剧本)· §5(群内收获模板) ⑤数据红线:11 §6|学员侧任务卡:06 D6|门禁条款:03 §3 G6 行 ⑥本日演示数据:白湖乳业(ticket · SLO 成品 + 3 个残缺变体)与亚特联汽车(manufacturing · Runbook 骨架)——全部虚构|演示工作目录:/tmp/fde-d6-demo(不写进仓库) ⑦⚠ 环境提示(今天必踩):COLUMNS=200 不设则 engage list 的列被截断且不报错;examples/seed_mock_engagements.py 不认 FDE_SCOPE_HOME(先在仓库里 seed,再复制到演示目录)


0. 今天的三条红线(全天不许破)

# 红线 怎么守
1 只准出现 3 个新概念:SLO 与错误预算 · Runbook(事件响应与回滚)· 漂移与监控。第 4 个(SLI / 燃烧率 / MTTR / 混沌工程…)一律进停车位,课后再讲。客户面前说人话:SLO = "坏了多久算坏",错误预算 = "这个月还能坏多久",Runbook = "出事照着做的那张纸" 开课前把停车位画好;每次有人冒新词,笔一指停车位,不上台展开(05 §2)
2 每类事件必须写回滚——只写"怎么修"、不写"修坏了怎么退",= G6 ① 不过(blocker)。判据原文(12 §2.8):"五类事件,每类四段:判断信号 → 处置步骤 → 回滚步骤 → 升级路径。" 巡场第二趟只问一句:"修不好怎么退?" 退不出来的当场标红
3 联系人只写角色,不写真人:primary-oncall / fde-oncall / 客户运维——不许出现真实姓名、手机号、邮箱(与 11 §6 是同一条红线)。被问"出事找谁",不许答"找我就行"(= 反模式 #3 Hero Engineer,12 §1.6) 巡场第三趟只扫联系人列;出现真人信息 = 当场要求替换,不改不签字

今天没有硬性休息:D6 的节奏是"讲 25 分钟 → 写 35 分钟 → 测 10 分钟",写 Runbook 的 20 分钟就是自然喘息点(学员自己在敲字,讲师和助教在巡场,不需要统一喊停)。

为什么今天"不能跳过盲测":G6 四条里,工具只能帮你挡第 ②'条的一半——今天实测 eng-d6-nobudget(SLO 全无错误预算)照样 ✅ PASS,工具对"糊弄"完全静默。第 ①④ 条(每类回滚、盲测通过)工具里连门都没有(实测:Phase 'runbook' has no gate.)。今天的质量全部靠"人读人测"兜底——所以盲测不是仪式,是检验。

今日 6 节课总览

节 时间 一句话目标 学员产出 记忆锚点
S1 回炉 0–10 把 D5 的证据翻篇,直面"你走了以后谁修" 群接龙一条"我最怕接到的凌晨电话" "你走了以后,谁修?"
S2 讲与演 10–35 看懂"工具只挡零、不挡糊弄" 六幕实测记录(6 条输出) "工具里没有 runbook 这门"
S3 上手 35–70 写出 SLO 卡 + Runbook + 值班交接卡 🎯 产出 6 三件套 v1 "每条 SLO 必须有测量方式"
S4 复盘 70–80 用"凌晨 2 点盲测"检验文档 盲测断点清单(≥3 处已修) "凌晨 2 点没人爱你,除了你的文档"
S5 布置 80–90 念清 G6 四条 + D7 预告 记下命名 / 截止 / 三个钩子 "交接是你留在现场的最后一次签名"
S6 自练 +45 独立完成、自测、提交 三件提交物 + 盲测记录 "同事照着能做"

今日产出物(🎯 产出 6):三样东西—— ① SLO 卡(3 条起,每条含目标值 + 测量方式 + 错误预算 + 告警路由) ② Runbook(覆盖 5 类事件,每类四段:判断信号 → 处置步骤 → 回滚步骤 → 升级路径) ③ 值班交接卡(当前状态 / 待办 / 已知风险 / 联系人) —— 一句话:"你走了,系统也能活。"

通关门禁 G6 原文(03 §3): ① Runbook 含 5 类事件且每类有回滚步骤 ② SLO 卡含错误预算 ③ 明确告警路由(谁/渠道/响应时限) ④ 通过"凌晨 2 点盲测"(同事按文档能处理) —— ①②④ blocker;③ warning。 ⚠ 注意 ③ 是 warning:工具侧也没把它当硬门——今天实测 eng-d6-noroute 只亮一条 ⚠️,照样 ✅ PASS · gate=slo。③ 全靠助教巡场兜底。


S1 · 回炉(0–10 min · 10 min)

本节定位:D5 交上来的四件证据里,"评估可复现"和"Top3 带动作"是本节的讲评素材;同时用一问一接龙,把全班从"评估心态"切到"运维心态"——从"怎么证明它行"切到"它半夜坏了我怎么办"。

一句话目标(开场念):"今天不聊效果。今天只聊一件事:你走了以后,谁修?"

分钟级时间盒

分钟 动作 目的
0–3 G5 讲评:一优一劣(各 1 分钟 + 30 秒收口) 把"可复现 / 带动作"两条 blocker 再钉一遍
3–8 开场问 + 群接龙:"你走了以后,谁修?" 沉默 10 秒 → 接龙"我最怕接到的那个凌晨电话" 制造今天的心理入口:文档是给别人用的
8–10 今日地图:三个新概念 + 停车位 + 三件产出 让学员知道 90 分钟后手里会多什么

讲稿要点

① 0–3 min|G5 讲评:一优一劣(05 §2:优的要讲"为什么好",劣的要讲"我也犯过")

  • 优(念原话 + 为什么好):抽一份"Top3 四要素齐全 + 每条动作有人做/有数量/有期限"的。念完追问全班:

    "好在哪里?好在换个人接手也能看懂。 记住这句——今天你要做的事,就是把这个标准推到运维文档上。"

  • 劣(不点名):找一份"Top3 只写现象、没写动作"或"验证记录只写接受了什么、没写拒绝了什么"的:

    "这份我第一天也这么写——现象是感受,动作才是承诺。 今天三件产出,我会用同一把尺子量:你写的每一句,别人照着能做吗?"

② 3–8 min|开场问 + 群接龙(05 §4 D6 第 1 条原话:'"你走了以后,谁修?" 让沉默 10 秒再继续。')

  • 念完问题真的沉默 10 秒(盯着秒表,不许救场)。10 秒后不点名、不评价,直接发群接龙:

    "群里接一条:我最怕接到的那个凌晨电话是什么样。 一句话,不许写'系统挂了'这种废话——写画面。"

  • 讲师先自接一条作示范,再挑三条有层次的念出来,逐条点评(这三条是今天的"事件地图"):
群接龙(示例) 讲师点评 今天对应
"你们的机器人不动了。" 现象级电话——你至少知道它坏了 Runbook 事件 1(服务不可用)
"我们的人照着你的文档修,修完更坏了。" 这是真问题——修坏了没有回滚,等于把人推进坑 G6 ① 每类回滚(blocker)
"它没报错,只是慢慢变差了。" 最成熟的一条——已经在担心"没有报警的坏" 概念 3:漂移与监控(今天全场就练这个)

③ 8–10 min|今日地图

  • 三个新概念写黑板(今天就这三个,多一个都进停车位):
    1. SLO 与错误预算——"坏了多久算坏"+"这个月还能坏多久"
    2. Runbook(事件响应与回滚)——"出事照着做的纸,退路写在里面"
    3. 漂移与监控——"AI 不是坏了才叫坏,慢慢变差也是坏"
  • 三件产出物写黑板(S3 结束时每人手里要有初稿):SLO 卡 / Runbook / 值班交接卡。

投屏·板书

┌────────────────────────────────────────────────────────────┐
│  D6 · 运维化 —— 你走了以后,谁修?                          │
├──────────────────────────────┬─────────────────────────────┤
│ 今天只留 3 个新概念           │ 停车位(课后讲)             │
│ 1 SLO 与错误预算              │ SLI / 燃烧率 / MTTR /        │
│ 2 Runbook(响应与回滚)       │ 告警抑制 / 混沌工程 / …      │
│ 3 漂移与监控                  │                             │
├──────────────────────────────┴─────────────────────────────┤
│ 三件产出:SLO 卡 · Runbook · 值班交接卡                     │
│ G6 ①②④ blocker | ③ warning | 工具只挡"零",不挡"糊弄"    │
└────────────────────────────────────────────────────────────┘

互动设计

  • 沉默 10 秒是全天的第一个行为艺术:不许有人说话,讲师也闭嘴。10 秒后再开口的那句话是:"刚才那 10 秒,就是你客户的运维在凌晨 2 点盯着屏幕的感觉。"
  • 群接龙只挑 3 条念——不追求全念完,剩下的留作 S4 复盘时的素材("刚才还有人接龙说……")。

常见错误与纠偏

错误 纠偏
讲师心软,沉默 3 秒就自己接话 助教在台下打手势:数字数。这 10 秒是今天的招牌动作,破了就没味道了
学员接龙写成"系统挂了,很慌" "写画面:谁的电话、几点、他说了哪句话、你当时手里有什么"
有人问"我们又没有真值班,写这个干嘛" "D8 面试会问、客户签字会看。没有值班表,也要有值班文档——它是你专业度的体检报告"

承接语(最后 30 秒)

"记住刚才那三条接龙——它们就是你今天 Runbook 的第一个读者。 接下来 25 分钟,我不讲理论,我上台把工具跑给你看: 看看这个仓库里,'别人家的成品'长什么样,再看看工具能替你挡多少。"

学员笔记要点

  • G5 讲评一句话:"现象是感受,动作才是承诺。"
  • 我接龙写的那条凌晨电话:____________(S3 写 Runbook 时回头对一眼:它属于 5 类事件里的哪一类?)
  • 三个新概念(抄一遍):SLO 与错误预算 / Runbook(响应与回滚)/ 漂移与监控
  • 三件产出物:SLO 卡 / Runbook / 值班交接卡

S2 · 讲与演(10–35 min · 25 min)

本节定位:全天的认知核心。用六幕实测把一句话凿进脑子:工具只挡"零",不挡"糊弄"——门禁拦住"没写 SLO"的人,但拦不住"写了三条空话 SLO"的人;Runbook 的门在工具里根本不存在。结论:Zone C 的质量,人判,不是机器判。

一句话目标(开场念):"接下来 25 分钟,你只需要看懂一件事:工具能帮你挡什么、挡不住什么——挡不住的部分,怎么自己兜住。"

分钟级时间盒

分钟 幕 动作 这一幕教什么
10–14 幕 1 engage list(窄/宽两次)+ gate check 白湖(成品) 成品长什么样;工具会截断你的视野且不提醒
14–19 幕 2 4 个残缺变体对照(无 SLO / 无路由 / 无预算 / 只有 1 条) 工具只挡"零",不挡"糊弄"
19–24 幕 3 handoff 生成 Runbook 骨架,逐段拆 骨架 ≠ 交付物;模板不认识你的客户
24–29 幕 4 拿 §4.2 的"重连"做一次当场盲测 "命令级"的文档才敢过凌晨 2 点
29–33 幕 5 监控模板默认全关(enabled: false) 概率性退化:慢慢变差也是坏
33–35 幕 6 gate check 说"has no gate" 工具的门很浅;G6 的 4 条3 条靠人

讲稿要点

① 幕 1(10–14 min)|先看别人家的成品

  • 先跑窄版 engage list(不加 COLUMNS=200),指出:列被截成 eng-adnova-t…、pre_engagem…——工具没有任何提示。

    "先记住这个画面:数据被截断的时候,工具不报错。 这和你昨天遇到的'全 0.0000 不报错'是同一种沉默。"

  • 再跑 COLUMNS=200 版,14 行全貌。指出今天主角两位:白湖乳业(ticket,slo_sla 阶段)与亚特联汽车(manufacturing,runbook 阶段)。
  • 跑 gate check eng-whitelake-ticket-seed10 → ✅ PASS · gate=slo。

    "这是'别人家的成品':一个乳业的工单助手,已经有 SLO 了。昨天你在 D5 跑出来的那些数字,今天要变成一纸承诺。"

② 幕 2(14–19 min)|四个残缺变体,四种命运

  • 依次跑四个变体,每跑一个先让全班猜(举手:会过还是被挡?),再揭晓:
变体 缺什么 实测结果 退出码
eng-d6-noslo 完全没有 SLO ❌ BLOCKED + 🚫 未定义任何 SLO——错误预算/告警路由缺失 1
eng-d6-noroute SLO 缺告警路由 ✅ PASS + ⚠️ SLO 缺告警路由: ['availability', 'alert_response_p95', 'bad_case_rate'] 0
eng-d6-nobudget SLO 缺错误预算 ✅ PASS(没有任何提示) 0
eng-d6-one 只有 1 条 SLO ✅ PASS 0
  • 三个结论,逐条钉死:
    1. 工具只挡"零"——noslo 被拦,因为它是"什么都没写";
    2. 工具不挡"糊弄"——nobudget 全无错误预算,照样静默通过。G6 ② 是 blocker,但工具根本不查它;
    3. "1 条也算数"——one 通过。数量不是工具的事,是 G6 原文"3 条起"的事,得靠人判。
  • 补一句被挡下后的彩蛋(念屏):

    💡 已把这次阻塞沉淀为草稿 skill-… — fde-scope skill review 可查看并完善 "注意:被挡住不是白挡——工具顺手把它沉淀成了一张草稿技能卡。这就是 D7 技能卡的前奏。"(⚠️ 草稿 ID 每次运行都不同,别背 ID,现场跑 skill review 看)

③ 幕 3(19–24 min)|生成骨架 ≠ 交付物

  • 跑 handoff eng-atlas-manufacturing-seed02 --accept,屏幕出现移交包 + runbook → /tmp/fde-d6-demo/reports/runbook_eng-atlas-manufacturing-seed02.md。
  • 打开生成的 Runbook,和 G6 逐条对,现场列差距:
G6 要求 生成骨架的实测表现 差距
① 5 类事件 亚特联只有 3 类(回复质量退化 / 数据接入中断 / 安全事件) 缺 2 类(指标暴跌、权限或配额、上游依赖挂 里的至少 2 类)
① 每类含回滚 回滚是全局一段(§5 三步),没有按事件分类 每类事件都要有自己的回滚段
② 错误预算 骨架 §3 有预算列,但白湖模板里有、亚特联是"预算内/已耗"这种概数 要写成可算的数字(如 99.5%/月 → 3.6h)
③ 告警路由 骨架 §3 有 primary-oncall 这类路由 没有渠道 + 响应时限表
④ 盲测 工具没这个概念 纯人测
  • 再打开白湖的 Runbook §4.2(它是 ticket / 乳业),念出这句:

    - **诊断**: 检查 OPC UA / MQTT / MES 连接;网络/OT 隔离变更。 "一个乳业的工单助手,文档里让你去查 OPC UA、MQTT、MES——这是工厂协议。 模板是从工业案例里长的,它不认识你的客户。改,是你的活。"

④ 幕 4(24–29 min)|当场盲测:拿"重连"这三个字问

  • 不回屏,直接念亚特联 §4.2 的处置原文:

    - **处置**: 重连;必要时切换到离线快照语料继续服务。

  • 现场点名一位学员当"凌晨 2 点的值班同事",按 07 §3.5 的三刀逐刀问(讲师扮提问者):
刀 讲师问 断点在哪
1 "重连——凌晨 2 点的人具体敲什么命令?" 命令层:没有命令
2 "'切换到离线快照'——哪个快照?最近的还是昨天的?" 对象层:没有唯一标识
3 "'升级:FDE on-call'——谁的手机号?他不接怎么办?" 人层:没有渠道与第二级
  • 三刀砍完回头念合格线(12 §2.8):

    "没参与过的同事,只照文档能独立处理(凌晨 2 点盲测)。——刚才那三刀,就砍在这句话上。"

⑤ 幕 5(29–33 min)|概率性退化:慢慢变差也是坏

  • 跑监控模板(05 §4 D6 第 4 条:"AI 不是坏了才叫坏,慢慢变差也是坏。"): 输出关键字段逐行念:
{
  "data_drift": { "enabled": false, "cadence": "daily", "threshold": "PSI > 0.2" },
  "quality_drift": { "enabled": false, "cadence": "weekly" },
  "feedback_latency": { "target_hours": 24 },
  "dashboards": []
}
  • 指着两个 false 和一个空数组:

    "工具把监控骨架都造好了——但默认全是关的。 它在告诉你一件事:监控不是装出来的,是承诺出来的。 你把 enabled 打开,就等于对外承诺'我每天会看这个数'。"

  • 反模式点名(12 §1.6):
    • #7 Probabilistic Degradation(系统悄悄变差,无人发现)→ 解药 = SLO + 告警路由 + 数据飞轮;
    • #3 Hero Engineer(全靠一个牛人扛,他一休假就瘫)→ 如果联系人写"找我就行",就是它。解药 = 交接四件套 + 盲测。

⑥ 幕 6(33–35 min)|工具里没有 runbook 这门

  • 跑 gate check eng-atlas-manufacturing-seed02 → Phase 'runbook' has no gate.

    "亚特联现在就在 runbook 阶段——工具说:这个阶段没有门。 再加上刚才 nobudget 的静默通过——今天记住这张图:"

  • 屏幕并排两行:
    • 工具的门:只有 slo 一条(只挡"零",不挡糊弄),runbook 阶段无门;
    • 课程的门 G6:4 条 —— ① 每类回滚(blocker)② 错误预算(blocker)③ 告警路由(warning)④ 盲测(blocker)。

    "3 条 blocker 全在人手上。 所以今天的质量不靠跑命令,靠 S4 的盲测。"

投屏·板书

  • 左:六幕一行一结论;右:G6 四条(①②④ 标红,③ 标黄)
  • 中部保留一张永远不切的对照
幕 1 成品先看        → 截断不报错
幕 2 四变体          → 只挡零,不挡糊弄
幕 3 生成骨架        → 模板不认识你的客户
幕 4 当场盲测        → 问到"敲什么命令"
幕 5 漂移默认关      → 慢慢变差也是坏
幕 6 has no gate     → 门在人手上

演示脚本(可直接复制执行)

⚠ 全部从仓库根执行(.venv 在仓库根;FDE_SCOPE_HOME 指向演示数据)。 六幕合计约 25 分钟;不需要任何 API key。第 0 步是一次性准备,课前做完。

# ── 准备 0:把虚构种子放进演示工作目录(一次性,约 10 秒)
cd <你的仓库根>
.venv/bin/python examples/seed_mock_engagements.py        # ⚠ 它不认 FDE_SCOPE_HOME,只往仓库里写
mkdir -p /tmp/fde-d6-demo/.fde_scope
cp -r .fde_scope/engagements .fde_scope/skills /tmp/fde-d6-demo/.fde_scope/
export FDE_SCOPE_HOME=/tmp/fde-d6-demo                    # 之后所有命令读的都是这份演示数据

# ── 准备 1:造 4 个残缺变体(幕 2 用;从成品白湖派生,ID 固定、内容虚构)
.venv/bin/python - <<'PY'
import json, pathlib
root = pathlib.Path("/tmp/fde-d6-demo/.fde_scope/engagements")
src = json.loads((root / "eng-whitelake-ticket-seed10.json").read_text(encoding="utf-8"))
def dump(name, mutate):
    d = json.loads(json.dumps(src)); d["id"] = name; mutate(d)
    (root / f"{name}.json").write_text(json.dumps(d, ensure_ascii=False, indent=2), encoding="utf-8")
dump("eng-d6-noslo",    lambda d: d.__setitem__("slos", []))                                 # 无 SLO
dump("eng-d6-noroute",  lambda d: [s.__setitem__("alert_route", "") for s in d["slos"]])     # 无路由
dump("eng-d6-nobudget", lambda d: [s.__setitem__("error_budget", "") for s in d["slos"]])    # 无预算
dump("eng-d6-one",      lambda d: d.__setitem__("slos", d["slos"][:1]))                      # 只有 1 条
PY

# ── 幕 1(10–14):先看别人家的成品
.venv/bin/python -m fde_scope.cli engage list                     # 窄:列被截断,不报错
COLUMNS=200 .venv/bin/python -m fde_scope.cli engage list          # 宽:14 行全貌
.venv/bin/python -m fde_scope.cli gate check eng-whitelake-ticket-seed10

# ── 幕 2(14–19):四个残缺变体,四种命运
.venv/bin/python -m fde_scope.cli gate check eng-d6-noslo          # ❌ 被挡(退出码 1)
.venv/bin/python -m fde_scope.cli gate check eng-d6-noroute        # ✅ 过了 + 一条 ⚠️
.venv/bin/python -m fde_scope.cli gate check eng-d6-nobudget       # ✅ 静默通过
.venv/bin/python -m fde_scope.cli gate check eng-d6-one            # ✅ 1 条也算数

# ── 幕 3(19–24):生成骨架 ≠ 交付物
.venv/bin/python -m fde_scope.cli handoff eng-atlas-manufacturing-seed02 --accept
sed -n '/### 4.2/,/### 4.3/p' /tmp/fde-d6-demo/reports/runbook_eng-atlas-manufacturing-seed02.md
sed -n '/### 4.2/,/## 5/p'    /tmp/fde-d6-demo/reports/runbook_eng-whitelake-ticket-seed10.md

# ── 幕 4(24–29):当场盲测——不敲新命令,拿幕 3 打出的 §4.2 原文逐刀追问(见讲稿要点④)

# ── 幕 5(29–33):概率性退化——工具的监控骨架默认全关
.venv/bin/python - <<'PY'
from fde_scope.engagement.operationalization import build_monitoring_template
import json
print(json.dumps(build_monitoring_template(), ensure_ascii=False, indent=2))
PY

# ── 幕 6(33–35):工具里没有 runbook 这门
.venv/bin/python -m fde_scope.cli gate check eng-atlas-manufacturing-seed02

# ── 备用幕(S6 卡点/答疑用,非必讲)
.venv/bin/python -m fde_scope.cli skill review        # 看幕 2 那次阻塞被沉淀成了什么(ID 每次不同)

命令与预期输出对照(讲师速查)

幕 命令 必出现的证据 退出码
1 COLUMNS=200 … engage list 14 行 · 白湖 / 亚特联都在表里 0
1 … gate check eng-whitelake-ticket-seed10 ✅ PASS · gate=slo 0
2 … gate check eng-d6-noslo ❌ BLOCKED · gate=slo + 🚫 未定义任何 SLO——错误预算/告警路由缺失 1
2 … gate check eng-d6-noroute ✅ PASS + ⚠️ SLO 缺告警路由: ['availability', 'alert_response_p95', 'bad_case_rate'] 0
2 … gate check eng-d6-nobudget ✅ PASS(没有任何 ⚠️) 0
2 … gate check eng-d6-one ✅ PASS 0
3 … handoff …seed02 --accept customer accepted: ✅ + 移交包 block(含功能安全 5 行) 0
3 sed -n '/### 4.2/,/### 4.3/p' …atlas… §4.2 只有 症状/诊断/处置——无回滚、无升级 0
5 监控模板 heredoc "enabled": false ×2 · "dashboards": [] 0
6 … gate check …seed02 Phase 'runbook' has no gate. 0
备 … skill review 草稿技能列表(ID 不稳定,别背) 0

互动设计

  • 幕 2 每个变体先猜后揭(举手:过 / 不过)——nobudget 的"静默通过"是全场的"啊?"时刻,等这个"啊"出来再讲结论。
  • 幕 3 让一位学员念白湖 §4.2 的诊断行——让"OPC UA / MQTT / MES"从一个学员嘴里念给全班听,比讲师念一遍效果好三倍。
  • 幕 4 的"值班同事"随机抽,抽到就说"你现在是凌晨 2 点";回答不上就算合格的示范(要的就是回答不上)。
  • 幕 5 让全班一起念两个 false。

学员动作(现场)

  • 六幕各记一行"必出现的证据"(就是讲师速查表的第三列)
  • 在笔记里写下幕 2 三结论:只挡零 / 不挡糊弄 / 1 条也算数
  • 幕 4 被抽到的学员:记下自己答不上的那一刀

常见错误与纠偏

错误 纠偏
学员以为"工具通过 = 合规" 指着 nobudget 的 ✅ PASS:"这叫静默通过。门禁不响,不代表你做对了。"
有人看到 ❌ 就说"工具太严" "严的是那一条 🚫——'什么都没写'。剩下的它都放行了。严不严不是重点,覆盖不覆盖才是。"
幕 3 有人问"那这工具是不是没用" "它的用处是给你一个不会漏章节的骨架(系统概述/联系人/SLO/事件/回滚/移交状态)。骨架保完整,内容保正确——后者是你的活。"
幕 4 学员真答不上来,场面尴尬 讲师接住:"答不上来就对了——这就是凌晨 2 点的感觉。 记下这一刀,你自己文档里不能有它。"
幕 5 有人问 PSI 是什么 "停车位。 今天只要记住'漂移是要有个数看着的',PSI / 阈值怎么定,课后 12 §3.5"

承接语(最后 30 秒)

"看清了:工具只挡'零',挡不住'糊弄';runbook 阶段连门都没有。 所以接下来 35 分钟,你要自己给自己立门—— SLO 卡、Runbook、值班交接卡,三份文档,写给你不认识的那个夜班同事看。"

学员笔记要点

  • 幕 2 三结论:只挡零 · 不挡糊弄 · 1 条也算数(写三遍)
  • 差距表里我印象最深的一条:____________(5 类 vs 3 类 / 回滚不分类 / 联系人全 TBD / OPC UA 出现在乳业文档里)
  • 盲测三刀:命令层 / 对象层 / 人层
  • 监控两条 "enabled": false——工具默认不信任何人,承诺是你自己给的
  • G6 四条里,工具管了:____ 条(答:0 条硬管);靠人判:____ 条

S3 · 上手(35–70 min · 35 min)

本节定位:把六幕的"看"变成"写"。三件产出物不是作文——每一格都有判分口径。本节结束时,每个人的三件文档都要有能拿去做盲测的 v1。

一句话目标(开场念):"接下来的每一行,都问自己一句:没参与过的同事,照着这句能做吗?"

分组建档复核(讲师,1 分钟)

沿用 D2 定稿的分组委托单,每个组选自己案例里的一个系统:

组 案例(D2 定稿的委托单) 今天写的对象 可参照的样板
A 组 案例 B · 迅捷出行(ticket) 工单 Agent 的上线运维 eng-whitelake-ticket-seed10 的 Runbook §3/§4(成品,但别抄它的 §4.2 工业词)
B 组 案例 C · 南湾汽车(manufacturing) 产线 Agent 的运维 eng-atlas-manufacturing-seed02 的 Runbook(骨架,参考结构,补齐到 5 类)

讲师提醒:参照的是"结构完整度",不是"内容对错"——两个样板都不满足 G6(一个缺 2 类事件、一个夹带无关词)。它们是脚手架,不是答案。

分钟级时间盒(学员视角)

分钟 动作 交付到哪一步
35–38 定对象 + 建文件名(三件) D6-姓名-SLO卡 / -Runbook / -值班交接卡 三个空文件
38–48 写 SLO 卡:3 条起,每条目标值 + 测量方式;算错误预算;画告警路由表 SLO 卡 v1(能算、能测、能路由)
48–58 写 Runbook:5 类事件 × 四段(先写"判断信号",每类补回滚) Runbook v1(5×4 格子齐全)
58–64 写值班交接卡:当前状态 / 待办 / 已知风险 / 联系人 值班交接卡 v1
64–67 找一位同学做 3 分钟盲测,记下举手点 断点清单(≥3 条)
67–70 修断点 + 自查 G6 四条 + 按命名改名 三件 v1.1,可提交

⚠️ 助教巡场时序(三趟,每趟只查一件事): 第一趟(≈42 min)查"测量方式"——「这条你怎么测?多久测一次?」没有测量方式的 SLO = 口号(12 §2.7)。 第二趟(≈54 min)查"回滚"——5 类事件每类都有回滚吗?只问一句:「修不好怎么退?」 第三趟(≈63 min)扫"联系人"——出现真实姓名 / 手机号 / 邮箱 = 当场替换为角色,不说例外。

讲稿要点

① 35–38 min|定对象 + 建文件

  • 三件文档各自独立成文件(G6 按件判分),文件名先建好——文件名就是承诺。
  • 写之前先答一个问题(写屏幕上):"你这个系统,坏了多久算坏?"

    "回答不了的,先别写 SLO——你连'坏'的定义都没有。"

② 38–48 min|SLO 卡:三条起,每条都要能测

  • 格式照抄 12 §2.7,一字不改:
# 指标 目标值 测量方式 数据来源 覆盖时段
1 可用性 ≥99.5%/月 健康检查成功率 监控平台 7×24
2 响应延迟 P95 ≤2s 请求耗时直方图 监控平台 7×24
3 分类准确率 ≥91%(周抽样 200 条) 每周固定测试集重跑 D5 的 eval 每周
  • 判据原文(12 §2.7):"三条起。每条必须有目标值 + 测量方式,否则不是 SLO,是口号。"
  • 错误预算现场算(白板推一遍,全班跟算):
    可用性 99.5% / 月  →  30 天 × 24 h × (1 − 0.995) = 3.6 h
    

    "这句话翻译成人话:这个月你还能坏 3.6 小时。 烧完了怎么办?——" 念 12 §2.7 原文:"预算烧完(>100%)→ 暂停新功能,优先修稳定性。"

  • 告警路由表(照 §2.7 三档):
严重度 触发条件 通知谁 渠道 响应时限
P0 服务不可用 >5min 值班工程师 + 我方 电话 + 群 15 分钟
P1 延迟 P95 >5s 持续 10min 值班工程师 群 1 小时
P2 准确率周环比跌 >5pt 项目负责人 邮件 1 个工作日

"通知谁这一列只写角色。"——这是今天红线 3。

③ 48–58 min|Runbook:5 类 × 四段

  • 五类事件标题照 12 §2.8(一字不改):服务不可用 / 指标暴跌 / 数据异常 / 权限或配额 / 上游依赖挂。
  • 每类四段:判断信号 → 处置步骤 → 回滚步骤 → 升级路径。给一个"指标暴跌"的样例,全班照抄结构:
段 好例子(可抄) 反面例子(当场改)
判断信号 "bad_case_rate 周环比 +5pt 连续 2 周;对应看板告警触发" "感觉效果变差"
处置步骤 "1) 拉出最近 7 天 bad case Top20;2) 分类归因;3) 若集中在单一类别 → 补语料重训" "排查一下"
回滚步骤 "若重训后指标不升反降 → 切回上一版模型快照(版本号写在变更记录里)" "恢复备份"(= 没说)
升级路径 "第一级:值班工程师(角色);2 小时未恢复 → 第二级:FDE on-call" "联系负责人"
  • 前置条件行也要写(§2.8 原话照抄):

    前置:值班人员需具备 <终端操作 + 看日志> 能力,无需懂模型。

④ 58–64 min|值班交接卡:四段

  • 格式照 12 §2.9,四段:当前状态 / 待办(下一班注意)/ 已知风险 / 联系人。
  • 一句话讲清它是什么:

    "它是班次之间的接力棒。 Runbook 管'出事怎么办',交接卡管'交接时别丢信息'——今天你写完就算数,真值班时每天更新。"

⑤ 64–67 min|互换盲测(3 分钟)

  • 找一位同学,交换 Runbook,对方大声念;念到读不下去的地方当场举手。三刀模板(07 §3.5):

    B(举手):这里写"检查服务健康"——凌晨 2 点的人具体敲什么命令? B(举手):回滚这步说"恢复备份"——哪个备份?最近的还是昨天的? B(举手):升级路径写"联系负责人"——谁的手机号?他不接怎么办?

  • 每处卡壳当场记下,这就是待修断点。

⑥ 67–70 min|自查 + 命名

  • 练 06 D6 任务卡的门禁自查四条 + 命名:
提交物 文件名 对应 G6
SLO 卡 D6-姓名-SLO卡 ②③
Runbook(含每类回滚) D6-姓名-Runbook ①
值班交接卡 D6-姓名-值班交接卡 配套(D7 交接包收它)
盲测记录(一页纸,举手点 + 修法) D6-姓名-盲测记录 ④

投屏·板书

  • 左:SLO 卡三件套模板(表 + 错误预算算式 + 路由表)
  • 右:Runbook 5×4 矩阵(画成空网格,写完一格打一个勾)
  • 底部:盲测三刀 + 命名规范
┌──────────────────────────────┬──────────────────────────────┐
│ SLO 卡(12 §2.7)             │ Runbook 5×4(12 §2.8)        │
│ 指标|目标值|测量方式|…     │ 事件① 信号 处置 回滚 升级    │
│ 错误预算:99.5%/月 → 3.6 h    │ 事件② 信号 处置 回滚 升级    │
│ 路由:严重度|条件|谁|渠道  │ …(5 行都要有"回滚"列)       │
├──────────────────────────────┴──────────────────────────────┤
│ 盲测三刀:敲什么命令 | 哪个备份 | 谁的手机号                 │
│ 命名:D6-姓名-SLO卡 / -Runbook / -值班交接卡 / -盲测记录      │
└─────────────────────────────────────────────────────────────┘

互动设计

  • 巡场第一趟只问一句(07 §4.2 风格):"这条 SLO 怎么测?谁测?多久测一次?"——答不出的不算过。
  • 算错误预算时全班一起拍计算器(30×24×0.005),一起念出"3.6 小时"。
  • 写 Runbook 前 2 分钟,让学员闭眼想一个画面:凌晨 2 点,一个没参加过你项目的人,打开你这份文档的第一眼——他看到什么?

学员动作(现场)

  • 建三件文件 + 盲测记录(四个文件名一次建好)
  • 写 SLO 卡(≥3 条、每条能测、算出错误预算、画路由表)
  • 写 Runbook(5 类 × 四段;每类的"回滚步骤"用对象级标识:哪个快照 / 哪个版本 / 哪份配置)
  • 写值班交接卡(四段)
  • 做 1 次 3 分钟盲测,记下 ≥3 条断点并当场修
  • 按命名规范改文件名

常见错误与纠偏

错误 纠偏(助教用)
SLO 写成"尽量快 / 尽可能稳" "目标值 + 测量方式,缺一个 = 口号(12 §2.7 原话)。改成'P95 ≤2s,耗时直方图,7×24'"
Runbook 只写"怎么修",没写回滚 "修坏了怎么退?(第二趟巡场只问这一句)不写回滚 = G6 ① 不过(blocker)"
回滚写"恢复备份 / 回滚一下" "回滚必须指名道姓:哪份快照、哪个版本号、哪份配置——'上一个语料快照(reports/corpus_report_*.json)' 这样写"
联系人写了真人姓名 / 手机号 当场替换为角色(primary-oncall / fde-oncall / 客户运维);提醒 11 §6 红线:姓名 / 联系方式的现实版就是 PII
5 类事件想不出第 5 类 "照 12 §2.8 标题逐个填:服务不可用 / 指标暴跌 / 数据异常 / 权限或配额 / 上游依赖挂。上游依赖挂最容易忘——你的模型服务挂了算谁的?"
值班交接卡写成日记 "四段就好:当前状态 / 待办 / 已知风险 / 联系人。别加戏,这是给别人交接用的"
盲测找不到人换 助教现场配对;一个人也能做:隔 10 分钟自己再读一遍,读不下去处当场标红

承接语(最后 30 秒)

"停一下——看看你手里的三件文档。 接下来 10 分钟,我会随机抽一份,让别人按你的文档当场念。 现在,把你文档里最虚的那一句标出来,等会儿被抽到,就是它。"

学员笔记要点

  • 错误预算算法:30 × 24 × (1 − 0.995) = 3.6 h(自己再算一遍)
  • 烧完预算的动作:暂停新功能,优先修稳定性(12 §2.7)
  • 回滚步骤的唯一标准:指名道姓(哪个快照 / 哪个版本)
  • Runbook 合格线:没参与过的同事,只照文档能独立处理
  • 我的盲测断点(≥3 条):____________________________________

S4 · 复盘(70–80 min · 10 min)

本节定位:用"凌晨 2 点盲测"把三件文档当众过一遍火。今天这台戏的唯一 KPI:每一处"读不下去",都被现场抓出来并现场修掉。

一句话目标(开场念):"接下来谁被抽到,谁就把文档念出声——念到卡住的地方,举手的是全体。"

分钟级时间盒

分钟 动作 目的
70–74 讲师示范一轮:随机抽一份 Runbook,按 07 §3.5 三刀连问 让全班看到"断点"长什么样
74–78 两两交换再测(每人测一次、被测一次) 全员过火
78–80 收口:断点归类(命令 / 对象 / 人)+ 反模式点名 把个案变成公共资产

讲稿要点

① 70–74 min|讲师示范:先测"别人家的成品"

  • 用幕 3 留下的亚特联 §4.2(原文照念),按 07 §3.5 剧本逐刀问(不笑、不寒暄):
# 念到的原文 讲师(扮凌晨 2 点的值班同事)问 断在哪一层
1 "检查 OPC UA / MQTT / MES 连接" "我敲哪个命令看连接?在哪个界面看?" 命令层
2 "必要时切换到离线快照语料" "哪个快照?最近的还是昨天的?目录在哪?" 对象层
3 "升级:FDE on-call" "FDE on-call 是谁?怎么找到他?他不接怎么办?" 人层
  • 每砍一刀,白板记一个字:命令 / 对象 / 人。
  • 念来源(07 §3.5):"观察点:每处卡壳都是 Runbook 的断点,A 学员当场记下并修复;修复后再测一次。"

② 74–78 min|两两交换再测

  • 规则(写屏幕):
    1. 念的人用嘴,不用手——不许帮作者解释"我懂你的意思";
    2. 卡住就举手,两秒内举;
    3. 作者只记不辩——现在不是辩护时间,是找断点时间;
    4. 测完交换角色,两轮各测一份。
  • 讲师/助教走动听,重点盯三种人:写满术语的(抽象层断点多)、联系人写"找我就行"的(= #3 Hero Engineer 现场版)、回滚栏空着的(G6 ① 直接不过)。

③ 78–80 min|断点归类 + 反模式点名

抓到的模式 命名(12 §1.6) 现场替换
"找我就行 / 我手机 24 小时开着" #3 Hero Engineer(全靠一个牛人扛,他一休假就瘫) "值班角色 + 升级路径;我休假时第一级照样有人接"
Runbook 只写"怎么修",没有回滚段 G6 ① 不过(blocker) "每类事件第二段补'退':切回哪个快照 / 哪个版本"
"我们的效果一直挺稳的,应该不会出事" #7 Probabilistic Degradation(系统悄悄变差,无人发现) "SLO 周环比 + 漂移阈值;用一个数字看着它"
  • 收口金句(05 §7):"凌晨 2 点没人爱你,除了你的文档。"

投屏·板书

  • 左侧:三刀模板(原文三行,07 §3.5)——全程不切屏
  • 右侧三行红字: ① 念的人不解释 ② 卡住两秒内举手 ③ 作者只记不辩
  • 底部一行:合格线:没参与过的同事,只照文档能独立处理(12 §2.8)
┌────────────────────────────────────────────────────────────┐
│ ① 检查服务健康 → 敲什么命令?        (命令层)            │
│ ② 恢复备份     → 哪个备份?          (对象层)            │
│ ③ 联系负责人   → 谁的手机号?不接呢? (人层)              │
├────────────────────────────────────────────────────────────┤
│ 念的人不解释 | 卡住两秒内举手 | 作者只记不辩              │
│ 合格线:没参与过的同事,只照文档能独立处理                 │
└────────────────────────────────────────────────────────────┘

互动设计

  • 示范轮让全班当裁判:每砍一刀先问全班"这算断点吗?"——练的是"识别断点"的眼睛,不是看讲师的表演。
  • 两两交换时用手机计时 90 秒/人:时间压力本身就是凌晨 2 点的模拟器。
  • 收口时抽一组念:"你被抓出来最狠的一刀是什么?你改成什么了?"——只念改法,不念检讨。

学员动作(现场)

  • 被抽到的人:当众念、当场记断点
  • 全员:完成两轮交换盲测(测别人一次、被测一次)
  • 每人至少当场修 3 处断点(命令层写命令、对象层写标识、人层写角色 + 升级)
  • 把最狠的一刀写进笔记:"我的文档里最虚的一句是:____________"

常见错误与纠偏

错误 纠偏
作者抢着解释"这里的意思是……" 打断:"你的文档不在场的时候,谁来解释? 念的人只读字面——这就是凌晨 2 点的真实"
念的人嫌"太苛刻",帮作者打圆场 "圆场 = 放行一个断点。今天放过它,出事那天没人放过你"
抽到的文档质量太差,念的人尴尬 讲师接刀:"这份是我见过的第 11 份'重连'——它今天被修好,就是这个环节的全部意义"
学员问"我这条一定要写命令吗?我又不知道运维敲什么" "不知道就去问、去查、去写'待确认 + 谁确认 + 何时确认'。'不知道'可以上文档,'含糊'不行"
时间不够,两轮只做了一轮 不加时;没轮到的那一半在 S6 补测,助教盯

承接语(最后 30 秒)

"被念卡了几次,你才知道文档是给谁写的。 接下来 10 分钟,收口:G6 四条、提交物命名、明天的预告—— 明天,你要把手里的东西交给一个不爱你的人。"

学员笔记要点

  • 断点三层:命令层 / 对象层 / 人层(我的文档最容易断在:____)
  • 我当场修的 3 处:____________________________________
  • 三个反模式(各写一行):#3 Hero Engineer / #7 Probabilistic Degradation / G6 ① 不过
  • 合格线默写一遍:没参与过的同事,只照文档能独立处理

S5 · 布置 G6 + 明日预告(80–90 min · 10 min)

本节定位:收口 + 交底。念清 G6 四条、命名规范、截止与补交;埋 D7 三个钩子。

一句话目标(开场念):"今天收的是你不在场时的可靠性:三份文档、四条门禁、一次盲测。"

分钟级时间盒

分钟 动作 目的
80–84 念 G6 四条(①②④ blocker / ③ warning)+ 命名 + 截止 判据不可含糊
84–87 盲测记录模板投屏逐行讲 ④ 是 blocker,记录要像证据
87–90 D7 三个钩子 制造明天的注意力缺口

讲稿要点

① 80–84 min|G6 四条 + 命名 + 截止

  • G6 原文(03 §3,逐字念):

    ① Runbook 含 5 类事件且每类有回滚步骤 ② SLO 卡含错误预算 ③ 明确告警路由(谁/渠道/响应时限) ④ 通过"凌晨 2 点盲测"(同事按文档能处理) —— ①②④ blocker;③ warning。

  • 点名各自的不通过形态(学员最需要听的):
    • ① 不过:事件少于 5 类;或任何一类没有回滚段;或回滚写"恢复备份"这种不含对象的口水话
    • ② 不过:SLO 没有错误预算数字(注:工具不查这个——今天实测 nobudget 静默通过,全靠人判)
    • ③ 扣分:告警路由只有"通知谁",缺渠道或响应时限(工具侧只亮 ⚠️,也是 warning)
    • ④ 不过:没做盲测 / 做了但没记录 / 记录里没有"读不下去的点"
  • 命名 + 提交物清单(四个文件,一次说清):
提交物 文件名 对应 G6
SLO 卡(目标值 + 测量方式 + 错误预算 + 路由) D6-姓名-SLO卡 ②③
Runbook(5 类 × 四段,每类含回滚) D6-姓名-Runbook ①
值班交接卡(四段) D6-姓名-值班交接卡 配套
盲测记录(一页:断点清单 + 修法) D6-姓名-盲测记录 ④
  • 截止与补交(06 §5 原文):直播次日 21:30 前提交;24 小时内补交 = 正常放行(标注"补交通过");超 24 小时 = 延期通过(作品集等级最高 B);豁免进证书备注。

② 84–87 min|盲测记录:一页纸,像证据一样

投屏模板,逐行讲怎么填:

断点(念到哪句卡住的) 层(命令/对象/人) 修法(改后的原文) 复测
"检查服务健康" 命令 改为 "systemctl status agent-svc;预期 active (running)" ✅ 通过
"恢复备份" 对象 改为 "切回上一版语料快照(reports/corpus_report_*.json 中最近一份)" ✅ 通过
"联系负责人" 人 改为 "第一级:值班角色(群 #oncall);2h 未恢复 → 第二级:FDE on-call" ✅ 通过

汇总一行(照抄结构):"盲测 1 次;断点 5 处(命令 2 / 对象 2 / 人 1);全部已修,复测通过。"

"注意'修法'那一列——它不是检讨,是新的文档原文。评委看的就是:你说'改好了',改完长什么样。"

③ 87–90 min|D7 三个钩子

念 05 §4 D6 第 5 条与 D7 引子(原话):

  1. "预告:'明天你要把手里的东西交给一个不爱你的人。'"
  2. (D7 核心心态)"交接不是走过场,是你专业度的最后一道签名。"
  3. (D7 硬要求)技能卡必须有"适用边界"——什么情况下这条经验不适用。

补一句工具预告(别破梗,只说现象):

"明天我们会碰到两个新动词:交接和沉淀。 今天你写好的 SLO 卡和 Runbook,明天要被打包成'四件套',连同培训材料一起交给一个不爱你的人—— 他不想听你的故事,只想照着签名。今天先睡,明天见。"

投屏·板书

  • 左:G6 四条(①②④ 标红 blocker,③ 标黄 warning)+ 四个提交物名
  • 右:盲测记录三行表("修法"列加粗)+ 汇总行
  • 底部:D7 三个问题("交给一个不爱你的人" / "适用边界是什么?" / "你的签名是什么?")
┌────────────────────────────────┬──────────────────────────────┐
│ G6(03 §3)                    │ 一页盲测记录                 │
│ ① 5 类事件·每类回滚 🔴 blocker  │ 断点|层|修法(改后原文)|复测 │
│ ② SLO 含错误预算    🔴 blocker  │ … | 对象 | 切回上一版快照 |✅│
│ ③ 告警路由(谁/渠道/时限) 🟡      │ 汇总:断点 5 处,全部已修     │
│ ④ 凌晨 2 点盲测通过 🔴 blocker  │                              │
├────────────────────────────────┴──────────────────────────────┤
│ 四个文件:SLO卡 · Runbook · 值班交接卡 · 盲测记录              │
│ 截止:直播次日 21:30 | 24h 内补交=正常放行 | 超 24h=封顶 B    │
├───────────────────────────────────────────────────────────────┤
│ D7:交给一个不爱你的人 | 适用边界 | 你的最后一次签名          │
└───────────────────────────────────────────────────────────────┘

互动设计

  • 念完 G6 后问一句:"今天谁的 Runbook 里还有'恢复备份'这四个字?举手。"(不点名,只记数字——S6 助教会重点盯这部分人)
  • 盲测记录环节让大家当场写一行:"我盲测里最狠的一刀是:______"
  • D7 预告用沉默收尾:问完"明天你要把手里的东西交给一个不爱你的人"——停 3 秒再下课

学员动作(现场)

  • 记下四个提交物的准确文件名与截止时间(次日 21:30)
  • 当场写一行:我最狠的那一刀:____________
  • 在日历上标 D7 日期 + "带齐 D6 四件"
  • 群里回一句:"四件齐。" 或 "还差 ____。"(诚实报缺口)

常见错误与纠偏

错误 纠偏
学员问"盲测记录是附件,能不能不交" 不劝——只念 G6 ④:"'通过凌晨 2 点盲测'是 blocker。 记录是你'做过'的唯一证据"
有人说"我找不到人给我盲测" "S6 里有配对;实在没有,自己隔 10 分钟再读,读不下去处一样算断点"
有人拿 D5 的评估报告当盲测记录 明确区分:D5 测"系统行不行",D6 测"文档扛不扛得住"——两码事,都要交
助教替学员写 Runbook 不许。助教只能问:"你这五类里,哪一类的回滚还没写?"

承接语(最后 30 秒)

"今天你们第一次为'不在场的自己'写东西。明天开始,你要把它交给一个不爱你的人。 下课。四十五分钟自练,助教在群里。"

学员笔记要点

  • G6 四条(①②④ blocker / ③ warning)+ 各自的不通过形态
  • 四个提交物文件名 + 截止 + 补交规则
  • 盲测记录三行表结构;"修法"列写的是改后的原文
  • 我最狠的一刀:____________
  • D7 三问(抄一遍):
    1. 明天你要把手里的东西交给谁?(一个不爱你的人)
    2. 技能卡的"适用边界"是什么?
    3. 你留的"最后一次签名"是什么?

S6 · 自练(+45 min)

本节定位:独立完成、自测、提交。目标只有一个:三件文档都过得了 G6 ①②④,盲测记录过 ④。

一句话目标:把"写完了"变成"凌晨 2 点的人能照着做"。

45 分钟怎么分(投屏建议)

分钟 干什么 产物
0–12 补齐 Runbook:5 类 × 四段(重点:每类的"回滚步骤"指名道姓) D6-姓名-Runbook
12–22 打磨 SLO 卡:测量方式逐条落实;算出错误预算数字;路由表补"渠道 + 时限" D6-姓名-SLO卡
22–30 写值班交接卡(四段)+ 全文档联系人角色化复查 D6-姓名-值班交接卡
30–38 找同学再做一轮盲测(或补测),记录断点与修法 D6-姓名-盲测记录
38–43 自评 G6 四条 + 逐条打钩 + 改文件名 ——
43–45 提交 + 群里发 60 秒收获 提交

三条路径(学员按自己情况选一条)

路径 谁选 做什么
A 完成 大多数人 四件产出齐活 + 提交(别加戏,先交出去)
B 迁移 手里有已脱敏且经公司同意的运维信息 把 SLO 目标值换成你系统真实历史支撑的数字(如可用性目标参照近 3 个月实际);文档里只写指标与阈值,不写客户名、IP、域名、账号(11 §6.1)
C 加练 想再挖一层 ① 给你 Runbook 的"事件 2 · 指标暴跌"补上具体阈值(周环比跌几个点触发?连续几周?)并写成"判断信号";② 挑一类事件,把它的四段浓缩成 Post-it 大小——练"给凌晨 2 点的人减负"

路径 C 的第一步特别值钱:你会亲手把"效果变差"这种感受,改写成一个会响的数字。

完成标准(提交前逐条打钩)

☐ SLO 卡 3 条起;每条有【目标值】+【测量方式】(缺一 = 口号)
☐ 每条 SLO 有错误预算(写成一个数字:如 99.5%/月 → 3.6h)
☐ 告警路由表有【严重度 / 触发条件 / 通知谁(角色)/ 渠道 / 响应时限】
☐ Runbook 覆盖 5 类事件:服务不可用 / 指标暴跌 / 数据异常 / 权限或配额 / 上游依赖挂
☐ 每类事件四段齐全:判断信号 → 处置步骤 → 回滚步骤 → 升级路径
☐ 回滚步骤写到"命令/对象"级(不含"恢复备份"这类含糊话)
☐ 值班交接卡四段:当前状态 / 待办 / 已知风险 / 联系人
☐ 全部联系人写角色(primary-oncall 等),无真实姓名 / 手机号 / 邮箱
☐ 盲测记录 ≥1 次,含断点清单(层 + 修法 + 复测结果)
☐ 命名:D6-姓名-SLO卡 / -Runbook / -值班交接卡 / -盲测记录

卡点急救

卡在哪 怎么救
写不出 3 条 SLO 从白湖 §3 抄骨架(可用性 / 响应时长 / 坏例率),把目标值换成你自己的;数量先够 3 条,质量靠测量方式
错误预算算不出来 公式:天数 × 24h × (1 − 目标值)。99.5%/月 → 30×24×0.005 = 3.6h;99%/月 → 7.2h
5 类事件不知道写什么 对着 12 §2.8 五个标题逐个填;每类先写"判断信号"——你凭什么知道出事了?
"回滚写不出来" 问自己:"这个动作之前,系统在跑什么?"(上一版模型 / 上一份语料快照 / 上一版配置)——把它写成对象
"联系人写谁?" 只写角色。被问"找他没用怎么办" → 这就是升级路径第二级存在的意义
盲测没人配对 助教现场配对;或自己隔 10 分钟再读一遍,读不下去的地方就是断点
engage list 输出很窄 / 列被截 COLUMNS=200 重跑(不是数据丢了,是显示截断——今天幕 1 教过)
想跑 gate check 自查 只有在 .fde_scope/ 里有档案时才有效;今天的三件文档是 Markdown 交付物,门禁在 06 D6 任务卡里自查

助教值守规则

  • 只回答两类问题:① 规则类(命名 / 截止 / G6 判据 / 模板格式)② "这条回滚算不算'指名道姓'"
  • 不回答:D7 之后的方案类问题;"我能不能少写一类事件"这类豁免请求(① 是 blocker,不商量)
  • 每 15 分钟在群里发一次进度提示("还有 30 / 15 / 5 分钟")
  • 收到提交后只回一个字:✓(讲评在次日 08:30 门禁榜 + D7 回炉)
  • 提交里出现真实客户名 / PII / 真实账号 → 立即私聊要求撤回重交,并记录合规日志(11 §6.7)
  • 学员问"我这算通过吗" → 只回一句:"5 类都有回滚吗?错误预算是个数字吗?盲测做了吗? 三条都是'是',就是过。"

学员动作

  • 45 分钟独立完成(路径 A / B / C 三选一)
  • 自评 G6 四条 + 完成标准逐条打钩
  • 提交 → 收到 ✓
  • 在群里写 60 秒收获(照 07 §5 模板): 「对方最难的那个问题是什么?我用了什么回应?下次我会改什么?」

常见错误与纠偏

错误 纠偏(助教用)
Runbook 写成"说明书"(长篇介绍背景) 递回 12 §2.8:「五类事件,每类四段」——它要的是操作步骤,不是背景介绍(06 D6 常见坑第 1 条)
忘了写回滚 "修不好怎么退?"——补完再提交(06 D6 常见坑第 2 条)
SLO 写得很漂亮但一个都测不了 "每条必须有测量方式(12 §2.7)。测不了的指标删掉或降级成'待补充'"
盲测记录写成"效果很好" "记录里只留三种东西:断点、修法、复测。'很好'不是证据"
21:30 前赶不上 别慌:24 小时内补交 = 正常放行(标注"补交通过")——但要在群里报一句"我补交",别静默(06 §5)
提交里带了真实客户名 / 账号 撤回重交 + 合规日志,不做例外(11 §6.1 / §6.7)

附 A · D6 板书总图(一天下来的白板应该长这样)

┌────────────────────────────────────────────────────────────────────┐
│  D6 · 运维化 —— 你走了以后,谁修?                                  │
├────────────────────────────────┬───────────────────────────────────┤
│  六幕(S2)                     │  G6 稳运门(03 §3)                │
│  ① 成品先看:截断不报错          │  ① 5 类事件·每类回滚   🔴 blocker │
│  ② 四变体:只挡零,不挡糊弄      │  ② SLO 含错误预算      🔴 blocker │
│  ③ 生成骨架 ≠ 交付物             │  ③ 告警路由(谁/渠道/时限)🟡      │
│  ④ 盲测:问到"敲什么命令"        │  ④ 凌晨 2 点盲测通过   🔴 blocker │
│  ⑤ 漂移默认关:慢慢变差也是坏    │                                   │
│  ⑥ has no gate:门在人手上       │  工具门:slo(只挡零)· runbook 无门│
├────────────────────────────────┴───────────────────────────────────┤
│  实测数字(讲师速查):                                              │
│  gate 白湖 ✅ | noslo ❌ exit 1 | noroute ✅+⚠️ | nobudget ✅ 静默 │
│  gate one ✅(1 条也过)| atlas → Phase 'runbook' has no gate.       │
│  handoff --accept → 骨架 3 类事件(≠5);回滚=全局一段;§2 联系人 TBD │
│  白湖 §4.2 夹带"检查 OPC UA / MQTT / MES"(乳业文档里的工厂词)      │
│  监控模板:data_drift / quality_drift 双 false | dashboards: []      │
├────────────────────────────────────────────────────────────────────┤
│  三条红线:[1] 只 3 个新概念(SLO/预算 · Runbook · 漂移监控)         │
│           [2] 每类事件必须写回滚(不写 = G6 ① 不过)                  │
│           [3] 联系人只写角色,不写真人(11 §6 同一条红线)             │
│  「SLO 没有测量方式 = 口号。」|「模板不认识你的客户。」               │
│  「凌晨 2 点没人爱你,除了你的文档。」(05 §7)                       │
│  停车位:________________(SLI / 燃烧率 / MTTR / 混沌工程…)          │
└────────────────────────────────────────────────────────────────────┘

附 B · 讲师自查(下课前 5 分钟)

  • ☐ 三条红线全守住了?有没有冒出第 4 个概念却没进停车位(SLI / MTTR / 燃烧率最容易漏)?
  • ☐ S1 的沉默 10 秒真做了吗?群接龙「我最怕接到的凌晨电话」接了吗?
  • ☐ 幕 1 的窄版 engage list 跑了吗(截断不报错)?
  • ☐ 幕 2 四个变体先猜后揭了吗?nobudget 的"静默通过"讲透了吗?
  • ☐ 幕 3 白湖 §4.2 的 "OPC UA / MQTT / MES" 念出来了吗(模板不认识你的客户)?
  • ☐ 幕 4 三刀当场砍了吗?被抽的学员"答不上来"被接住了吗?
  • ☐ 幕 5 的两个 "enabled": false 全班齐念了吗?反模式 #7 / #3 都点名了吗?
  • ☐ 幕 6 的 has no gate 念了吗?"G6 四条里 3 条靠人"说清了吗?
  • ☐ S3 错误预算全班一起算了吗(3.6h)?
  • ☐ 助教三趟巡场到位了吗(测量方式 → 回滚 → 联系人角色化)?
  • ☐ S4 盲测真的交换念了吗(讲师示范 + 两两交换)?断点归类(命令/对象/人)板书了吗?
  • ☐ #3 Hero Engineer("找我就行")有没有人被抓出来替换?
  • ☐ G6 四条、四个文件名、截止(次日 21:30)、补交规则都念全了吗?
  • ☐ D7 三个钩子埋了吗(交给一个不爱你的人 / 适用边界 / 最后一次签名)?
  • ☐ 命令都从仓库根执行的吗(FDE_SCOPE_HOME=/tmp/fde-d6-demo,seeder 只在仓库里 seed)?
  • ☐ 未提交名单记下来了吗(次日 08:30 前私聊)?

下一节:22-D7逐节教案.md(交接与沉淀:交得出去,带得走) 本日配套:02 Day 6(时间盒总表)· 06 D6 任务卡 · 07 §2.3 / §3.5 / §5 · 11 §6(数据合规与 PII 红线)· 12 §1.4 / §1.6 / §2.7 / §2.8 / §2.9 / §3.5

22 · D7 逐节教案:交接与沉淀(交得出去,带得走)

22

course-level-1/22-D7逐节教案.md

①本文件是 D7(90 分钟直播 + 45 分钟自练)的逐节执行稿:讲师按节念、助教按节做;文中所有命令与输出均为本仓库实测。 ②上游时间盒:02 Day 7|通用骨架与控场:05 §2 / §4(D7 五条带教要点) ③模板与术语:12 §1.6(#1 Consulting Trap · #8 Infinite Pilots)· §2.10(交接包清单)· §2.11(验收清单)· §2.12(退场计划)· §2.13(技能卡)· §3.4(概念 → 阶段映射) ④演练素材:07 §2.5(案例 E · 明源体检 · 止损示范)· §3.6(客户运维负责人刁难剧本)· §4.3(角色卡)· §5(点评格式与观察表) ⑤数据红线:11 §6|学员侧任务卡:06 D7|门禁条款:03 §3 G7 行 ⑥本日演示数据:茶语万象(Teaverse · ticket · 走到 disengage / handoff,15 阶段走完)——全部虚构|演示工作目录:/tmp/fde-d7-demo(不写进仓库) ⑦⚠ 环境提示(今天必踩):skill list 的表格会截断 id 列(skill-6f8d…——从表里抄下来的 ID 是残废的,skill show 会报"技能不存在");技能 ID 每次运行都不同,演示脚本必须从 skill add 的输出里抓 $SID;演示目录是一次性耗材(脚本开头 rm -rf 重建);seeder 不认 FDE_SCOPE_HOME(要 cd 进演示目录执行)


0. 今天的三条红线(全天不许破)

# 红线 怎么守
1 只准出现 3 个新概念:交接包(四件套)· 知识转移(教会 ≠ 讲完)· 退场(有始有终的时间盒)。第 4 个(SLA / OLA / 知识库工程 / 影响力报告…)一律进停车位,课后再讲。客户面前说人话:"我走了你手里有什么" / "你能自己教别人了吗" / "我什么时候走" 开课前把停车位画好;每次有人冒新词,笔一指停车位,不上台展开(05 §2)
2 四件套缺一不算交接(G7 ① blocker)+ 验收清单含签字人(G7 ② blocker)。判据原文(12 §2.10):"四件套缺一不算交接";G7 判据(03 §3):"客户能否拿着它独立跑一周?不能则未达" 巡场第一趟只问一句:"客户不打电话,能活几天?"(05 §5)答不上来的当场标红
3 技能卡必须写"适用边界",退场计划必须写"终止条件"(G7 ③④ warning——工具不拦,全靠人守)。判据原文:12 §2.13"不写边界的技能卡是坑人"、§2.12"没有退场计划的交付 = 无限售后"。签字人 / 联系人只写角色,不写真人 巡场第二、三趟:只看终止条件可不可判定、只扫适用边界与真人信息;缺了当场补

今天没有硬性休息:D7 的节奏是"讲 25 分钟 → 装配 35 分钟 → 演 10 分钟",装配交接包的 35 分钟就是自然喘息点(学员在拷文件、写清单,讲师和助教在巡场,不需要统一喊停)。

为什么今天"必须演练签字":G7 四条里,工具能帮你管一半——今天实测,handoff_signoff 门在资料不全时给 ❌ BLOCKED + 🚫 移交包缺失: ['eval_report', 'training_material'] + 🚫 客户尚未书面接受移交——不得退场;但四件凑齐、勾上 --accept 之后,工具立刻 ✅ PASS——它读不出成色(training_material 在工具眼里只是一句字符串,写"培训过了"和写"店长培训包 v2(16 场)"一个待遇)。G7 ③④(适用边界、终止条件)工具里连字段都没有。今天的质量全部靠"换个人来问"兜底——所以签字演练不是仪式,是检验。

今日 6 节课总览

节 时间 一句话目标 学员产出 记忆锚点
S1 回炉 0–10 把 D6 三件套翻篇,直面"你走了以后,谁会" 群接龙一条"只有我会"的事 "你走了以后,谁会?"
S2 讲与演 10–35 看懂"工具只数件数,不看成色" 六幕实测记录(含一次 BLOCKED) "四件套缺一不算交接"
S3 上手 35–70 装配交接包 + 验收清单 + 技能卡 + 退场计划 🎯 产出 7 四样 v1 "给客户用的,不是给自己看的"
S4 复盘 70–80 接受"客户运维负责人"的签字演练 每条 ≥2 项修复清单 "交接是你留在现场的最后一次签名"
S5 布置 80–90 念清 G7 四条 + D8 预告 记下命名 / 截止 / 三个钩子 "明天带齐 7 件产出"
S6 自练 +45 独立完成、自查、提交 四件提交物 + 技能卡已发布 "客户不打电话,能活几天?"

今日产出物(🎯 产出 7):四样东西—— ① 交接包(四件套:Runbook + 评估报告 + SLO 卡 + 培训材料题纲) ② 验收清单(谁验收 / 验收标准 / 签字人) ③ 技能沉淀卡(1 张,五要素:场景 → 问题 → 做法 → 证据 → 适用边界;已 publish) ④ 退场计划(30/60/90 天支持阶梯 + 终止条件) —— 一句话:"我走了,你接得住。"

通关门禁 G7 原文(03 §3): ① 交接包四件套齐全(Runbook/评估报告/SLO/培训材料) ② 验收清单含签字人 ③ 技能卡含"适用边界" ④ 退场计划有终止条件 —— ①② blocker;③④ warning。 ⚠ 注意:工具侧只认"件数 + 签字"——handoff_signoff 只拦 eval_report / training_material / customer_accepted 三项;③④ 靠助教巡场兜底,但明天作品集要查(12 §2.14 索引第 7 行)。


S1 · 回炉(0–10 min · 10 min)

本节定位:D6 交上来的三件文档里,"回滚有没有分类""联系人是不是角色"是本节的讲评素材;同时用一问一接龙,把全班从"运维心态"切到**"交接心态"**——从"系统坏了有人修"切到"我走了以后,这些东西谁能接、谁能教、我什么时候走"。

一句话目标(开场念):"昨天问的是'谁来修';今天问的更难:你走了以后,谁会?"

分钟级时间盒

分钟 动作 目的
0–3 G6 讲评:一优一劣(各 1 分钟 + 30 秒收口) 把"每类回滚 / 联系人角色化"两条红线再钉一遍
3–8 开场问 + 群接龙:"你走了以后,谁会?" 沉默 10 秒 → 接龙"我手里那件'只有我会'的事" 制造今天的心理入口:知识要能转移,退场要有时间盒
8–10 今日地图:三个新概念 + 停车位 + 四样产出 让学员知道 90 分钟后手里会多什么

讲稿要点

① 0–3 min|G6 讲评:一优一劣(05 §2:优的要讲"为什么好",劣的要讲"我也犯过")

  • 优(念原话 + 为什么好):抽一份"5 类事件 × 四段齐全、回滚指名道姓"的 Runbook。念完追问全班:

    "好在哪里?好在'修不好怎么退'写在纸上,不需要问人。 记住这句——今天你要做的事,就是让客户连'问谁'都不用问。"

  • 劣(不点名):找一份"联系人写了真人"或"回滚写'恢复备份'"的:

    "这份我第一天也这么写——写名字是信任自己,写角色才是信任系统。 今天四样产出,我会用同一把尺子量:换一个你不认识的人来,它还能用吗?"

② 3–8 min|开场问 + 群接龙(05 §4 D7 第 1 条原话:"'交接不是走过场,是你专业度的最后一道签名。'")

  • 念完升级版问题——"昨天问'你走了以后谁修',答案可以是文档;今天问'你走了以后,谁会?'"——真的沉默 10 秒(盯着秒表,不许救场)。10 秒后不点名、不评价,直接发群接龙:

    "群里接一条:我手里那件'只有我会'的事。 一句话,不许写'整个项目'这种废话——写具体的、别人不知道的。"

  • 讲师先自接一条作示范,再挑三条有层次的念出来,逐条点评(这三条是今天的"交接地图"):
群接龙(示例) 讲师点评 今天对应
"那个参数调几,只有我知道。" 参数级隐性知识——在你脑子里,不在纸上 技能卡(知识转移)
"这规矩没写下来,但我一直这么做。" 口头规矩——你一走,规矩就死了 培训材料(题纲)
"出事了他们还是会打我电话。" 没退场的售后——你人走了,责任没走 退场计划(时间盒 + 终止条件)

③ 8–10 min|今日地图

  • 三个新概念写黑板(今天就这三个,多一个都进停车位):
    1. 交接包(四件套)——"我走了你手里有什么":Runbook + 评估报告 + SLO 卡 + 培训材料题纲
    2. 知识转移(教会 ≠ 讲完)——"你能自己教别人了吗":技能卡 + 培训材料
    3. 退场(有始有终的时间盒)——"我什么时候走":30/60/90 天支持阶梯 + 终止条件
  • 四样产出物写黑板(S3 结束时每人手里要有初稿):交接包 / 验收清单 / 技能卡 / 退场计划。

投屏·板书

┌────────────────────────────────────────────────────────────┐
│ D7 · 交接与沉淀 —— 交得出去,带得走                          │
│ 三个新概念:① 交接包(四件套) ② 知识转移 ③ 退场            │
│ 停车位:SLA / OLA / 知识库工程 / 影响力报告 ……              │
├────────────────────────────────────────────────────────────┤
│ 四样产出:交接包 · 验收清单 · 技能卡 · 退场计划              │
│ G7 ①② blocker(件数 / 签字人)|③④ warning(边界 / 终止)   │
│ 工具只数件数,不看成色                                      │
└────────────────────────────────────────────────────────────┘

互动设计

  • 沉默 10 秒后不立刻给答案,先看群接龙刷屏——让"只有我会"的密度自己浮现出来。
  • 挑念的三条接龙覆盖三层(参数 / 规矩 / 电话),念完说一句:"这三条,今天各有一个容器接住它。"
  • 问一句:"这 10 秒的空白,像不像你走后客户现场的样子?"——不要求回答,直接翻页。

常见错误与纠偏

错误 纠偏
学员觉得"交接 = 发封邮件把文档发过去" "发文档 ≠ 交接。 你昨天写的 Runbook 是'有人修';今天要证明'不打电话也能修'——这就是验收清单存在的意义"
有人写"只有我会"写成"整个项目只有我会" "太大 = 没写。写到'那条参数 / 那个规矩 / 那通电话'的颗粒度——那才是能转移的知识"
学员问"我今天是不是可以开始写简历了" "停车位。 简历是 D8 的事;今天先把手里这摊交清楚——交得出去,才写得出"
有人流露"交接完我是不是就没价值了" 正面接住:"恰恰相反。 交不出去的才叫手艺,交得出去的叫资产——12 §1.6 术语叫**#1 Consulting Trap** 的反面:每做完一个项目,你手里多一张卡,不是多一段口述"

承接语(最后 30 秒)

"'只有我会'的每一件事,都是你走后的一颗雷。 接下来 25 分钟,先看工具把交接这件事'数'到什么程度—— 记住那个画面:件数齐了,门就开了;但门开着,不代表客户能活。"

学员笔记要点

  • 三个新概念(默写):交接包 / 知识转移 / 退场
  • 我的"只有我会"是哪一层:参数级 / 规矩级 / 电话级(打钩)
  • 四样产出名(抄一遍):交接包 · 验收清单 · 技能卡 · 退场计划
  • G7 四条里,工具管了:____ 条(答:①② 的一半——件数与签字);靠人判:____ 条

S2 · 讲与演(10–35 min · 25 min)

本节定位:六幕实测——从"走到最后的档案"看到"工具把交接数成什么"。全场的核心认知:工具只认"件数 + 签字",成色全靠人;而每次被门挡住,还会顺手长出一张草稿技能卡(复利的起点)。

一句话目标(开场念):"今天只看一件事:交接这件事,机器能查到哪一步、查不到哪一步。"

分钟级时间盒

分钟 幕 动作 这一幕教什么
10–14 幕 1 engage list 指认唯一 disengage / handoff 的档案 + engage status 三行必念 #8 Infinite Pilots 的终点是"被定义出来"的
14–18 幕 2 不带参数的 handoff → 三行 — / ❌ 每次调用 = 一次完整状态声明,不是补差异
18–22 幕 3 gate check:把缺口一次念清(含自动沉淀彩蛋) 缺口不是"我不行",是可见、可修
22–26 幕 4 四件齐 + --accept → ✅ PASS → 泼水 工具管"有没有",人管"能不能用"
26–31 幕 5 技能卡 add → show → publish(两把刀:适用边界 / slug) 交接出去的是文档,带走的是复利资产
31–35 幕 6 --search / --phase / skill review 草稿队列 今天你被挡的每一次,都在为未来的你写草稿

讲稿要点

① 幕 1(10–14 min)|指认"走到最后"的档案

  • 跑 COLUMNS=200 版 engage list,扫过 10 行,指出今天主角——唯一一行走到 disengage 的:

    │ eng-teaverse-ticket-seed01 │ 茶语万象(Teaverse) │ ticket │ disengage │ handoff │ "注意 zone: handoff:这个档案已经走完了 15 个阶段,走到'退场'了。 它是这段时间里唯一一个把项目做到底的——今天我们看它怎么收场。"

  • 跑 engage status,三行逐字念:

    phase: disengage (zone: handoff) → next: — gate: handoff_signoff (✅ passed) progress: 15 phases visible · complete=True "next: — 是什么意思?没有下一阶段了,这就是终点。"

  • 挂反模式(12 §1.6):#8 Infinite Pilots——"永远试点、永远不定义 done(永远在试点、永远不验收、永远不付款。反制:先定义 done)"。

    "为什么很多 AI 项目死不了也活不好?因为没人定义过'完成'。这个档案的 complete=True 不是工具赏的,是当初委托单里写死了 done 与时间盒。"

  • 补三个数(委托单里给客户看的承诺,写屏幕):≥14 天集成窗口 / ≤90 天上线 / ≤120 天交接。

    "交接不是无限期的。 到了时间盒,就要走流程——今天的门禁就是那个流程。"

② 幕 2(14–18 min)|先讲旧闻,再跑不带参数的 handoff

  • 先交底(别破梗):"这个档案 seed 进来的时候,交接包是满的——四件套齐、客户已接受。为了让你看清机制,我们先跑一次不带参数的:看它会说什么。"

  • 跑 handoff eng-teaverse-ticket-seed01(三个参数全不传),逐行念:

    屏上出现 念法
    - eval report: — "评估报告:空。它不会'记得'上次填过什么——每次调用都是一次完整的状态声明。"
    - training material: — "培训材料:空。"
    - customer accepted: ❌ "客户接受:否。你看,一次遗漏的参数,就把'已验收'打回了'未验收'。"
  • 收口成两句话:

    1. 每次调用 = 一次完整状态声明,不是"补差异"——生产纪律:只在四件都在手上的时候跑,跑完立刻 gate check(不然你的档案会被一次马虎的调用打回原形);
    2. 退出码是 0——"工具没生气。它只是如实记下了'你现在什么都没交'。"

③ 幕 3(18–22 min)|gate check:把缺口一次念清

  • 跑 gate check eng-teaverse-ticket-seed01 --gate handoff_signoff,屏幕出现(退出码 1):
❌ BLOCKED · gate=handoff_signoff
  🚫 移交包缺失: ['eval_report', 'training_material']
  🚫 客户尚未书面接受移交——不得退场
💡 已把这次阻塞沉淀为草稿 skill-… — fde-scope skill review 可查看并完善
  • 逐行念 + 对照 G7:

    "① ❌ BLOCKED · gate=handoff_signoff——G7 ①(四件套)和 ②(签字)合体的门。 ② 🚫 移交包缺失: ['eval_report', 'training_material']——注意它没有列 runbook 和 SLO:那两件 seed 里是齐的。它只报缺的。 ③ 🚫 客户尚未书面接受移交——不得退场——这句话是全课程最重的一句门禁语:没有客户签字,你不许走。 ④ 最后一行是彩蛋——先别讲,幕 5 回来收。"

  • 板书缺口表("可见、可修"):
缺口 对应 G7 谁来补
eval_report 缺失 ① 你——D5 的定稿评估报告
training_material 缺失 ① 你——培训材料题纲(不用全文)
customer_accepted: ❌ ② 客户——先演签字(S4),再真签

④ 幕 4(22–26 min)|四件齐 + --accept → 门开了,然后泼水

  • 跑完整版(三个参数都带):
    handoff eng-teaverse-ticket-seed01 \
      --eval-report reports/teaverse-corpus.html \
      --training-material "店长培训包 v2(16 场)" --accept
    
    屏幕三行回填:- eval report: reports/teaverse-corpus.html / - training material: 店长培训包 v2(16 场) / - customer accepted: ✅。
  • 再跑 gate check … --gate handoff_signoff → ✅ PASS · gate=handoff_signoff(退出码 0)。

    "门开了。但注意——我们只是把它更新了一遍,它就把'上次没交'的旧账清了。"

  • 泼水(全场最重要的一段):

    "工具刚才检查了什么?三件事:一个文件路径、一句字符串、一个布尔。 它没有打开那份评估报告看结论有没有被推翻;没有打开培训材料看有没有真的 16 场;更没有问你——客户运维能不能照着 Runbook 独立处理一次事件。 记住这条分界线:工具管'有没有',人管'能不能用'。 G7 ③④ 连'有没有'都没查——它们是门口那条没装的锁,理由只有一条:成色没法自动判。"

⑤ 幕 5(26–31 min)|技能卡:交接出去的是文档,带走的是资产

  • 先念回幕 3 的彩蛋:💡 已把这次阻塞沉淀为草稿 skill-… — fde-scope skill review 可查看并完善

    "被大门挡住不是白挡——它顺手把你的失败沉淀成了一张草稿技能卡。 这就是今天的第二个产出:知识转移。"

  • 技能卡正文五要素(12 §2.13,一字不改):场景 → 问题 → 做法 → 证据 → 适用边界。

    "最后一条最重要——§2.13 原文:'不写边界的技能卡是坑人'。为什么?因为下一个人拿着你的卡去用,用错了场景,坑的是他。"

  • 跑 skill add(正文用准备 1 写好的 card.md):
    skill add --title "Runbook 完备性三刀盲测法" --category methodology \
      --tags "handoff,runbook,blindtest" --body-file /tmp/fde-d7-demo/card.md \
      --phase ops_handoff --gate handoff_signoff \
      --engagement eng-teaverse-ticket-seed01
    
    → ✅ 草稿创建 skill-… — fde-scope skill review 可审阅
  • 第一把刀:从 add 的输出里抓 ID(⚠ 今天全班必踩的坑):

    "现在想 show 这张卡,你需要它的 ID。千万别从 skill list 的表格里抄——表格会把 ID 截断成 skill-6f8d…,你抄下来的是残废 ID,skill show skill-6f8d 只会回你一句'技能不存在'。 正确姿势:从 add 的纯文本输出里抓完整 ID—— SID=$(… skill add … | grep -o 'skill-[a-f0-9]\{8\}' | head -1) 这和 D6 幕 1 的 engage list 截断是同一种沉默:数据被截断的时候,工具不报错。"

  • 跑 skill show "$SID",元数据两行逐字念:

    Runbook 完备性三刀盲测法 · methodology · draft · v1 tags=[...] · phase=ops_handoff · gate=handoff_signoff · applies_to=[] · source=manual 源自: eng-teaverse-ticket-seed01 · 创建: … · 更新: … "重点看 phase=ops_handoff / gate=handoff_signoff——这张卡被挂到了真实的阶段和门禁上,以后有人在这个阶段被卡住,skill list --phase ops_handoff 就能搜到它。"

  • 第二把刀:slug 陷阱(⚠ 备用幕现场演示):--phase / --gate 填真实 slug(12 §3.4);填错的卡能被创建,但检索不到——"写错的卡等于没写。"
  • 翻转 card.md 的"适用边界"段原文照念(这四行就是今天技能卡的合格线):

    - 适用:有明确操作步骤的运维文档(Runbook / SOP / 值班手册) - 不适用:策略类、沟通类文档(靠情景判断,盲测问不出断点) - 前提:必须有未参与项目的第三方执行盲测;作者自测不算

  • 确认无误后 skill publish "$SID" → ✅ 已发布 skill-…。

    "发布之后,它就从'你的卡'变成了'团队的卡'。"

  • 挂反模式(12 §1.6):#1 Consulting Trap——"FDE 越做越像定制外包,产品永远长不出来";反制原文:"每做完一个项目必须沉淀技能卡(skill add)"。

    "做完一个项目,你留下两样东西:给客户的是文档,给自己和团队的是卡。 文档会过时,卡会复利。"

⑥ 幕 6(31–35 min)|复利开始:检索与草稿队列

  • 跑三条检索命令,各念一行结果:
    skill list --search 盲测        # → Skills · 1
    skill list --phase ops_handoff  # → Skills · 2
    skill review                    # → Draft queue · 7
    

    "--search 盲测:1 张——我们刚发的卡。 --phase ops_handoff:2 张——除了我们的卡,还有 seed 里那张团队沉淀的'移交验收会签清单'。同一个阶段,两张卡可以叠加用。 skill review:7 张草稿在排队。"

  • skill review 的草稿队列三类来源(逐类点名):
    • manual——人手写的(你 S3 要交的卡);
    • auto_capture——工具自动抓的(gate_pass 记录: …——你通过门禁的记录本身也能提炼成卡);
    • gate_hint——被门挡出来的(gate 被阻塞: handoff_signoff — 移交包缺失: […]——就是幕 3 那张)。

    "看明白了吗?今天你被挡的每一次,都在为未来的你写草稿。 这就是为什么这套工具越用越厚:门挡人,人修门,修的过程变资产。"

  • 收口幕 6(12 §3.5 原文:"跑完 gate check / advance 后技能卡多了一张 skill-xxxx 草稿 | 飞轮设计:门禁阻塞被自动沉淀成知识 | 预期行为"):

    "这不是 bug,是飞轮。"

投屏·板书

  • 左侧:六幕的"必出现的证据"(讲师速查表第三列),逐幕留下、不切屏
  • 右侧两行红字: 工具管"有没有" | 人管"能不能用" 四件套:Runbook + 评估报告 + SLO 卡 + 培训材料
  • 底部一行:合格线:客户能否拿着它独立跑一周?(03 §3 G7 判据)
┌────────────────────────────────────────────────────────────┐
│ 幕 1  disengage / handoff · next: —        (#8 无限试点) │
│ 幕 2  不带参数 = 完整状态声明              (三行 — / ❌)  │
│ 幕 3  ❌ BLOCKED:缺 2 件 + 没签字         (缺口可见可修)│
│ 幕 4  ✅ PASS:只查了 件数 + 字符串 + 布尔  (人管成色)    │
│ 幕 5  skill add → 抓 ID → show → publish   (适用边界必填)│
│ 幕 6  --search 1 | --phase 2 | 草稿 7     (飞轮开始转)  │
├────────────────────────────────────────────────────────────┤
│ 工具管"有没有" | 人管"能不能用"                           │
│ 合格线:客户能否拿着它独立跑一周?                          │
└────────────────────────────────────────────────────────────┘

演示脚本(可直接复制执行)

⚠ 数据在演示目录、CLI 从仓库根跑:seed 要 cd 进演示目录执行;CLI 命令在仓库根执行,用 FDE_SCOPE_HOME 指过去。六幕合计约 25 分钟;不需要任何 API key。演示目录是一次性耗材——脚本开头会重建它。

# ── 准备 0|重建一次性演示目录并 seed(seed 要 cd 进演示目录执行)──
rm -rf /tmp/fde-d7-demo
mkdir -p /tmp/fde-d7-demo && cd /tmp/fde-d7-demo
<仓库根>/.venv/bin/python <仓库根>/examples/seed_mock_engagements.py
# 期望:10 engagements → /tmp/fde-d7-demo/.fde_scope/engagements
#       29 skills (24 published, 5 drafts)

# ── 准备 1|写好今天的技能卡正文(卡里不含任何真实客户信息)──
cat > /tmp/fde-d7-demo/card.md <<'EOF'
# 技能卡 · Runbook 完备性三刀盲测法

## 场景
交付验收前的运维交接。客户运维只有 1 人,且没有参与过项目。

## 问题
Runbook 看着很全(章节齐全、术语专业),但同事按文档处理一次真实事件时卡壳——文档"像"能看懂,用起来全是断点。

## 做法
盲测三刀,每刀只问一类问题:
1. 命令层:"按这句话,凌晨 2 点的人具体敲什么命令?"
2. 对象层:"切回上一个快照——哪个快照?目录在哪?"
3. 人层:"升级联系人是谁?怎么找到他?他不接怎么办?"

## 证据
- 茶语万象交接:盲测发现 5 处断点(命令 2 / 对象 1 / 人 2),修改后复测全过
- 盲测记录:D6-张三-盲测记录.md

## 适用边界(⚠ 必填)
- 适用:有明确操作步骤的运维文档(Runbook / SOP / 值班手册)
- 不适用:策略类、沟通类文档(靠情景判断,盲测问不出断点)
- 前提:必须有未参与项目的第三方执行盲测;作者自测不算
EOF

# ── 准备 2|CLI 从仓库根跑,数据指到演示目录 ──
cd <仓库根>
export FDE_SCOPE_HOME=/tmp/fde-d7-demo

# ── 幕 1(10–14)|指认"走到最后"的档案 ──
COLUMNS=200 .venv/bin/python -m fde_scope.cli engage list
.venv/bin/python -m fde_scope.cli engage status eng-teaverse-ticket-seed01

# ── 幕 2(14–18)|不带参数的 handoff = 一次完整状态声明 ──
.venv/bin/python -m fde_scope.cli handoff eng-teaverse-ticket-seed01

# ── 幕 3(18–22)|gate check:把缺口一次念清(退出码 1)──
.venv/bin/python -m fde_scope.cli gate check eng-teaverse-ticket-seed01 --gate handoff_signoff
# ❌ BLOCKED(退出码 1)

# ── 幕 4(22–26)|四件齐 + 书面对接,再自查 ──
.venv/bin/python -m fde_scope.cli handoff eng-teaverse-ticket-seed01 \
  --eval-report reports/teaverse-corpus.html \
  --training-material "店长培训包 v2(16 场)" --accept
.venv/bin/python -m fde_scope.cli gate check eng-teaverse-ticket-seed01 --gate handoff_signoff
# ✅ PASS(退出码 0)

# ── 幕 5(26–31)|技能卡:add → 从 add 输出抓 ID → show → publish ──
# ⚠ skill list 的表格会把 id 截断成 skill-6f8d…(抄下来是残废 ID,show 会报"技能不存在");
#   必须从 add 的纯文本输出里抓完整 ID:
SID=$(.venv/bin/python -m fde_scope.cli skill add \
  --title "Runbook 完备性三刀盲测法" --category methodology \
  --tags "handoff,runbook,blindtest" --body-file /tmp/fde-d7-demo/card.md \
  --phase ops_handoff --gate handoff_signoff \
  --engagement eng-teaverse-ticket-seed01 | grep -o 'skill-[a-f0-9]\{8\}' | head -1)
echo "$SID"
.venv/bin/python -m fde_scope.cli skill show "$SID"
.venv/bin/python -m fde_scope.cli skill publish "$SID"

# ── 幕 6(31–35)|复利:检索(search / phase)+ 草稿队列 ──
.venv/bin/python -m fde_scope.cli skill list --search 盲测
.venv/bin/python -m fde_scope.cli skill list --phase ops_handoff
.venv/bin/python -m fde_scope.cli skill review

# ── 备用幕(时间富余才放)|① slug 打错 = 检索不到(卡还在)──
.venv/bin/python -m fde_scope.cli skill list --phase ops_handof        # 打错一个字母
.venv/bin/python -m fde_scope.cli skill list --search 移交验收          # 卡还在:Skills · 1
# ── 备用幕 ②|导出成 AgentScope 可复用格式 ──
.venv/bin/python -m fde_scope.cli skill export "$SID" --format agentscope

命令与预期输出对照(讲师速查)

幕 命令 必出现的证据 退出码
1 engage list(COLUMNS=200)+ engage status <id> 唯一一行 disengage + handoff;next: —;complete=True;3 条门禁记录 ✅ 0
2 handoff <id>(不带参数) - eval report: — / - training material: — / - customer accepted: ❌ 0
3 gate check <id> --gate handoff_signoff ❌ BLOCKED + 🚫 移交包缺失: ['eval_report', 'training_material'] + 🚫 客户尚未书面接受移交——不得退场 + 💡 …草稿 skill-… 1
4 handoff <id> --eval-report … --training-material … --accept + gate check 三行回填(✅)+ ✅ PASS · gate=handoff_signoff 0
5 skill add … → $SID → skill show → skill publish ✅ 草稿创建 skill-…;元数据两行;✅ 已发布 skill-… 0
6 skill list --search 盲测 / --phase ops_handoff / skill review Skills · 1 / Skills · 2 / Draft queue · 7(三类来源) 0
备① --phase ops_handof / --search 移交验收 无匹配技能(打错 slug 不报错)/ Skills · 1(卡还在) 0
备② skill export "$SID" --format agentscope ✅ 导出 1 个文件 → …/.fde_scope/skills/export (agentscope) 0

⚠️ 技能 ID 每次运行都不同(skill-6f8d… 只是本次运行的示例)——别背 ID、别抄表里的 ID,演示脚本永远用 $SID。

互动设计

  • 幕 2 三行 — / ❌ 出来时先问全班:"这是工具记错了,还是我们真的没交?"——把"无状态调用"的概念问出来再讲。
  • 幕 3 的 🚫 客户尚未书面接受移交——不得退场 让全班齐念一遍——这是全场最重的一句门禁语。
  • 幕 4 泼水前先问:"它刚才查了几件事?"(举手猜:3?5?10?)——掀开"其实只查了 3 件事"的落差,比直接讲效果好三倍。
  • 幕 5 让一位学员念 card.md 的"适用边界"三行——让'不写边界的技能卡是坑人'从学员嘴里念出来。
  • 幕 6 抽一位学员把三类草稿来源(manual / auto_capture / gate_hint)指认一遍。

学员动作(现场)

  • 六幕各记一行"必出现的证据"(就是讲师速查表的第三列)
  • 在笔记里写下幕 4 的结论分界线:工具管"有没有",人管"能不能用"
  • 记下 ID 抓取的正确姿势:从 add 输出抓 $SID,不从 list 表格抄(残废 ID 的教训)
  • 把 G7 ③④ 圈出来:"工具不查这两条——全靠人。"

常见错误与纠偏

错误 纠偏
学员以为"✅ PASS = 交接合格" 指着幕 4 的三行回填:"它只看了件数、一句话、一个布尔。 客户能不能活,它不知道——那是 S4 演练要替你回答的"
有人看到 ❌ BLOCKED 说"工具太严" "它列的两条 🚫 就是 G7 ①②——你最需要的两条。缺口写在这里,比写在客户的差评里强"
从 skill list 表格抄了 ID,show 报"技能不存在" "这就是截断的代价。 表格是给人扫的,不是给机器抄的——回到 add 输出抓完整 ID。工具沉默,你要自己多问一句'这是全的吗'"
有人问"草稿卡为什么越来越多了" "那是飞轮不是垃圾:auto_capture / gate_hint 是你踩过的坑自动记的账。每周 skill review 一次,把值钱的完善发布"
学员问"技能卡发到哪了、谁看得到" "publish 之后进团队技能库——这就是'知识转移'的容器。检索姿势:--search 关键词、--phase / --gate 用真实 slug(§3.4)"

承接语(最后 30 秒)

"看清了:门只数件数,客户要的是'能活'。 所以接下来 35 分钟,你要自己给自己装配四样东西—— 交接包、验收清单、技能卡、退场计划,全部按'给客户用'的标准写。"

学员笔记要点

  • 幕 1 三行:next: — / complete=True / 3 门禁 ✅——终点是被定义出来的(#8 Infinite Pilots)
  • 幕 2 结论:每次调用 = 一次完整状态声明(不是补差异)
  • 幕 3 两条 🚫 原文 + 幕 4 分界线:工具管"有没有",人管"能不能用"
  • ID 抓取:add 输出抓 $SID;list 表格会截断(残废 ID)
  • 技能卡五要素(默写):场景 → 问题 → 做法 → 证据 → 适用边界(必填)
  • G7 四条里,工具管了:____ 条(答:①② 的"件数 + 签字");靠人判:____ 条(③④)

S3 · 上手(35–70 min · 35 min)

本节定位:把六幕的"看"变成"装配"。四样产出物不是作文——每一格都有判分口径。本节结束时,每个人的四样都要有能拿去做签字演练的 v1。

一句话目标(开场念):"接下来的每一行,都问自己一句:这是给客户用的,还是给自己看的?"

分组建档复核(讲师,1 分钟)

沿用 D2 定稿的分组委托单,每个组选自己案例里的一个系统:

组 案例(D2 定稿的委托单) 今天装配的对象 可参照的样板
A 组 案例 B · 迅捷出行(ticket) 工单 Agent 的交接包 eng-teaverse-ticket-seed01 的四件套(成品结构,但技能卡与退场计划必须自己写)
B 组 案例 C · 南湾汽车(manufacturing) 产线 Agent 的交接包 eng-atlas-manufacturing-seed02 的交接包(结构通用,别照抄 ticket 事件清单与术语)

讲师提醒:参照的是"结构完整度",不是"内容对错"——两个样板都是虚构场景的产物,术语和事件清单跟你的客户无关。它们是脚手架,不是答案。

分钟级时间盒(学员视角)

分钟 动作 交付到哪一步
35–38 定对象 + 建文件名(四样) D7-姓名-交接包 / -验收清单 / -技能卡 / -退场计划 四个空文件
38–48 装配交接包:四件套(Runbook + 评估报告 + SLO 卡 + 培训材料题纲) 交接包 v1(四件齐、清单可核对)
48–56 写验收清单:逐条对照委托单 §3 成功标准(两不许) 验收清单 v1(含签字人角色)
56–62 写退场计划:三阶支持表 + 终止条件 + 知识资产归属 退场计划 v1
62–64 写技能卡:五要素 → skill add → 确认 → publish D7-姓名-技能卡(已发布)
64–67 换包两问:把验收清单念给邻座(对方扮客户) 修复项清单(≥2 条)
67–70 自查 G7 四条 + 按命名改名 四样 v1,可提交

⚠️ 助教巡场时序(三趟,每趟只查一件事): 第一趟(≈42 min)问"客户能不能活"——「客户不打电话,能活几天?」(05 §5)答"应该……吧"的当场标红。 第二趟(≈56 min)查"终止条件"——退场计划里的终止条件可不可判定?「'长期支持''满意为止'不算——什么数字、什么天数?」 第三趟(≈62 min)扫"边界 + 真人"——技能卡有没有"适用边界"段(缺 = G7 ③ 不过);签字人 / 联系人里有没有真实姓名 / 手机号 / 邮箱(有 = 当场替换)。

讲稿要点

① 35–38 min|定对象 + 建四文件

  • 四样文档各自独立成文件(G7 按件判分),文件名先建好——文件名就是承诺。
  • 写之前先答一个问题(写屏幕上):"客户不打电话,能活几天?"

    "回答不了的,先别写交接包——你连'活'的标准都没有。"

② 38–48 min|装配交接包:四件套,一件不少

  • 四件套清单照 12 §2.10,一字不改("四件套缺一不算交接"):
# 件 从哪来 合格线
1 Runbook D6 定稿 5 类事件 × 四段,每类含回滚
2 评估报告 D5 定稿 含 bad case Top3 与结论
3 SLO 卡 D6 定稿 含错误预算与告警路由
4 培训材料(题纲即可) 今天新写 面向客户运维角色,不是产品说明
  • 工具路径(12 §2.10):
    fde-scope handoff <你的档案id> \
      --eval-report <报告路径> --training-material <材料路径> --accept
    

    提示:--accept 是你的声明("客户已书面接受")——S4 演练通过之前不许勾;生产里只在四件都在手上时跑,跑完立刻 gate check。

  • 培训材料题纲长度参考(写屏幕):一页装得下——

    "第 1 场:系统是什么 / 数据从哪来(30 min)· 第 2 场:怎么用(场景演示 4 个)· 第 3 场:出事了看哪里(告警 → Runbook 入口)· 第 4 场:常见问题 10 问" "客户运维只有 1 人的时候,题纲里写明:哪些场次可以合并、哪些必须现场做。"

③ 48–56 min|验收清单:逐条对照,两不许

  • 前言照 12 §2.11,一字不改:"逐条对照,不许新加标准,也不许悄悄放宽。"

    "'不许新加'是防你验收时突然加戏,'不许放宽'是防你验收时突然心软——两个方向都是毁约。"

  • 照抄结构写三行起(验收标准直接抄委托单 §3 的成功标准),给一个含"未达标"的示范(12 §2.11 原例):
# 验收标准(抄自委托单 §3) 实测值 结论 证据
1 分类准确率 ≥90% 91% ✅ 达标 D5 评估报告
2 重复工单占比 60% → ≤42% 44% ⚠ 未达标 <工单系统周报>
3 首响时长 ≤2 min 1.8 min ✅ 达标 监控平台月报
  • 讲清楚"未达标 ≠ 失败"(现场改这一行):

    "验收清单不是成绩单,是账本。 44% 没到 42%——写清楚:未达标项处置('已列入退场后 30 天观察项,每周复盘')+ 谁签字认这个账。客户要的是诚实,不是全绿。"

  • 签字人一栏只写角色(如:客户运营负责人 / 我方交付负责人)——红线 3。

④ 56–62 min|退场计划:给'结束'定个日子

  • 三阶支持表照 12 §2.12 原样("没有退场计划的交付 = 无限售后"):
阶段 时间 支持方式
密集支持 0–30 天 工作日在线 + 周会 · P0 1h / P1 4h
过渡支持 31–60 天 每周一次固定同步 · P0 4h / P1 1 个工作日
收尾支持 61–90 天 仅重大故障 P0 · 支持 1 个工作日
  • 终止条件(今天最容易被写虚的一格)——可判定的样例(12 §2.12):

    连续 30 天无 P0/P1 事件,且客户累计独立处理 ≥3 次事件 反例(写屏幕):"长期支持" / "直到客户满意为止"——"这两句都不是条件,是没有条件。"

  • 知识资产归属(12 §2.12 四行,照抄):

    **客户数据**:<不带走任何真实数据;仅保留脱敏统计结果,需客户书面同意> "这条是红线 3 的延伸:你带走的是方法,不是数据。"(11 §6)

⑤ 62–64 min|技能卡:五要素,边界必填

  • 五要素(12 §2.13):场景 → 问题 → 做法 → 证据 → 适用边界。"最后一条最重要——不写边界的技能卡是坑人。"
  • 工具路径(确认无误后发布):
    fde-scope skill add --title "<标题>" --category methodology \
      --body-file card.md \
      --phase <真实slug> --gate <真实slug>     # slug 见 §3.4 / §3.2,填错检索不到
    fde-scope skill publish <skill-id>
    

    "卡写今天真实踩过的坑——不是从网上抄的通用方法论。你的证据就是 S4 演练被问住的那几刀。"

⑥ 64–67 min|换包两问(把清单念给邻座)

  • 两问(写屏幕):
    1. "如果我是客户,我会在哪一条上犹豫签字?"(找出清单里最虚的一行)
    2. "这一条的证据文件,我 30 秒内能打开吗?"(证据可及性)
  • 邻座扮客户,只问不评;作者只记不辩(规则同 D6 盲测)。

⑦ 67–70 min|自查 + 命名

  • 自查 G7 四条(逐条念),按命名规范改名(D7-姓名-…),准备进 S4。

投屏·板书

  • 左侧:四件套清单(12 §2.10)——全程不切屏
  • 右侧三行红字: ① 验收清单:不许新加,不许放宽 ② 终止条件:可判定的数字与天数 ③ 技能卡:适用边界必填
  • 底部一行:合格线:客户不打电话,能活几天?
┌────────────────────────────────────────────────────────────┐
│ 四件套:Runbook · 评估报告 · SLO 卡 · 培训材料(题纲即可)  │
├────────────────────────────────────────────────────────────┤
│ 验收清单:逐条对照委托单 §3 |不许新加标准 |不许悄悄放宽   │
│ 退场计划:0–30 / 31–60 / 61–90 + 终止条件(可判定)         │
│ 技能卡:场景→问题→做法→证据→适用边界(⚠ 必填)             │
├────────────────────────────────────────────────────────────┤
│ 合格线:客户不打电话,能活几天?                            │
└────────────────────────────────────────────────────────────┘

互动设计

  • ② 之后抽一份"培训材料写成一页目录"的当场对比:"这是产品说明,不是培训材料——客户要的是'我会用了',不是'你有哪些页'。"
  • ④ 环节全场一起找反例:"谁见过'长期支持'?在哪份合同里?"——把真实世界的坏例子挂出来。
  • ⑤ 环节提醒 ID 坑(呼应 S2 幕 5):"发布前 show 一次,确认你拿到的是完整 ID。"
  • ⑥ 环节计时 3 分钟,铃响即换角色——演练的稀缺感就是理由。

学员动作(现场)

  • 四样产出 v1:交接包(四件齐)/ 验收清单(含签字人角色)/ 技能卡(已 publish)/ 退场计划(含终止条件)
  • 换包两问后,写下 ≥2 条修复项
  • 把"客户不打电话能活几天"的答案写进笔记(一句话,可判定)
  • 自查 G7 四条逐条打钩

常见错误与纠偏

错误 纠偏
培训材料写成了手册目录 "这是产品说明。 培训材料回答的是'客户运维怎么学会'——场次、时长、对象、每场练什么"
验收清单偷偷放宽(44% 写成"基本达成") "'基本达成'不是结论,是躲。 写 ⚠ 未达标 + 处置 + 签字——账本要真"
终止条件写"长期支持 / 满意为止" "这不是条件,是没有条件。 改成可判定的:连续 N 天无 P0/P1 + 独立处理 ≥N 次"
技能卡"适用边界"空着就想发布 "§2.13:'不写边界的技能卡是坑人'——G7 ③ 直接扣。补三条:适用 / 不适用 / 前提"
技能卡写成流水账("我做了什么什么") "卡是给别人用的,不是日记。 五要素里'做法'要能照做,'证据'要有数字,'边界'要堵住误用"
签字人写了真人姓名 "红线 3——只写角色(客户运营负责人 / 我方交付负责人)。真人信息当场替换"
评估报告交哪份拿不准 "D5 定稿——评审过、结论没被推翻的那份。草稿不进交接包"
学员问"没有客户怎么练 --accept" "S4 演练就是你的客户。演练通过 = 有资格勾 --accept;真实项目里,签字永远在勾选之前"

承接语(最后 30 秒)

"四样东西都在桌上了。但你说了不算,工具也不算—— 接下来 10 分钟,会有一个人坐在客户的位置上,逐条问你。 签字之前,先被问一遍。"

学员笔记要点

  • 四件套(默写):Runbook / 评估报告 / SLO 卡 / 培训材料(题纲)
  • 验收清单两不许:不许新加标准 / 不许悄悄放宽
  • 终止条件的好样子:连续 30 天无 P0/P1 且独立处理 ≥3 次(可判定)
  • 技能卡五要素 + 边界必填;发布姿势:add → show 确认 ID → publish
  • 我写的"客户能活几天"答案:____________

S4 · 复盘(70–80 min · 10 min)

本节定位:助教扮演"客户运维负责人",把四样产出当庭过审。今天这台戏的唯一 KPI:每一个虚的格子,都被问出来、当场记下来。

一句话目标(开场念):"接下来谁被抽到,谁就把清单念出来——被问住的,收的是修复项,不是尴尬。"

分钟级时间盒

分钟 动作 目的
70–74 助教扮客户,示范一轮:抽一份验收清单 + 退场计划,按 07 §3.6 四刀连问 让全班看到"客户长什么样"
74–78 换包演练(两两/小组,每人至少被问 1 次) 全员过火
78–80 收口:签名交换 + 暗号 + 金句 把"问答"变成"仪式"

讲稿要点

① 70–74 min|助教示范:先把"客户"演出来

  • 助教按 07 §4.3 角色卡出场(原文念):

    "我是这家公司的运维负责人。这套系统上了以后,就我一个人管。你们交的东西我今天签字,明天你们就撤场——我先说清楚:我不怕你们走,我怕你们走了以后我搞不定。"

  • 按 07 §3.6 剧本,四刀连问(不笑、不寒暄):
# 客户运维负责人问 他在测什么 合格回答的骨架
1 "你们 Runbook 上写'回滚 5 分钟'——上次真出事你们修了 40 分钟。这个数怎么来的?" 数字是不是拍脑袋 引用盲测/演练的实测记录;没有就承认 + 承诺补测一次
2 "SLO 写 99.5%——下个月真掉到 99%,你们赔吗?" 承诺与商业条款的边界 说清 SLO 是内部治理工具(拿它决定'先修稳定还是先上新功能'),不是赔偿承诺;合同条款另谈
3 "你文档里写的'漂移''bad case'——我们的人看不懂,谁给翻译?" 培训材料的对象感 培训材料按角色分层;题纲里已排了"出事了看哪里"那场
4 "'模型哪天悄悄变差了谁先发现'——靠你,还是靠系统?" 退场后谁在看监控 告警路由 + 漂移阈值进监控;客户值班角色是第一接警人
  • 每砍一刀,白板记一个字:虚数字 / 过度承诺 / 术语墙 / 无人值夜。
  • 念来源(07 §3.6):"观察点:学员能否用文档里已有的证据抵挡,而不是靠口头找补。"

② 74–78 min|换包演练

  • 规则(写屏幕):
    1. 被抽到的人念清单,不许替自己解释"我意思是……";
    2. 问方只问四刀里的问题(不许自由发挥问技术细节);
    3. 被问住 = 记修复项,禁止狡辩(现在不是辩护时间,是找漏时间);
    4. 每人至少被问 1 次,组内轮转。
  • 讲师/助教走动听,重点盯四种人:验收清单没有签字人的(G7 ② 直接不过)、终止条件写"长期支持"的(G7 ④ 直接不过)、技能卡边界空着的(G7 ③ 直接不过)、退场计划里全是"我们随时在线"的(= 无限售后)。
  • 暗号规则(告诉被演练者,别告诉问方):当你能主动说出——"我们安排一次联席演练,演练通过你再签。"——问方(客户)同意签字。

    "这是07 §3.6 埋在剧本里的暗号:主动提出验证机制,比任何保证都值钱。"

③ 78–80 min|收口:签名 + 暗号 + 金句

  • 抽一组念:"你被问住最狠的一刀是什么?你改成什么了?"——只念改法,不念检讨。
  • 全场齐念暗号一次:"我们安排一次联席演练,演练通过你再签。"
  • 收口金句(05 §7):"交接是你留在现场的最后一次签名。"

投屏·板书

  • 左侧:四刀模板(原文四行,07 §3.6)——全程不切屏
  • 右侧三行红字: ① 念的人不解释 ② 只问四刀 ③ 被问住 = 记修复项
  • 底部一行:暗号:我们安排一次联席演练,演练通过你再签。
┌────────────────────────────────────────────────────────────┐
│ ① 回滚 5 分钟 → 这个数怎么来的?        (虚数字)        │
│ ② SLO 99.5% → 真掉了你们赔吗?          (过度承诺)      │
│ ③ drift / bad case → 谁翻译?           (术语墙)        │
│ ④ 悄悄变差 → 靠你还是靠系统?           (无人值夜)      │
├────────────────────────────────────────────────────────────┤
│ 念的人不解释 | 只问四刀 | 被问住 = 记修复项              │
│ 暗号:我们安排一次联席演练,演练通过你再签。               │
└────────────────────────────────────────────────────────────┘

互动设计

  • 示范轮让全班当裁判:每砍一刀先问全班"这一刀砍在哪层?"——练的是"客户视角"的眼睛。
  • 换包演练用手机计时 3 分钟/组:时间压力本身就是撤场倒计时的模拟器。
  • 收口时签名仪式:演练通过者在验收清单"签字人"栏写下自己的角色名(如"客户运营负责人(演练)")——仪式感 = 记忆锚点。

学员动作(现场)

  • 被演练者:当众念清单、记修复项(≥2 条)
  • 全员:完成一轮被问(至少 1 次)
  • 把最狠的一刀写进笔记:"我的清单里最虚的一行是:____________"
  • 演练通过者:在验收清单签字栏写上角色名 + "(演练)"

常见错误与纠偏

错误 纠偏
被问住后开始找补"我们这个其实……" 打断:"客户不关心'其实'。 记下来,改成能念的原文——这就是修复项"
问方心软,放过了虚的格子 "心软 = 放行一个坑。 今天放过它,撤场那天没人放过你"
学员问"演练算真签字吗" "算训练不算合同。 真实项目里,书面接受永远是'客户签了字'——演练是让你配得上那个签字"
有人把四刀当攻击,情绪上来 讲师接住:"这四刀全是客户夜里真会想的。 今天被问倒,是明天不被骂"
时间不够,有人没轮到 不加时;没轮到的在 S6 补练(互相问四刀),助教盯

承接语(最后 30 秒)

"被问住几刀,你才知道'给客户用'是句什么话。 接下来 10 分钟,收口:G7 四条、提交物命名、明天的预告—— 明天,你要把这 7 件产出,换成你的职业资产。"

学员笔记要点

  • 四刀:虚数字 / 过度承诺 / 术语墙 / 无人值夜
  • 我当场记的修复项:____________________________________
  • 暗号默写:我们安排一次联席演练,演练通过你再签。
  • 金句:交接是你留在现场的最后一次签名。

S5 · 布置 G7 + 明日预告(80–90 min · 10 min)

本节定位:收口 + 交底。念清 G7 四条、命名规范、截止与补交;埋 D8 三个钩子。

一句话目标(开场念):"今天收的是你撤场之后,客户能不能活:四件套、一份清单、一张卡、一个时间盒。"

分钟级时间盒

分钟 动作 目的
80–84 念 G7 四条(①② blocker / ③④ warning)+ 命名 + 截止 判据不可含糊
84–87 退场计划 + 技能卡的不通过形态投屏逐条讲 ③④ 是 warning 但明天要查
87–90 D8 三个钩子 制造明天的注意力缺口

讲稿要点

① 80–84 min|G7 四条 + 命名 + 截止

  • G7 原文(03 §3,逐字念):

    ① 交接包四件套齐全(Runbook/评估报告/SLO/培训材料) ② 验收清单含签字人 ③ 技能卡含"适用边界" ④ 退场计划有终止条件 —— ①② blocker;③④ warning。

  • 点名各自的不通过形态(学员最需要听的):
    • ① 不过:四件套缺一(最常见:培训材料只写"已培训"没题纲;评估报告交了自己都不信的草稿)
    • ② 不过:验收清单没有签字人 / 签字人写的是自己 / 只有"验收人"没有验收标准
    • ③ 扣分:技能卡没有"适用边界"段;边界写"所有场景"(= 没写)
    • ④ 扣分:退场计划没有终止条件;终止条件写"长期支持""满意为止"
  • 命名 + 提交物清单(四个文件,一次说清):
提交物 文件名 对应 G7
交接包(四件套 + 核对清单) D7-姓名-交接包 ①
验收清单(谁验收/标准/签字人) D7-姓名-验收清单 ②
技能卡(已发布,含适用边界) D7-姓名-技能卡 ③
退场计划(30/60/90 + 终止条件) D7-姓名-退场计划 ④
  • 截止与补交(06 §5 原文):直播次日 21:30 前提交;24 小时内补交 = 正常放行(标注"补交通过");超 24 小时 = 延期通过(作品集等级最高 B);豁免进证书备注。

② 84–87 min|两个"最容易被写虚"的格子

  • 终止条件投屏正反例(逐行讲):
写法 判定 为什么
"连续 30 天无 P0/P1 事件,且客户累计独立处理 ≥3 次事件" ✅ 可判定 天数 + 次数,两个数都能数
"客户能独立运维了" ❌ 不可判定 谁判?哪天算"能"?
"长期支持" / "满意为止" ❌ 不是条件 等于承诺永久售后(§2.12:没有退场计划的交付 = 无限售后)
  • 适用边界投屏正反例(逐行讲):
写法 判定 为什么
"适用:有明确操作步骤的运维文档;不适用:策略类、沟通类;前提:第三方执行盲测" ✅ 三条齐 下一个人知道什么时候别用
"适用于各种场景" ❌ 等于没写 坑下一个人
(空着) ❌ G7 ③ 不过 §2.13:不写边界的技能卡是坑人

"这两格为什么是 warning 不是 blocker?因为工具查不了——但明天作品集要查(12 §2.14 索引第 7 行:'退场计划含 30/60/90 天阶梯与终止条件')。今天偷的懒,明天答辩时你自己听得见回声。"

③ 87–90 min|D8 三个钩子

  • 案例 E 明源体检钩子(07 §2.5):

    "有没有想过一种结局:体检做完了,结论是'这个项目不该上'?明源那个案子里,FDE 就在交付到一半的时候建议客户止损——'止损也是专业动作'。明天你会看到,止损的 FDE 后来怎么样了。"

  • D8 预告,念 05 §4 D7 第 5 条(原话):

    "明天带齐 7 件产出——空手的,作品集直接判 C。"

  • 埋 D8 三个钩子(写屏幕):
    1. 7 件产出,你手里有几件?(今晚清点一次)
    2. 三套包装,先装哪套?(求职版 / 内部汇报版 / 接单版)
    3. "FDE 和传统实施工程师的区别是什么?"——明天这道题,是模拟面试的第一题
  • 收口念 05 §4 D7 第 1 条(原话):

    "交接不是走过场,是你专业度的最后一道签名。"

  • 收尾用沉默:念完"明天你要把这 7 件产出,换成你的职业资产"——停 3 秒再下课。

投屏·板书

  • 左:G7 四条(①② 标红 blocker,③④ 标黄 warning)+ 四个提交物名
  • 右:两个"最容易写虚"的格子正反例(终止条件 / 适用边界)
  • 底部:D8 三个问题(7 件清点 / 三套包装先装哪套 / FDE 与实施工程师的区别)
┌────────────────────────────────┬──────────────────────────────┐
│ G7(03 §3)                    │ 两个最容易写虚的格子          │
│ ① 四件套齐全      🔴 blocker   │ 终止条件:天数 + 次数(可数) │
│ ② 验收清单含签字人 🔴 blocker  │ 适用边界:适用/不适用/前提    │
│ ③ 技能卡·适用边界 🟡 warning   │                              │
│ ④ 退场计划·终止条件 🟡 warning │ 反例:长期支持 / 满意为止     │
├────────────────────────────────┴──────────────────────────────┤
│ 四个文件:交接包 · 验收清单 · 技能卡(已发布) · 退场计划      │
│ 截止:直播次日 21:30 | 24h 内补交=正常放行 | 超 24h=封顶 B    │
├───────────────────────────────────────────────────────────────┤
│ D8:7 件清点 | 三套包装先装哪套 | FDE 和传统实施工程师的区别?│
└───────────────────────────────────────────────────────────────┘

互动设计

  • 念完 G7 后问一句:"今天谁的退场计划里还有'长期支持'这四个字?举手。"(不点名,只记数字——S6 助教会重点盯这部分人)
  • 投屏正反例时先让全班判:"这句算不算可判定?"——判据意识比结论重要。
  • D8 预告用沉默收尾:问完"明天带齐 7 件——你手里有几件?"——停 3 秒再下课

学员动作(现场)

  • 记下四个提交物的准确文件名与截止时间(次日 21:30)
  • 当场写一行:我清单里最虚的一行:____________
  • 在日历上标 D8 日期 + "带齐 7 件产出"
  • 群里回一句:"四件齐。" 或 "还差 ____。"(诚实报缺口)

常见错误与纠偏

错误 纠偏
学员问"技能卡能不能不发布" 不劝——只念 G7 ③:"含'适用边界'是过门条件;发布是让它进团队库——不发布的卡是私房菜,不是资产"
有人说"我们没有真实客户,签字演练算吗" "演练算训练。 交付物里把签字人写成角色 + '(演练)'——答辩时说明这是课程演练。格式真、话术真、只有客户是虚构的"
有人想拿 D6 的文档直接充数当交接包 "四件套里三件来自 D6/D5——但'培训材料题纲'和'核对清单'是今天新写的;直接搬文档 = ① 的常见坑"
助教替学员写技能卡 不许。助教只能问:"你这张卡,什么情况下不适用?说给我听"
有人问"超 24h 补交就废了?" "封顶 B 不是废——但证书备注和作品集等级会写。能今天交,别拖到明天"

承接语(最后 30 秒)

"今天你们第一次为'自己退场'写东西。交得出去,才带得走。 下课。四十五分钟自练,助教在群里。"

学员笔记要点

  • G7 四条(①② blocker / ③④ warning)+ 各自的不通过形态
  • 四个提交物文件名 + 截止 + 补交规则
  • 终止条件:"天数 + 次数";反例:"长期支持 / 满意为止"
  • 适用边界三条:适用 / 不适用 / 前提
  • 我最虚的一行:____________
  • D8 三问(抄一遍):
    1. 7 件产出我手里有几件?
    2. 三套包装先装哪套?
    3. FDE 和传统实施工程师的区别是什么?

S6 · 自练(+45 min)

本节定位:独立完成、自查、提交。目标只有一个:四样都过 G7 ①②(blocker),③④ 两个 warning 不留虚格。

一句话目标:把"交完了"变成"客户不打电话,能活。"

45 分钟怎么分(投屏建议)

分钟 干什么 产物
0–12 装配交接包:四件套齐 + 核对清单 + 培训材料题纲写实 D7-姓名-交接包
12–22 验收清单:逐条对照委托单 §3;补签字人(角色);写未达标处置 D7-姓名-验收清单
22–30 退场计划:三阶支持表 + 可判定的终止条件 + 知识资产归属 D7-姓名-退场计划
30–34 技能卡:五要素 + skill add + show 确认 + publish D7-姓名-技能卡(已发布)
34–40 找人做一轮四刀问答(或互相演练),记录被问住的点 修复清单
40–43 自评 G7 四条 + 逐条打钩 + 改文件名 ——
43–45 提交 + 群里发 60 秒收获 提交

三条路径(学员按自己情况选一条)

路径 谁选 做什么
A 完成 大多数人 四样产出齐活 + 提交(别加戏,先交出去)
B 迁移 手里有已脱敏且经公司同意的运维信息 把退场计划的 30/60/90 阶梯、验收清单的标准,换成你项目里的真实节奏;文档里只写角色与指标,不写客户名、IP、域名、账号(11 §6.1)
C 加练 想再挖一层 ① 把你的技能卡导出成 agentscope 格式(skill export <id> --format agentscope),看它在别的工具里长什么样;② 给退场计划的每一阶写一条"反悔信号"——什么现象出现说明要延长支持?(练"用现象定义状态")

路径 C 的第一步特别值钱:你会亲手看到你今天写的卡,怎么变成别人工具链里的资产。

完成标准(提交前逐条打钩)

☐ 交接包四件齐:Runbook / 评估报告(D5 定稿)/ SLO 卡 / 培训材料题纲
☐ 交接包附核对清单(每件一行:文件名 + 一句价值)
☐ 验收清单逐条对照委托单 §3;无新增标准、无放宽措辞
☐ 验收清单含【谁验收 / 验收标准 / 签字人(角色)】;未达标项有处置
☐ 退场计划三阶:0–30 / 31–60 / 61–90(方式 + P0/P1 时限)
☐ 终止条件可判定(天数 + 次数,能数出来)
☐ 知识资产归属写明:不带走真实数据;保留项需客户书面同意
☐ 技能卡含五要素,**适用边界三条(适用 / 不适用 / 前提)**
☐ 技能卡已 publish(不是只创建草稿)
☐ 全部联系人 / 签字人写角色,无真实姓名 / 手机号 / 邮箱
☐ 命名:D7-姓名-交接包 / -验收清单 / -技能卡 / -退场计划

卡点急救

卡在哪 怎么救
培训材料题纲不知道写几场 抄 S3 的四场骨架(是什么 / 怎么用 / 出事了看哪里 / 常见问题 10 问),把场次换成你的系统
验收清单找不到"委托单 §3" 翻 D2 定稿的委托单——成功标准那一节;照抄进来,一个字都不许改
终止条件写不出 问自己:"我凭什么敢走?"——答"他们独立处理过 3 次了"→ 这就是条件
技能卡发不出去 skill add 先创建草稿 → show 确认拿到完整 ID(别从 list 表格抄)→ publish;--phase 必须是真实 slug(§3.4)
skill list --phase 搜不到我的卡 slug 打错。 对照 §3.4 的阶段表重填;打错 slug 的卡能被创建但搜不到
演练找不到人 助教现场配对;或自己隔 10 分钟再念一遍清单,念到虚的地方停下标记
想跑 gate check 自查 只有在 .fde_scope/ 里有档案时才有效;今天的四样是 Markdown 交付物 + 一张已发布技能卡,门禁在 06 D7 任务卡里自查
交接包四件里有件的路径打不开 换绝对路径或可访问的仓库路径重写核对清单——证据可及性也是验收项

助教值守规则

  • 只回答两类问题:① 规则类(命名 / 截止 / G7 判据 / 模板格式)② "这条终止条件算不算可判定"
  • 不回答:D8 之后的方案类问题;"我能不能不发技能卡"这类豁免请求(③④ 是 warning 但明天要查,不建议省)
  • 每 15 分钟在群里发一次进度提示("还有 30 / 15 / 5 分钟")
  • 收到提交后只回一个字:✓(讲评在次日 08:30 门禁榜 + D8 回炉)
  • 提交里出现真实客户名 / PII / 真实账号 → 立即私聊要求撤回重交,并记录合规日志(11 §6.7)
  • 学员问"我这算通过吗" → 只回一句:"四件套齐吗?签字人是角色吗?边界写了吗?终止条件可数吗? 四条都是'是',就是过。"

学员动作

  • 45 分钟独立完成(路径 A / B / C 三选一)
  • 自评 G7 四条 + 完成标准逐条打钩
  • 提交 → 收到 ✓
  • 在群里写 60 秒收获(照 07 §5 模板): 「对方最难的那个问题是什么?我用了什么回应?下次我会改什么?」

常见错误与纠偏

错误(助教视角) 纠偏(助教用)
交接包=把 D5/D6 文档打个压缩包 递回 12 §2.10:「四件套缺一不算交接」——核对清单 + 培训材料题纲是今天新写的
验收清单写成"全部达标" 挑最可能没达标的行问一句:"这条的实测值从哪来?"——出处不明的当场补证据或改 ⚠
终止条件还是"长期支持" "换个说法,用一个数。 连续多少天、独立处理几次?"
技能卡边界写"所有场景" "'所有场景' = 没写。 哪类文档测不出来?哪类没有第三方就做不了?"
交了草稿技能卡(没 publish) "publish 才算进团队库。 差最后一步,别停"
21:30 前赶不上 别慌:24 小时内补交 = 正常放行(标注"补交通过")——但要在群里报一句"我补交",别静默(06 §5)
提交里带了真实客户名 / 账号 撤回重交 + 合规日志,不做例外(11 §6.1 / §6.7)

附 A · D7 板书总图(一天下来的白板应该长这样)

┌────────────────────────────────────────────────────────────────────┐
│  D7 · 交接与沉淀 —— 交得出去,带得走                                │
├────────────────────────────────┬───────────────────────────────────┤
│  六幕(S2)                     │  G7 交接门(03 §3)                │
│  ① 走到最后:next: —            │  ① 四件套齐全        🔴 blocker   │
│  ② 不带参数=完整状态声明        │  ② 验收清单含签字人  🔴 blocker   │
│  ③ ❌ BLOCKED:缺口可见可修     │  ③ 技能卡·适用边界   🟡 warning   │
│  ④ ✅ PASS:只查件数+签字       │  ④ 退场计划·终止条件 🟡 warning   │
│  ⑤ add→抓ID→show→publish       │  工具:只数件数 + 签字            │
│  ⑥ 草稿 7 张 = 飞轮开始转       │  ③④ 靠人守,明天作品集要查        │
├────────────────────────────────┴───────────────────────────────────┤
│  实测数字(讲师速查):                                              │
│  seed:10 engagements | 29 skills(24 published / 5 drafts)        │
│  幕1 status:next: — | complete=True | 3 门禁 ✅                   │
│  幕3:❌ BLOCKED(exit 1)→ 缺 ['eval_report','training_material']   │
│       + 🚫 客户尚未书面接受移交——不得退场 + 💡 自动草稿              │
│  幕4:✅ PASS(exit 0)——只查 3 件事:路径 / 字符串 / 布尔           │
│  幕5:skill-… 每次不同 | list 表格截断 ID(必须从 add 输出抓)      │
│  幕6:--search 1 | --phase 2 | Draft queue 7(三类来源)           │
│  备①:--phase ops_handof → 无匹配技能(打错 slug 不报错)           │
├────────────────────────────────────────────────────────────────────┤
│  三条红线:[1] 只 3 个新概念(交接包 · 知识转移 · 退场)             │
│           [2] 四件套缺一不算交接 + 验收清单含签字人(blocker)        │
│           [3] 边界 + 终止条件必写(warning,今天不写明天查)          │
│  「工具管'有没有',人管'能不能用'。」                                │
│  「客户不打电话,能活几天?」|「交接是你留在现场的最后一次签名。」   │
│  停车位:________________(SLA / OLA / 知识库工程 / 影响力报告…)    │
└────────────────────────────────────────────────────────────────────┘

附 B · 讲师自查(下课前 5 分钟)

  • ☐ 三条红线全守住了?有没有冒出第 4 个概念却没进停车位(SLA / OLA / 知识库工程最容易漏)?
  • ☐ S1 的沉默 10 秒真做了吗?群接龙「我手里那件'只有我会'的事」接了吗?三条示例(参数 / 规矩 / 电话)念了吗?
  • ☐ 幕 1 指出 next: — 和 complete=True 了吗?#8 Infinite Pilots 点名了吗?时间盒三数(14 / 90 / 120 天)写了吗?
  • ☐ 幕 2 的"每次调用 = 一次完整状态声明"讲透了吗?三行 — / ❌ 都念了吗?
  • ☐ 幕 3 两条 🚫 原文念了吗?「客户尚未书面接受移交——不得退场」全班齐念了吗?
  • ☐ 幕 4 的泼水讲了吗("只查了路径 / 字符串 / 布尔")?分界线「工具管有没有,人管能不能用」写板书了吗?
  • ☐ 幕 5 的 ID 截断坑现场演示了吗(list 表截断 vs 从 add 输出抓 $SID)?适用边界那段原文念了吗?
  • ☐ 幕 5 的 slug 陷阱(备用幕)时间够的话演了吗?publish 真跑了吗?
  • ☐ 幕 6 三类草稿来源(manual / auto_capture / gate_hint)指认了吗?「飞轮」说清了吗?
  • ☐ S3 巡场三趟到位了吗(≈42 客户能不能活 → ≈56 终止条件 → ≈62 边界+真人)?
  • ☐ S4 的四刀真砍了吗?扮演客户的助教守住"不笑、不寒暄"了吗?暗号埋了吗(联席演练)?
  • ☐ 被问住的学员被接住了吗("记修复项,不检讨")?签字仪式做了吗?
  • ☐ G7 四条、四个文件名、截止(次日 21:30)、补交规则都念全了吗?
  • ☐ D8 三个钩子埋了吗(7 件清点 / 三套包装 / FDE 与实施工程师的区别)?05 §4 D7 第 5 条原话念了吗?
  • ☐ 命令都从仓库根执行的吗(FDE_SCOPE_HOME=/tmp/fde-d7-demo,seeder 只在演示目录里 seed)?
  • ☐ 未提交名单记下来了吗(次日 08:30 前私聊)?

下一节:23-D8逐节教案.md(变现日:把 7 件产出换成职业资产) 本日配套:02 Day 7(时间盒总表)· 06 D7 任务卡 · 07 §2.5 / §3.6 / §4.3 / §5 · 11 §6(数据合规与 PII 红线)· 12 §1.6 / §2.10 / §2.11 / §2.12 / §2.13 / §3.4

23 · D8 逐节教案:变现日(把 7 件产出换成职业资产)

23

course-level-1/23-D8逐节教案.md

①本文件是 D8 全天直播(结营日)的逐节执行稿:讲师按节念、助教按节做。本日为装配日与检验日——不跑新命令、不改数据、只讲和评。 ②上游时间盒:02 Day 8(M1 作品集装配 60 min · M2 结营答辩 60 min · M3 模拟面试 45 min · M4 结营仪式 30 min)|带教要点:05 §4(D8 五条) ③模板与纪律:10 §1(变现三层)· §2(三套包装)· §3(简历骨架 + 三条纪律)· §4(STAR)· §5(一页纸汇报)· §6(服务清单 + 合规六件套)· §7(面试 20 题)· §8(薪资查证纪律)· §9(结营包与内推池规则)· §10(变现反模式);速用骨架:12 §2.14(索引页)/ §2.15(D8 四件套) ④评分与公信力:03 §3 G8 行 · §5(结营答辩与评分表)· §6(A/B/C 级与证书)|15 §1(证书边界)· §2(第三方认证)· §4(结果度量待补) ⑤学员侧任务卡:06 D8 + §11(结营前终极自检)|运营配合:08 §9.1 / §9.2(结营日清单 / 校友群与复训)|纵深出口:14 §1–§2 ⑥数据红线:11 §6——全部产出基于虚构演示场景(茶饮连锁客服"茶语万象"),数据与客户名均为虚构;PII 不上传、不进群、不进任何第三方工具;72h 课后动作对真人讲解时同样遵守。 ⑦⚠ 本日纪律(全天不许破):不改数据(答辩只认 D5 冻结口径,改数据 = 伪造证据)|不排名对比(掉队者私聊,不公开处刑)|不承诺就业与收入(不换算就业率/涨薪,口径见 15 §3.4)


0. 今天的三条红线(全天不许破)

# 红线 一句话纪律
1 证据 > 描述 每个结论都必须指到"证据在哪";"我做了 X"不算数,"数据显示 X"才算(05 §4 D8 第 1 条)
2 不编不换算 没跑过的数字不写、抄示例数字即造假;不把课程产出换算成"就业率 / 涨薪 / 收入"(10 §3 三条纪律)
3 虚构标注不许删 一切基于虚构演示场景(茶饮连锁客服);"演示/虚构案例"标注删一个字都不行——被拆穿才丢分,标注不丢分(10 §10)

三条红线对应 10 §3 三条纪律与 §10 变现反模式表;答辩"证据意识"与"应变"两项直接照此判分(03 §5)。 诚实边界(全天口径,S4 再念一遍):本课"变现"指把能力变成可展示、可对客交付的产出,不承诺就业或收入(README 诚实边界)。

今日 5 节课总览

与 D2–D7 的"90 min 直播 + 45 min 自练"不同,D8 是结营日:按 02 Day 8 的自身时间盒执行(含一次 10 min 中场休息;>40 人时答辩按 04 §6 预案分组并行)。

节 时间 一句话目标 学员产出 记忆锚点
S0 · 开场(清点与定调) 09:00–09:15 清点 7 件产出、认领三条红线、听懂"变现三层" 自查清单逐项打钩 空手的,作品集直接判 C
S1 · M1 作品集装配 09:15–10:15 把 7 件产出装成三套包装(产出 8) 索引页 + 简历段落 + 一页纸 + 服务清单 我做了 → 数据显示
—— 中场休息(10 min)—— 10:15–10:25 喝水、上厕所、把 5 分钟答辩稿最后过一遍 — 答辩掐表练过 2 遍
S2 · M2 结营答辩 10:25–11:25 每人 10 min:做了什么 → 证据是什么 → 如果重来会改什么 答辩完成 + 评分表归档 超时打断,这就是交付纪律
S3 · M3 模拟面试 11:25–12:10 每人 ≥3 题实战,暴露最虚的三个深水区 面试自测答卷(≥10 题) ⭐ 四题优先抽
S4 · M4 结营仪式与课后动作 12:10–12:40 表彰、点名每一位完成者、交代 D+7 回访与 72h 课后动作 证书与等级确认 + 课后动作认领 72h 内讲给一个真人听

今日产出物(🎯 产出 8):作品集三套包装(全部共用同一条证据链)—— ① 索引页(第一屏):8 件产出的名称 / 日期 / 证据链接 / 一句话价值(12 §2.14) ② 求职版:简历段落(3–5 行,含数字)+ STAR 故事 ×3(成功 / 失败 / 取舍)(10 §3–§4) ③ 内部汇报版:一页纸(价值 / 证据 / 下一步要什么)+ 附 D5 一页验证记录(10 §5) ④ 接单版:服务清单(六项 + "不适用"信号)+ 案例页(走完整链路含证据)(10 §6) 另:结营答辩(10 min/人,评分见 03 §5)+ 面试自测答卷(20 题中至少自测 10 题、写下答案要点)。 G8 结业门(03 §3):① G1–G7 至少 6 关通过(blocker)② 作品集索引完整(8 件)(blocker)③ 完成结营答辩(blocker)④ 作品集等级判定完成(blocker)。A/B/C 级判定见 03 §6。


S0 · 开场:清点与定调(09:00–09:15 · 15 min)

本节定位

全天唯一的"收心"节:把 7 件产出摆上桌、把红线立在墙上、把"变现三层"讲清。今天不学新工具、不跑新命令——今天是装配日与检验日,学员从"做的人"切换成"讲的人"。

一句话目标(开场念)

"今天是变现日:把 8 天做的 7 件产出,一次性装成三套能拿得出手的包装——讲清价值、指到证据、说出下一步。"

分钟级时间盒

分钟 动作 目的
0–3 点名 + 逐人确认:7 件产出 + 证据文件夹在不在手边 物理上杜绝"空手参会"
3–6 念三条红线(§0 表格),逐条举一个反例 立判分标尺
6–10 讲"变现三层"(10 §1 表格):对客户 / 对雇主 / 对个人 定调:三层都指向"能力"不指向"收入"
10–13 念今日 5 节总览,交代答辩纪律(10 min、超时打断)+ 休息安排 给全天节奏感
13–15 答疑 1–2 个高频问题(见下) 消解焦虑

讲稿要点(加粗句可直接照读)

  • ① 变现三层的顺序不能反:第一层对客户变现——交付本身产生业务价值,载体是你的一页纸汇报 + 评估证据 + SLO 卡,买单的是客户预算;第二层对雇主变现——你所在组织内部能看见的东西,载体是一页纸汇报 + 作品集索引;第三层对个人变现——市场给的定价,载体是求职版 + 接单版包装。
  • ② 三层都指向"能力",不指向"收入":我们不承诺就业,不承诺收入,不做任何换算。你的作品集展示的是"完成了哪些产出、通过了哪些门禁"——证书边界见 15 §1,别把它说成职业资格。
  • ③ "空手的判 C"不是吓唬:G8 结业门的第①②条是 blocker(03 §3 G8 行)——G1–G7 至少 6 关通过 + 作品集索引完整(8 件)。缺件按 C 级走完课证明通道,免费重读下一期,这不是惩罚,是给你一条真路。
  • ④ 今天最贵的动作是"讲":昨天(D7)你交的是文档;今天考官看的是你脱稿能不能讲清关键决策。讲师手册 FAQ 原文:"答辩我会请你脱稿讲 3 分钟,讲不清的判定为未达——这是课程唯一的'防伪'。"

投屏·板书

  • 投屏:三条红线表格(§0)+ 变现三层表(10 §1)+ 今日 5 节时间轴。
  • 板书左侧:我做了 X 划掉 → 改成 数据显示 X(证据:<路径>)——写一整天不擦。

互动设计

  • 举手普查:"索引页已经填好的举手?答辩稿掐表练过 2 遍的举手?"——两个问题精准找出今天需要重点盯的人。
  • 高频答疑预备(不主动讲,被问才答):①"我缺 1 件怎么办?"→ 走 C 级完课证通道,缺件如实写进证书备注栏,不要用假的补;②"答辩能不能读稿?"→ 5 分钟陈述可以带手卡,但必须能指到证据,追问环节无稿。

学员动作(现场)

  • 把 7 件产出 + 证据文件夹在本机/云盘摆好,索引页打开待填(12 §2.14 模板)。
  • 对照 06 §11 结营前终极自检 7 项逐条打钩,未打钩的写在便利贴上贴屏幕边。

常见错误与纠偏

错误 纠偏
只带了产出、没带"证据在哪"的路径 现场补:每件产出在索引页填上证据链接,指不出出处的产出等于没做
把今天当"再来一次的机会"想回去改数据 数据冻结在 D5 评估报告;今天改数据 = 伪造证据,直接退回重做(03 §7)
焦虑"讲不好"想临阵放弃答辩 空手才判 C;讲了不完美只丢个别分项——上场永远优于弃权

承接语(最后 30 秒)

"7 件产出在手;接下来 60 分钟,我们只干一件事——把它们装成三套包装。记住今天第一句钉子:我做了 → 数据显示。"

学员笔记要点

  • 三条红线;变现三层(客户/雇主/个人);G8 四条 blocker;"空手判 C、缺件走完课证"。

S1 · M1 作品集装配(09:15–10:15 · 60 min)

本节定位

产出 8 的主战场。三套包装围绕同一条证据链:索引页是第一屏,求职版打"经历"、内部汇报版打"决策"、接单版打"服务"。模板与纪律以 10 §2–§4 为准(与 12 §2.14–§2.15 速用版重复时,以 10 为准)。

一句话目标(开场念)

"60 分钟,三套包装各产出一版初稿:一页索引、一段简历、一页汇报、一张服务清单——全部指向同一批证据。"

分钟级时间盒

分钟 动作 目的
0–5 讲装配顺序:索引页 → 求职版 → 内部汇报版 → 接单版(15/15/15/15 切块) 先立"第一屏"
5–20 块① 索引页:套 12 §2.14 表格,8 行全填(名称/日期/证据链接/一句话价值) 一切包装的源头
20–35 块② 求职版:简历段落 3–5 行 + STAR ×3(成功/失败/取舍) 打"经历"
35–50 块③ 内部汇报版:一页纸(价值/证据/下一步要什么)+ 附 D5 验证记录 打"决策"
50–60 块④ 接单版:服务清单(10 §6 六行表)+ 案例页走一遍完整链路 打"服务",先报"不适用"
全程 巡场重点:抓"我做了"句改写、抓数字出处、抓虚构标注 高频纠偏

讲稿要点

  • ① 索引页是第一屏:面试官/老板只看一页的时候,看到的是这张表,不是你的过程。8 件产出每件一行:产出 / 日期 / 证据链接 / 一句话价值(含数字)。样板行(12 §2.14):32,400 条原始记录 → 识别 8,900 条 PII 候选与 3 类覆盖盲区,结论"有条件能做"。
  • ② 把"我做了"改成"数据显示"——现场投屏四行对照(10 §3):
    • 我做了语料清洗 → 32,400 → 21,800(去重 6,100、质量门淘汰 4,500)
    • 我写了 Runbook → 覆盖 5 类事件含回滚,同事盲测通过
    • 我做了评估 → 主指标 91%(基线 78%),bad case Top3 附根因与动作
    • 我做了干系人管理 → 含 2 位发起人,防住 Sponsor Collapse
  • ③ 简历段落用骨架,不自由发挥(10 §3):在 <场景> 中,为 <客户类型> 完成 <端到端交付>:从 <N 条脏数据> 锻造出 <M 条可用语料>,<指标> 从 <X> 提升到 <Y>,并以 <Runbook/SLO> 支撑 <上线/交接>;交付 <件数> 件可验证产出。 三条纪律:每个数字能在作品集里指到出处;没跑过的不写;"演示/虚构案例"标注不许删。
  • ④ STAR 三个故事,素材现成(10 §4):一个成功(D4/D5 素材)、一个失败(被打回/翻车,句式:"我当时假设了 <X>,证据显示 <Y>,代价是 <Z>,现在的我会先 <做法>。"——不许甩锅环境/客户)、一个取舍(拒绝需求/砍彩蛋/选择回滚)。
  • ⑤ 接单版的纪律:先报"不适用"再报"适用"——敢劝退的乙方才有议价权。红线:不得使用真实客户名、真实数据;不得把课程内部资料作为交付物转售。接单前合规六件套过一遍(10 §6.1:合同/发票税/IP/责任上限=合同金额/数据条款 PII 不上传不进第三方/验收与退出)。
  • ⑥ 两处最容易被"包装过度"踩雷:虚构案例说成真实项目(标注"演示案例"不丢分,被拆穿才丢分);数字无出处(示例里的 32,400→21,800 是抄不得的——抄数字=造假)。

投屏·板书

  • 投屏:索引页模板(12 §2.14)→ 简历骨架 → 一页纸汇报模板(10 §5)→ 服务清单六行表(10 §6)。
  • 板书(延续 S0 左侧):四行"我做了 → 数据显示"对照全部写上。

互动设计

  • 每块结束前 3 分钟随机抽 1 人念自己填的那块,全班挑刺(只挑两类:数字有没有出处、是不是"我做了"句式)。
  • 巡场话术示例:走到学员旁问"你最想砍掉哪件产出?为什么?"——能被自己砍掉的都是弱产出,答辩也会被问到。

学员动作(现场)

  • 完成产出 8 四件套初稿:索引页 / 简历段落 + STAR×3 / 一页纸汇报 / 服务清单 + 案例页。
  • 给自己的答辩 5 分钟稿掐表练第 1 遍(不计入下一节时间)。

常见错误与纠偏

错误 纠偏
简历段落里数字是抄示例的(32,400/91%) 当场替换成自己档案的真实数字;抄数字=造假,答辩一问就穿帮
索引页有产出行但证据链接写"见群文件" 必须指到具体路径/链接,指不到的现场补
接单版把自己写"什么都能做" 先写"不适用"栏;服务清单六项里挑真做过的,其余标注"待练习"
一页纸汇报写成项目流水账 回到汇报公式:做了什么 / 证据 / 下一步要什么(一个要决策的问题)

承接语(最后 30 秒)

"装配暂停——10 分钟休息。回来之后不再动包装:答辩拿的是你真实的产出和真实的口径。5 分钟陈述稿最后过一遍,掐表的第 2 遍留在脑子里跑。"

学员笔记要点

  • 索引页 8 行四要素;"我做了 → 数据显示"四组对照;简历骨架三纪律;STAR 失败句式;接单"先报不适用"。

S2 · M2 结营答辩(10:25–11:25 · 60 min)

本节定位

全天最重要的检验节。评分规则以 03 §5 为准:每人 10 分钟 = 陈述 5 min + 追问 4 min + 打分 1 min;评委 = 讲师 + 助教 + 1 名学员代表。控时严格,超时打断——这就是交付现场的纪律(05 §4 第 3 条)。

一句话目标(开场念)

"每人 10 分钟:我为一个虚构客户做了什么(2 min)→ 证据是什么(2 min)→ 如果重来会改什么(1 min)。超时我会打断,就像客户会打断你。"

分钟级时间盒

60 min ÷ 编排:按实际人数动态排。参考:4 人全流程答辩(按 12 min/人含走台)或 分组并行——04 §6 预案:>40 人时助教带组答辩,讲师只进"优秀组"复核;单模块超时 10 min 助教举牌,超时即砍彩蛋保核心产出。

分钟 动作 目的
0–3 宣读规则:5+4+1 结构、评分表 5 项 0–5 分、超时打断规则、评委构成 规则前置,不搞突然袭击
3–57 逐人答辩(考位轮转;计时员举牌:4:00 黄牌、5:00 红牌) 每人完整跑一遍 5+4+1
57–60 公布当日答辩分数归档,提醒"等级判定综合 8 件产出,晚间/次日随通过榜公布" 收束悬念,不现场排名对比

讲稿要点

  • ① 陈述的 2+2+1 结构:①我为虚构客户做了什么(2 min,客户视角:讲客户得到什么,不讲你用什么技术)→ ②证据是什么(2 min,每个结论指到证据路径)→ ③如果重来会改什么(1 min,指向自己的决策而非外部借口)。
  • ② 追问环节从 10 §7 的 20 题随机抽 ≥3 题:答得太顺时加 1 题深水区(00 §5 的 8 条追问,如 Echo/Delta、80/95/99);评委出题优先问学员最虚的:没有外网 / 客户数据差 / 多租户防泄露(05 §4 第 2 条)。
  • ③ "应变"项判分提醒(照 03 §5 原文):答不上原理题时,正确答案不是编一个数字——而是说"这个数字我记得大概范围,但来源和日期我需要回去核对"。诚实承认 + 知道去哪查,比背错年份得分更高——这与 D5 教的"不演 demo"是同一条原则。
  • ④ 评分表 5 项(0–5 分):结构清晰(5 分钟内讲完不超时不跑题)/ 证据意识(每个结论有证据指向)/ 复盘深度("如果重来"是否具体、是否指向自己的决策而非外部借口)/ 应变(诚实,不知道就说不知道 + 说出会怎么查)/ 客户视角(讲"客户得到什么"而非"我用什么技术")。
  • ⑤ 评委与学员代表:学员代表只参与提问与打分建议,最终评分由讲师 + 助教定稿;一人一号的证书编号与等级见 15 §1(本次不公布编号,走结营后核验通道)。

投屏·板书

  • 投屏:答辩结构 2+2+1 大屏常驻 + 评分表 5 项。
  • 白板边挂计时器(投屏倒计时),黄牌 4:00 / 红牌 5:00 与计时员动作同步。

互动设计

  • 每位学员答辩结束后,留 20 秒请学员代表给一条改进建议(只说一条,防止拖成自由讨论)。
  • 追问池现场抽签(把 20 题印成纸条抽,抽到哪个答哪个,杜绝提前对答案)。

学员动作(现场)

  • 5 分钟陈述(可带手卡,不读稿)。
  • 追问 ≥3 题现场作答;被问住时用"诚实红牌"句式:"这块我还没做过,我会先 <查什么/怎么验证>。"

常见错误与纠偏

错误 纠偏
陈述讲成技术选型报告 拉回客户视角:"这个数字帮客户回答了哪个问题?"
被追问原理题时现场编数字 立即示范 03 §5 的标准答法("记得大概范围,来源和日期回去核对")
"如果重来"讲成"客户数据太差/时间不够" 现场改写:"我当时假设了 X,证据显示 Y,代价是 Z,现在的我会先……"——指向自己的决策
超时继续讲 准时打断 + 一句话点评:"客户不会给你第 6 分钟"

承接语(最后 30 秒)

"答辩全部完成。接下来 45 分钟换一个考场——模拟面试。答辩考的是'讲你自己的项目',面试考的是'接住陌生的问题'。20 题题库里,我们优先抽你最虚的。"

学员笔记要点

  • 2+2+1 结构;评分表 5 项;诚实红牌句式;"如果重来"指向自己决策。

S3 · M3 模拟面试(11:25–12:10 · 45 min)

本节定位

把作品集放进"市场语境"里压力测试。题库 = 10 §7 的 20 题(A 认知与角色 / B 定边界 / C 数据与语料 / D 技术现场与合规 / E 运维与交接),⭐ 为四道高频题(07 §3.7 优先抽);深水区弹药在 00 §5(Echo vs Delta、80/95/99、三道成本门槛、Skill+连接器、双向蒸馏)。每人至少被问 3 题(02 Day 8 M3)。

一句话目标(开场念)

"45 分钟,每人至少 3 题。答不上来不丢人——丢人的是答不上来还硬编。记住你的两张牌:一张是'我的案例里……',一张是'这块我还没做过,我会先……'。"

分钟级时间盒

60 min 答辩后仅剩 45 min,编排按人数动态:推荐"3–4 人一组、助教带组并行",讲师轮转进组听。

分钟 动作 目的
0–3 分组 + 宣读规则:⭐ 四题优先抽、每人 ≥3 题、追问不许背答案 分组开考
3–38 并行面试:带组人抽题 → 学员作答 → 追问 1 层;深水区题按组内进度加 每人 3–5 题实战
38–45 合场讲评:每组报 1 个"全场最佳回答" + 1 个"最需要补的短板" 集体涨经验

讲稿要点

  • ① 20 题地图(10 §7):A 认知与角色(FDE 和传统实施的区别 / 和售前·客户成功·算法工程师的边界 / 18 阶段哪一站最容易出事 / 3 个反模式与预防)→ B 定边界(客户说先做 demo / 只有一个发起人 / 成功标准不一致 / Scope Creep)→ C 数据与语料(数据质量极差 / 补盲合成样本能信吗 / 不给数据 PII / 91% 回答客户的哪个问题)→ D 技术现场与合规(没有外网 / 多租户防泄露 / 技术选型为什么 / 没有标注数据)→ E 运维与交接(指标暴跌前 3 步 / 模型悄悄变差谁先发现 / 客户不接受 SLO / 交接后"再支持三个月")。
  • ② ⭐ 四道高频题先抽:D 组"没有外网怎么办"、D 组"多租户怎么防泄露"、C 组"数据质量极差"、A 组"和传统实施的区别"——这四题不会答,前面 7 天的功力等于没展示出来。
  • ③ 答案的落点永远是自己的案例:面试官问的是通用题,你的答案必须挂靠到"我的案例里……"——比如问"没有外网怎么办",答"我的档案全程跑在本地,LLM 调用失败自动回退规则路径(D4 演练过)"。
  • ④ 深水区题是加分项不是必答题:讲师从 00 §5 挑 1–2 题加难度(Echo vs Delta、80/95/99 三档的含义、为什么不用 LangGraph——互补而非替换)。答不出用诚实红牌,答得出直接进"优秀组"复核名单。
  • ⑤ 每组面试官的追问模板:任何答案追两层——第一层"证据呢?"(指向作品集哪一件);第二层"如果重来你会改什么?"(指向自己的决策)。这两层答稳,20 题里绝大多数都立得住。

投屏·板书

  • 投屏:20 题地图(A–E 五组)+ ⭐ 标记 + 深水区 6 条弹药清单。
  • 板书(换新区域):左"我的案例里……"·右"这块我还没做过,我会先……"——两张牌写大。

互动设计

  • 每组面试官必须抽一道 B 组题(定边界):这是学员最容易在真实面试里翻车的区块。
  • 讲评环节每组只报"最佳回答 1 个 + 最需补短板 1 个",不逐人点评,防止拖堂。

学员动作(现场)

  • 每人 ≥3 题实战作答;记下自己被问住的那一题,当场在 10 §7 题库上圈出来。
  • 对照自测要求:20 题中至少自测 10 题并写下答案要点(06 D8 任务卡);今天没答完的,课后补齐到 10 题。

常见错误与纠偏

错误 纠偏
背模板答案,一追问就露馅 回到"我的案例里……":没有案例支撑的答案不是你的答案
被问"没有外网"直接答"可以联网解决" 与课程场景冲突(客户内网);答本地回退链路 + 数据不出边界
"多租户防泄露"只答"做隔离" 追两层:隔离在哪一层?证据呢?——训练用自己档案里的实际做法作答
答不出就沉默或道歉 用红牌句式:承认 + 说出会怎么查(与答辩"应变"同一条判分逻辑)

承接语(最后 30 秒)

"面试结束。最后一个环节——仪式。但先说清楚:仪式不是结课的句号,是 D+7/D+90 逗号的起点。"

学员笔记要点

  • 20 题五组地图;⭐ 四题;深水区 6 条;"我的案例里……"与诚实红牌两张牌;自测 10 题课后补齐。

S4 · M4 结营仪式与课后动作(12:10–12:40 · 30 min)

本节定位

收束全天 + 交代出口。三件事:表彰(点名每一位完成者)· 出口机制(校友群 / 复训 / 助教)· 课后动作(72h 讲给真人听 + D+7 回访)。运营配合清单见 08 §9.1/§9.2。

一句话目标(开场念)

"30 分钟办三件事:把该点名的名字念完、把出口交给你、把一个 72 小时的小任务装进你口袋。"

分钟级时间盒

分钟 动作 目的
0–12 表彰(02 M4):最佳作品 / 最佳互助 / 最快进步;点名每一位完成者(哪怕 30 秒) 抗住"社会学习"的最后一环
12–18 等级与出口:A/B/C 权益一句话回顾;校友群入口、复训规则(B 旁听 / C 免费重读)、助教通道(A 可申请) 出口机制
18–24 课后动作:72h 内对真人讲一次作品集(同事/朋友都行)+ D+7 变现回访预告 + D+14/45/90 复评点(14 §1–§2) 从"结营"切到"纵深"
24–27 念诚实边界(12 文末 / 10 §9 口径) 最后一遍红线
27–30 合影 + 收结营问卷(NPS + 最有价值一天 + 最想砍掉一天) 运营闭环

讲稿要点

  • ① 点名纪律(05 §4 第 4 条):每一位完成者都要被点名(哪怕 30 秒);掉队者私聊而非公开处刑。发证书按等级宣读:"<姓名>,<A/B/C> 级,编号见结营后核验通道。"
  • ② 等级与权益(03 §6 一句话版):A 级 = 电子证书 + A 级徽章 + 优秀作品展 + 讲师签名表现信(对 8 件产出做事实陈述——不是内推、不承诺录用或面试机会)+ 可申请助教;B 级 = 电子证书 + 复训旁听;C 级 = 完课证明(非证书)+ 免费重读下一期。证书备注栏如实记录补交/延期/豁免项,与门禁"留痕"原则一致。
  • ③ 出口机制(08 §9.2):校友群保留每周一次"作品集诊断"接龙;复训 B 级免费旁听下期、C 级免费重读;复训义务 = 当"摆渡人",每周至少帮 1 位新学员;助教通道 = A 级可申请——这是课程自身的"飞轮"。注意:不是就业服务,内推池规则见 10 §9.2。
  • ④ 课后动作(05 §4 第 5 条 + 10 §10):"72 小时内完成一次对真人的作品集讲解(同事/朋友都行)";配合 10 §9.1 求职包三件套——30 秒电梯版口述稿 + 3 分钟 STAR 版口述稿,对真人讲过一次、收到 ≥1 条具体反馈——用反馈驱动迭代,拒绝"无限等待"反模式。
  • ⑤ 诚实边界(最后一遍,照念):本课"变现"指把能力变成可展示、可对客交付的产出,不承诺就业或收入;不把完成课程换算成就业率/涨薪;结业证书证明"完成了哪些产出、通过了哪些门禁",不等于职业资格证(15 §1)。
  • ⑥ 纵深路线一句话:D+14(复跑差异清单 ≥5 条)→ D+45(C 区补完)→ D+90(纵深包 + 等级复评)——今天不是终点,是 14 §1 13 周路线图的第 1 周发令枪。

投屏·板书

  • 投屏:表彰名单 + 等级权益一句话 + 校友群二维码(投影,不进任何第三方工具)+ D+7/D+14/D+45/D+90 时间轴。
  • 板书:72h · 一个真人 · 讲一次 · 收一条反馈。

互动设计

  • 表彰环节穿插"最佳互助"提名(学员互提,讲师定),强化"摆渡人"文化。
  • 合影前留 1 分钟"一句话留念":每人对着镜头说自己作品集里最硬的一个数字(选做,不强制)。

学员动作(现场)

  • 领取等级确认与证书(电子证书结营后通过通道发放);确认校友群与复训入口。
  • 认领课后动作:当场写下"72h 内我要讲给谁听"的名字。

常见错误与纠偏

错误 纠偏
把仪式开成"成绩排名大会" 只念等级名单与完成者,不做个人排名对比;掉队者私聊
课后动作无人认领 现场逼出具体人名:"讲给谁?什么时候?"——没名字等于不做
学员问"学完能拿多少薪资" 回 10 §8 纪律:只出"区间 + 来源 + 采集日期 + 口径",禁止"学完就能拿 XX K"句式

承接语(最后 30 秒 · 全天收官)

"D8 到此结束。从明天起,你的作品集就是你的名片——证据 > 描述,72 小时讲给一个真人听,D+7 带着反馈回来。我们在校友群的作品集诊断接龙里见第一面。"

学员笔记要点

  • 等级权益一句话版;校友群/复训/摆渡人/助教四出口;72h 课后动作写死名字;D+7/14/45/90 时间轴;"不承诺就业与收入"。

附 A · D8 板书总图(一天下来的白板应该长这样)

┌────────────────────────────────────────────────────────────────────┐
│  D8 · 变现日 —— 把 7 件产出换成职业资产(装配日 · 检验日)           │
├────────────────────────────────┬───────────────────────────────────┤
│  三套包装(S1 · M1)             │  答辩与面试(S2–S3)               │
│  ① 索引页 = 第一屏(8 行)       │  陈述 2+2+1:做了什么→证据→如果重来 │
│  ② 求职版:简历 3–5 行 + STAR×3 │  评分 5 项:结构/证据/复盘/应变/客户 │
│  ③ 内部汇报版:一页纸           │  [4:00 黄牌 · 5:00 红牌] —— 超时打断 │
│  ④ 接单版:六服务 + 先报不适用   │  ⭐ 没外网 / 多租户 / 数据差 / 区别   │
├────────────────────────────────┴───────────────────────────────────┤
│  红线:[1] 证据 > 描述  [2] 不编不换算  [3] 虚构标注不许删            │
│  我做了 X             →  数据显示 X(证据:<路径>)                  │
│  我做了语料清洗        →  32,400 → 21,800(去重 6,100 / 门槛 4,500)  │
│  我写了 Runbook        →  覆盖 5 类事件含回滚,同事盲测通过            │
│  「空手的,作品集直接判 C。」(05 §4 D7 第 5 条)                     │
│  两张牌:我的案例里……  |  这块我还没做过,我会先……                  │
│  出口:校友群 · 复训(B 旁听 / C 免费重读)· 摆渡人 · 助教(A 可申请) │
│  72h · 一个真人 · 讲一次 · 收一条反馈                                 │
│  D+7 回访 → D+14 差异清单 → D+45 C 区 → D+90 纵深包                   │
│  诚实边界:不承诺就业与收入 · 证书 ≠ 职业资格证(15 §1)              │
└────────────────────────────────────────────────────────────────────┘

附 B · 讲师自查

① 开播前 30 分钟(逐条打钩)

  • ☐ 三条红线投屏就绪;变现三层表(10 §1)投屏就绪
  • ☐ 答辩排期表就位:计时员定人、黄红牌、04 §6 超时预案(>40 人分组,助教带组)
  • ☐ 评委构成确认:讲师 + 助教 + 1 名学员代表;追问纸条(10 §7 的 20 题)已打印抽签
  • ☐ 深水区弹药清单(00 §5)在手边,答得顺的人加 1 题
  • ☐ 索引页模板(12 §2.14)与"我做了 → 数据显示"四行对照投屏就绪
  • ☐ 服务清单(10 §6)与合规六件套(§6.1)投屏就绪
  • ☐ 等级权益一句话版(03 §6:A/B/C)+ 证书备注栏"留痕"口径已核对
  • ☐ 表彰三类名单(最佳作品 / 最佳互助 / 最快进步)核实;完成者点名名单一人不漏
  • ☐ 掉队者私聊安排已定(公开场合不排名、不点名批评)
  • ☐ 校友群二维码/入口投屏就绪(不投给任何第三方工具);复训规则与"摆渡人"义务口径已核对
  • ☐ 72h 课后动作话术就绪(现场逼出具体人名);D+7 回访预告话术就绪
  • ☐ 结营问卷(NPS + 最有价值一天 + 最想砍掉一天)已备
  • ☐ 诚实边界口径已核对(不承诺就业与收入;不换算就业率/涨薪;证书 ≠ 职业资格证)
  • ☐ 薪资问题应对:10 §8 引用格式手卡(区间 + 来源 + 采集日期 + 口径)随身
  • ☐ 本日不跑任何新命令;答辩只认 D5 冻结口径(改数据 = 伪造证据)
  • ☐ 控时纪律预演:陈述 5:00 红牌打断话术("客户不会给你第 6 分钟")已排练

② 收营后 5 分钟(对照今天回放)

  • ☐ 答辩是否真按 5+4+1 执行?超时是否真打断(而不是"再给两分钟")?
  • ☐ 是否点名每一位完成者(哪怕 30 秒)?掉队者是否私聊而非公开处刑?
  • ☐ 模拟面试是否每人 ≥3 题、⭐ 四题是否优先抽、深水区是否加了 1–2 题?
  • ☐ 等级与备注栏(补交/延期/豁免)是否逐一核对?3 个工作日核验口径是否讲清?
  • ☐ 72h 课后动作是否每个人写出了具体人名?D+7 回访是否落进运营日历?
  • ☐ 结营问卷是否收回并交给运营(对外只按 15 §3 发布纪律使用)?

上一节:22-D7逐节教案.md(交接与沉淀:交得出去,带得走) 结营之后(纵深出口):14-课后纵深与影子项目.md(D+14 / D+45 / D+90 复评与影子项目准入)· 15-公信力与结果度量.md(证书核验 / 申诉通道 / 第三方认证路径) 本日配套:02 Day 8(时间盒总表)· 06 D8 任务卡 + §11(结营前终极自检)· 10 §2–§10 · 12 §2.14 / §2.15 · 03 §3 G8 · §5 · §6