Intro course · Level 1
Beginner FDE alchemy: one day to get started, seven days to monetise
The whole four-zone, eighteen-phase delivery chain, compressed into eight days you walk yourself: day 1 installs the worldview and the toolbox; days 2–8 clear one gate a day and hand over one presentable artefact. Suggested effort is about 22 hours (6 h on day 1, then about 2.25 h a day), and nothing on the path needs an API key.
What “monetise” means here: turning capability into presentable, checkable, customer-deliverable output (a portfolio, a script, and one chain you ran yourself) — not a promise of employment or income. Every customer case is fictional demo data.
These lessons are authored in Chinese and are served as authored; this page translates the chapter titles, the rail and the chrome, not the lesson text. Each chapter names its source file under course-level-1/.
Beginner FDE Alchemy · Level 1
READMEcourse-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 methodology, history and principles
00course-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 让"到客户现场边做边学"这件事,第一次变得划算。
三个关键节点:
- 2003 —— Palantir 创立,工程师被派进 CIA / 五角大楼现场 → FDE 诞生
- 2023 —— 大模型能力起来,但企业落地率极低 → 缺口出现
- 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 成为更可行的组织形态
逐句解释:
- 需求异质化 + 效果不确定 —— 每个客户的流程都不一样, 而且没人能保证 AI 在这个场景下一定有效。
- 必须做可运行 Demo 来验证 —— 既然说不清,就只能做出来看。
- 售前必须具备交付能力 —— 如果 Demo 要在签单前做出来, 那么"售前"就不能只会讲 PPT:售前与交付的边界被打穿了。
- AI 降低了原型与定制成本 —— 否则第 3 步在经济上不成立 (先免费干一遍,谁也扛不住)。
- 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%? 三条理由:
- LLM 是概率系统——数学上不存在 100% 保证;
- 从 99% 推到 99.9%,边际成本指数级增长、边际收益递减;
- 高风险场景那 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
三个前提条件(缺一不可):
- 客户是否值得深耕——需求真实 + 业务参与
- 项目能否沉淀资产——流程有共性 + 数据可复制
- 公司有没有机制复用——头部经验能传递到中腰部
三项都不满足就是高端外包,三项都满足才可能成为"行业知识的蒸馏机器"。
两个辅助自检问题(季度问一次):
- 产品边界每个季度是否在向产品侧移动?
- 成熟客户的现场投入是否持续下降?
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.6)对外引用前必须自行复核。
- 不承诺就业与收入;薪资数据只是市场观察,不是预期。
- 本文件提到的第三方产品与公司,仅作行业事实引用,不构成推荐或背书。
- 外部报告的观点(尤其 §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 · Course design brief
01course-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 的内容)
非目标(明确不做什么,防止期待错位):
- 不培养算法/建模专家——本课不训练模型、不调参
- 不培养架构师——不做大规模系统设计
- 不承诺就业与收入——"变现"指的是把能力转化为可展示、可验证、可复用的职业价值(详见
10-变现路径与结营包) - 不做认证考试刷题班——评估全部基于真实产出
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. 课程边界与诚实声明
- 不承诺就业与收入。课程交付的是能力与作品集;就业与涨薪取决于市场、岗位与个人面试表现。
- 案例全部虚构。茶语万象、迅捷出行、南湾汽车等客户名与数据均为演示用途,与任何真实公司无关。
- 薪资/岗位数量等市场数据(如"FDE 岗位同比增长")引用自公开资料,须标注来源与时间,不得当作承诺。
- AI 使用规则:鼓励用 AI 辅助(这就是 FDE 的日常),但每件产出必须: (a)能口头讲清关键决策;(b)标注 AI 参与的部分;(c)证据可复现。
- 不用真实客户数据练习。练习统一使用仓库自带虚构数据或学员自有的、已脱敏的数据。
- 工具名只作举例。课程提到的第三方产品(如 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-by-day syllabus (Day 1 – Day 8)
02course-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 页)
- 干系人地图:执行发起人 + 第二发起人(防 Sponsor Collapse)+ 一线使用者 + IT/安全把关人;标注每个人的"在乎什么"
- 成功标准:≥3 条,全部可度量(含数字与时间);附时间盒:≤14 天集成、≤90 天上线、≤120 天交接(引用自行业 FDE 实践)
- 放弃标准:什么情况下我们应该说"这个不该做"(拒绝商品化用例)
今日反模式警示: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 · Assessment system and gates
03course-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 次 24 小时内的补交机会,补交通过后正常放行。
- 超过 24 小时补交:标记 "延期通过"——计入完课,但作品集等级最高只能到 B。
- 确实无法完成(如数据涉密、岗位冲突):走 "豁免" 流程,由讲师评估后记录在案, 空缺件以书面说明替代——豁免记录会出现在证书备注里,不混同于正常通过。
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 使用规则
- 鼓励用 AI 助手(这本身就是 FDE 的日常工作方式),但:
- 每件产出必须能口头讲清关键决策(答辩会抽查);
- 标注 AI 参与部分(在产出末尾写一句即可);
- 证据必须可复现:AI 生成的数字/结论,必须自己跑过一遍。
- 禁止:代做(他人代交)、伪造证据(P 图、编造报告数字)、用真实客户敏感数据练习。
- 违规处理:首次判定为"退回重做 + 记录";二次则取消证书资格。
- 数据红线:练习统一使用仓库自带虚构数据(
examples/)或学员自有且已脱敏的数据; PII 不上传、不进群、不进任何第三方工具(见11-工具与环境准备第 6 节)。
8. 数据留档与隐私
| 数据 | 用途 | 留存 | 访问 |
|---|---|---|---|
| 门禁通过记录 | 完课判定、期报复盘 | 2 年 | 运营 / 讲师 |
| 作品集 | 结业判定、优秀展(需学员授权) | 学员自持;授权后展示 6 个月 | 学员 / 经授权 |
| 答辩记录 | 证书等级 | 2 年 | 讲师 |
| 自评雷达与问卷 | 课程改进 | 匿名化后长期 | 教研 |
默认规则:作品集属于学员;任何对外展示(优秀作品展、案例宣传)必须单独取得书面授权。
数据合规一票否决:使用真实客户名 / 真实 PII 练习(见 11 第 6 节红线),
一经发现——该件产出作废 + 取消证书资格 + 记录在案,且不适用补交。
这条与 §4.1 的"诚实标注判 0 即退回"是两条独立的一票否决,都不走申诉豁免。
04 · Delivery handbook
04course-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 的四档不是"贵贱之分",而是成本结构不同——
L0 免费档是边际成本为零的公开版(网页 + 仓库,不含直播/点评/证书)、
L1 标准档按人天成本定价、L2 影子项目档 = L1 + 导师 ≤1:3 的监护与脱敏人力(
14§3.8)、 L3 企业内训档按项目制报价(含脱敏、定制案例、内训考核对接的人力,通常单期价最高)。 - 不许拿"变现"当卖点抬价:招生口径受
08§11 与10§8 约束—— 不得承诺就业/收入;提价只能提"服务密度"(助教配比、点评深度、案例定制),不能提"回报承诺"。
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 报价须对采购方逐项拆开(见下) |
读表纪律(三条,缺一不可):
- 这是锚点,不是市场价。
13§4.4 已经说过"'国内 FDE 培训多少钱'目前没有可靠答案"。 上表的唯一用途是让学员/采购方能自己把我们放进坐标里,不是用来说明"我们比谁便宜"。 - 不比总价,比包含什么。 学时不是可比单位(30 学时认证 vs 8 天训练营不是一件事),
题量、模块数同样不是。任何"我们用 X 学时顶他们 Y 学时""他们那个不值这个价"的说法都是违规话术(
08§2.1 禁用句清单)。 - 不换算不承诺。 不做"考完送 XX 认证""学完省下 XX 元"的等价话术;不引用第三方的成功率/涨薪率(
15§3 发布纪律)。
每期招生页必须给出三件事(这是"透明"的可检查定义,缺一项即不合规):
- 本档包含清单:直播天数、助教配比、门禁与证书,逐条列;不包含的也要写(如 L0 不含点评)。
- 本期班型与人数上限:上限由助教配比推出(
08§2.2)——写"最多 30 人",不写"名额有限"。 - 价格的构成口径:至少给"讲师日费率区间 + 助教配比 + 是否含证书制作与复训", 让采购方/学员能拿 §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"变成"自助 + 抽查" | 补课排期 |
四条硬底线(这四条永远不省)
- 配比不动:助教不足时砍招生人数,不砍助教——A 形态开班人数上限 = 助教数 × 20。
- 试讲门槛不动:新讲师 ≥8/10(§7 第 1 条),新助教先当一期影子。
- 门禁标准不动:机器只做初审,通过与否仍由人判定;
03§5 的十条门禁一条不减。 - 数据红线不动:真实客户名 / 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. 质量保障机制
- 试讲:新讲师必须完整试讲 D1 + 任选一天,由教研打分(≥ 8/10 才能带班)。
- 影子跟班:新助教先当一期"影子助教"(只观察 + 记录),再上岗。
- 录播双保险:直播 + 录播,缺课学员 24h 内补看并在群内补交门禁。
- 反馈采集:每日 1 题快评("今天最有用的 1 句话是什么")+ 结营 NPS。
- 迭代闭环:期报中的每个"改进项"必须在下期开营前落实或明确否决——闭环记录在
09。
8. 交付验收(给课程负责人的 checklist)
一期训练营"交付合格"的定义:
- ☐ 完课率 ≥ 70%(完成 G1–G7 中 ≥6 关)
- ☐ 作品集完整率 ≥ 60%(8 件齐全)
- ☐ NPS ≥ 40
- ☐ 期报已产出,且改进项已闭环到下期
- ☐ 零数据合规事故(无真实敏感数据流出)
05 · Facilitator guide
05course-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 定边界
- 收作业时先问:"你的成功标准,客户能自己验收吗?"——验收主体搞错是最高频错误。
- 干系人地图必须逼出"第二发起人",没有就让他写"死亡风险"三个字在图上。
- 现场把一句形容词成功标准("提升效率")改造成可度量版本,示范一次胜过讲十次。
- 提醒:Zones A 的目标不是写方案,是定义 done。
- 预告 D3 时埋钩子:"明天你会看到号称最干净的数据长什么样。"
D3 接数据
- 让学员先猜"这份数据有几成能用",再跑命令对照——制造认知冲突。
- PII 环节用提问推进:"如果这列身份证泄了,谁担责?"
- 强制结论:"待定"不允许,逼学员做判断并写出条件。
- 用仓库里 mock engagement「南湾汽车」的"门禁被真实拦截"案例展示数据问题的后果。
- 提醒不要真拿客户数据:红线再讲一遍(
11第 6 节)。
D4 造语料
- 核心一句:"合成是补盲区,不是凑数量。" 每一条合成样本都要有缺口理由。
- 演示
--llm与规则路径的差异(有 key 时),并演示失败自动回退——让学员看到"没有 key 也能活"。 - 话术环节做角色扮演:助教扮演客户老板,听学员用 ≤200 字白话解释。
- 诚实标注合成比例,当场制造一个"如果客户问合成比例是多少"的追问。
- 预告:"明天的坏消息是,指标一定不好看——这正是它的价值。"
D5 验证与评估
- 先给学员打预防针:第一次评估指标难看是正常的,指标是地图不是成绩单。
- 强调 bad case > 平均分:把"最该先修的 3 个"讲成"烧钱最快修的 3 个"。
- 角色扮演高潮:助教演反对的业务主管,学员必须用数据回应(不能讲情怀)。
- 要求记录"被拒绝的需求"——这是防 Scope Creep 的证据。
- 预告:"明天开始,你要为凌晨 2 点值班的人写文档。"
D6 运维化
- 开场问:"你走了以后,谁修?" 让沉默 10 秒再继续。
- 讲 SLO 时用外卖超时赔付类比(错误预算 = 赔付额度)。
- Runbook 环节做"凌晨 2 点盲测":随机抽一份,让别人按文档念,发现断点当场标注。
- 提"概率性退化":AI 不是坏了才叫坏,慢慢变差也是坏。
- 预告:"明天你要把手里的东西交给一个不爱你的人。"
D7 交接与沉淀
- 核心心态:"交接不是走过场,是你专业度的最后一道签名。"
- 技能卡必须有"适用边界"——强迫学员写出"什么情况下这条经验不适用"。
- 角色扮演:客户运维负责人提三个刁难问题(剧本见
07)。 - 讲"无限 Pilot"是行业最贵的反模式:没有 done,就没有价值结算。
- 预告 D8:"明天带齐 7 件产出——空手的,作品集直接判 C。"
D8 变现日
- 作品集装配时反复强调:证据 > 描述;把"我做了"改成"数据显示"。
- 模拟面试优先问
10的 20 题里学员最虚的:没有外网/客户数据差/多租户防泄露。 - 答辩控时严格(10 min),超时打断——这就是交付现场的纪律。
- 结营仪式必须点名每一位完成者(哪怕 30 秒),掉队者私聊而非公开处刑。
- 最后布置一个"课后动作":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 · Learner handbook and homework pack
06course-level-1/06-学员手册与作业包.md
写给学员:8 天里你只需要盯住这一份文档。 每天一张任务卡:做什么 → 交什么 → 门禁自查 → 卡住找谁。
判分依据见
03-评估体系与通关门禁.md|装环境见11-工具与环境准备.md|全部模板见12-附录-术语表与模板库.md课前读物见00-FDE方法论历史与原理.md(开营前 20–40 分钟,见 §0.5)
0. 先读这 5 句
- 第 1 天全天 6 小时,第 2–8 天每天约 2.25 小时(90 分钟直播 + 45 分钟自练),合计约 22 小时。排不进去就别报——这门课不靠"抽空看看"过关。
- 每天交一件产出,产出里必须有证据(命令、文件、截图)——没有证据 = 没交。
- 门禁制:当天的产出不过关,就暂时进不了下一关;补交可以,但留痕(作品集等级受限)。
- 练习只用虚构数据(课程自带)或你自己已脱敏的数据;永远不上传真实客户 PII。
- 鼓励用 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.csvfde-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 webdemo 录像 ≤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 · Scenario scripts and case library
07course-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 轮(体面提出):把三条写成书面风险清单,给出"如果你能解决①和③,我们下周就能开工"的条件。
- 第 2 轮(对方给不了):对方说"先做个小 demo 给上面看看,预算后面再说"。 —— 这句话同时命中 Infinite Pilot 与 Sponsor Collapse,此时不是砍价时机,是触发放弃标准。
- 第 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 设定):
- "这是我们能给的全部字段了。"(实际含 PII 候选字段,学员必须挑出来说"这个不能收")
- "类别分布很均匀的,放心。"(实际长尾极不均匀,学员要当场用
connect输出反驳) - "时间范围?大概是去年的吧。"(要求学员把"大概"变成确认项写进体检报告)
观察点:是否先看再装(先跑 connect 再下结论);PII 识别是否敢说"不收";结论是否明确。
3.3 D4 · 语料汇报(助教扮演客户老板 → 学员)
学员用 ≤200 字白话汇报语料结果。老板(助教)只追问三句:
- "你说的'能用多少',从头到尾是哪几个数字?"
- "补的那些样本,是你编的吗?"(考诚实标注与合成比例)
- "我一个字没听懂,重讲一遍,说人话。"(考零术语)
观察点:数字链完整(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 的面试防御表一致):
- "FDE 和传统实施工程师的区别?"(考世界观)
- "客户数据质量极差怎么办?"(考接数据的诚实:敢下"能做/不能做/有条件能做"的结论)
- "客户现场没有外网、不想用外部 LLM 怎么办?"(考降级路径认知)
- "多租户数据泄露怎么防?"(考三层隔离:沙箱 / 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 · Operations handbook
08course-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 个问题,报名表内嵌)
- "你目前的工作/学习状态是?"(分人设 A/B/C,见
01§2) - "接下来 8 天,你每天能稳定投入 2 小时吗?"(选"不能"→ 引导自学版
04形态 B) - "你更想要什么:听概念 / 动手交付?"(选前者 → 明确告知本课以动手为主)
分班规则(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 群规(置顶,开营日发布)
- 不发广告、不拉人、不私加好友推销。
- 提问用四要素模板(
06§7);报错先附截图。 - 真实客户名与 PII 一律不进群(红线,见 §11)。
- 作业不抄袭;被发现抄模板不改者,公开提醒一次,二次记录。
- 友善:不嘲笑小白问题——"这是 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. 合规与数据红线(运营视角)
- 宣传口径:不得承诺就业/收入;引用薪资数据必须带来源与日期(见
10)。 - 学员数据:报名信息仅用于课程运营;对外展示作品集需书面授权(
03§8)。 - 练习数据:群内一旦出现真实客户名/PII——立即撤回 + 私聊 + 记录合规日志;
该学员产出退回替换为脱敏数据(
04§6 预案)。 - 录播与资料:仅限本期学员,不公开传播;讲师演示环境不出现真实客户内容。
- 合规日志:每期一份,记录事件/时间/处置/后续动作,随期报归档。
09 · Operations metrics and retrospectives
09course-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% |
漏斗纪律:
- 分关记录,不合并。 "G1–G7 通过"这种合并口径会掩盖"卡在第 4 关"的真实问题。
- 首期基线用实测校准。 上表的建议值来自设计推演,不是行业数据——第一期跑完用实测覆盖它, 不要拿"行业均值"假装权威(与课程"诚实标注"原则一致)。
- 每级都记分母。 任何比率都必须能回答"除以谁"。
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 期开营前 | 已否决 | 学员环境安装成本高,与"零门槛"原则冲突 |
状态只有四种:待办 / 进行中 / 已落实 / 已否决。
两条硬规矩:
- 否决必须写理由——"已否决"要能回答"为什么不做比做了好"。
- 跨期滚动,不允许无声消失——上期"待办"在本期开营日仍无进展的,在期报第 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 · Monetisation paths and graduation kit
10course-level-1/10-变现路径与结营包.md
先说清楚"变现"是什么:本课程说的变现,是指把能力转化为可展示、可验证、可复用的职业价值。 我们不承诺就业、不承诺收入——招生页、课堂、结营现场一致(见
README.md诚实边界)。 变现的三层定义见第 1 节;作品集与面试题库供02Day 8、03答辩、06Day 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 题,
02D8); 答辩评委随机抽取(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 那句"薪资数据必须带来源与日期"的执行细则。
-
本课程不提供薪资数字、不承诺收入。任何一次对外引用(招生页/直播/群/作品集)都必须满足:
-
引用格式(缺一不可):
<区间> | 来源:<发布方名称 + 链接> | 采集日期:<YYYY-MM-DD> | 口径:<岗位名称/城市/经验段/样本量> -
可信来源优先级:企业官方招聘页面(在招 JD 的公开薪资区间)> 招聘平台公开薪酬报告 > 行业报告。 匿名爆料不做唯一来源。
-
必须标注的局限:FDE 在国内是新岗位,公开样本少、口径杂;同一 title 在不同公司差异极大; JD 区间 ≠ 实际 offer。
-
禁止句式:"学完就能拿 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 · Tools and environment setup
11course-level-1/11-工具与环境准备.md
目标:30 分钟内,让一台普通电脑(8GB 内存即可)跑通 D1 冒烟链路。 全程不需要:API key、Docker、GPU、AgentScope、梯子、管理员权限。
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 |
怎么执行一条命令(全文通用,以后不再重复解释):
- 复制文档里的命令(选中 →
⌘C/Ctrl+C); - 切到终端窗口,粘贴——macOS 是
⌘V;Windows 是Ctrl+V,或在窗口里点右键(会自动粘贴); - 按 回车(Enter),等它跑完(命令结束的标志是重新出现一行等你输入的提示符)。
📌 三条纪律(先记住,能省 90% 的慌乱):
- 一次只贴一段——文档里每个代码块代表"一次操作",别把两个代码块一起贴进去。
- 终端里
Ctrl+C不是复制,是"中止当前命令";复制粘贴用上面的方法。- 报错不可怕,先读最后一行——最后一行通常就是原因(比如
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 安装成功的判定
三个信号,缺一不可:
- 提示符有
(.venv); pip install末尾显示Successfully installed;- 运行
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 一致)
- key 只从环境变量读——不要写进任何文件(包括
.env、笔记、YAML)、不截图、不进录屏、不进群。 - 报告、清单、engagement JSON、日志里永远不会有 key(工具本身也不会写)——如果哪天你在文件里看到了 key,那一定是手写进去的,立刻删掉并检查有没有提交到 git。
- 公司环境里用 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 三条红线
- 只用两类数据:课程自带虚构数据,或你自己已脱敏并经公司同意的数据。
- 真实客户名与 PII 不进群、不上传——包括作业、截图、提问里的粘贴内容。
- 不进任何第三方工具——在线标注平台、在线 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 提交前自检五问
- 这份产出里的数据,我能说出"它是虚构的"或"它脱敏过且公司同意"吗?
- 截图里有没有任何能定位真人的信息?
- 群里发的报错原文,有没有粘贴到真实数据?
- 用
--llm之前,样本脱敏了吗?公司允许发这个端点吗? - 本地演示暴露面(
--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 · Appendix: glossary and template library
12course-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 |
📌 复制粘贴三条纪律(终端里最容易吃亏的地方):
- 粘贴前先看:确认你粘的是完整一行,尤其别漏了开头的
fde-scope或结尾的路径。- 别敲回车去"试试看":终端不认"差不多",拼错一个字母就是报错。
- 报错先读最后一行:原因几乎总在最后一行(见 §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 字,零术语。 说给客户业务方听的,不是给技术人看的。 禁用词表:
语料覆盖度合成数据去重准确率(裸用)模型推理向量embeddingtoken
三句骨架:① 能用多少 → ② 补了什么 → ③ 为什么可信
# 客户话术(≤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:
- 表里
id列窄了会截断成eng-adnova-t…——加COLUMNS=200即可(或把终端窗口拉宽)。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 · Go-to-market page and competitor comparison
13course-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 三条卖点(每条都能当场验证)
- 门禁是工程,不是清单。 通关不是"看完了、考过了",而是产出物过机器校验 + 讲师按量表打分。
线上可当场演示:推进阶段时门禁实时复评,条件不满足就
blocked——不是靠自觉。 - 零门槛、零 key。 全链路核心证据不需要 API key、不需要 Docker、不需要 GPU,本机可跑; LLM 只是可选加速(关掉它整条链路照样走通)。对照:多数认证课要求 Python / 云基础先修。
- 交出去的是作品集,不是结业证。 8 件产出里有 Runbook、SLO 卡、值班交接卡、交接包—— 是接手的人真正要读的东西,不是"我学过"的证明。
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 周作业 + 客户脱敏场景 + 内训考核对接 + 对公发票 | 项目制报价;对外说"按人天费率 × 人数 + 定制案例人时" |
对外话术的三条边界:
- L0 的数字可以直接说(¥0),因为它不依赖任何未定变量。
- L1–L3 只说结构,不说数字——成本公式逐期不同,写死会变成承诺(算法见
04§1.1)。 - 不说"起价"。"¥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 课的人真正要判断的是这五件事:
- 投入——能不能排进我的日程(几小时 vs 几个月)
- 动手程度——听讲 / 看视频 / 交作业 / 亲手跑通一条链路
- 产出物——学完手里有什么(笔记?证书?能演示的东西?)
- 评估方式——怎么证明学会了(看完?考试?产出过校验?)
- 背书——发不发第三方证书、雇主认不认
外加一个价格维度,因为它是唯一的硬数字。
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. 优势(诚实版,每条落在一个可核对的事实上)
- 门禁是工程,不是清单。 通关靠产出物过校验,不靠自觉或选择题。可现场演示
engage advance被blocked。03§1.1 - 产出覆盖完整交付链,不是单点技能。 8 件里有 Runbook、SLO 卡、值班交接卡、交接包、合规六件套—— 多数竞品止步于"做出一个 RAG / Agent demo"。
- 零门槛、零 key、不换工具。 不需要 Python,不需要 API key,不要求替换你现有的编码 / 办公 Agent;
课程只叠"流程与门禁层"。
01§6.4、11§4.1 - 平台层开源可审计。 教学依托的
fde-scope代码在仓库里,不是 PPT——学员可以自己读实现。 - 工业场景纵深。 7 个工业门禁(
site_survey/fat_sat/functional_safety/conformity/works_council/air_gap/shift_handover)在上表所有竞品里没有一个覆盖。 - 把诚实当评分维度。 "诚实标注"得 0 分一票否决;用真实客户数据练习一票否决(
03§4、§8)。 竞品普遍不惩罚夸大,我们直接把夸大判死。 - 课程自身可复制。 25 份文档 = 一整套可开办的教案包(讲师手册 / 运营手册 / 指标复盘 / 剧本案例库 / 模板库)。 多数课程是黑盒交付,我们连"怎么开第二期"都给了。
- 与官办项目同频而非对立。 官办解决"认知与布局"(企业负责人),我们解决"手上会不会做"(工程师)—— 可与政府 / 协会 / 企业大学的项目串成一条线(§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 发布纪律)。
逐条展开:
- 深度:8 天 vs 4–6 个月。 我们不教模型训练、微调、多 Agent 深入、连接器底层。
对照:Maven 4 周、NovelVista 80 小时、School of Core AI 6 个月、Krish Naik 5 个月、职坐标 4–5 个月。
适合入门与转型,不适合深造。 结营后的纵深路线见
14§2—— 那是"接下来 90 天自己走",不是"本课改成了 4 个月"。 - 无第三方认证。 我们发的是本课证书 + 作品集评级。对照 ADaSci / GSDC / 工信部教育与考试中心 / 大连理工大学。
雇主认不认,取决于学员能否用作品集自证。不能拿"认证"当卖点。
想叠加第三方认证的三条路径与顺序见
15§2;注意"教你考证"和"发证"是两件事。 - 没有真实客户项目。 全部为虚构案例(
07)——这是"真实数据禁入"规则的代价。 只有企业内训形态 C 才可能用客户自己的脱敏场景;加档形态 D 把这条做成了产品(14§3), 代价是每期最多 3 人、导师 ≤1:3、产出脱敏双签。 - 没有就业服务。 对照职坐标含猎头服务、FDE Academy 有招聘池。我们不承诺就业、不承诺收入(
10§8)。 §9.1 的求职包与 §9.2 的内推池是学员之间的互助,不是我们的业务,也不收费。 - 没有学员结果数据。 目前没有历史班级的完课率 / NPS / 薪资样本;
09里的指标线是设计推导的基线,不是实测。第一期的数据出来之前,这一项只能空着。15§3 定了要收哪五项、§4 是待填的表、§5 是补齐清单——表是空的,这是故意的。 - 价格不透明。
按→ 现在04§1.1 我们只给算法不给数字04§1.2 公开四档的包含项与不包含项,且 L0 = ¥0 永久免费可以写进招生页。 竞品有 US$164.99 / US$0–500 / ¥5,000–29,000 明码标价;L1–L3 仍不公开数字(逐期成本不同,写死即承诺), 所以这条只是部分补齐——在比价场景仍是实打实的劣势。 - 工业纵深未经教学验证。 7 个工业门禁是工具已有能力,但作为课程内容还没在真实班级跑过。
15§4 给它留了一行「工业纵深验证」,空着到有班级为止。 - 交付人力重。 需要试讲 ≥8/10 的讲师 + 1 : 15–20 的助教配比(
04§3、§7), 自助开班门槛不低。§3.1 把助教拆成三级阶梯、列了四条减人手段—— 省的是重复劳动,不是判断,所以门槛降了但没消失。 - 仅中文。 课文为中文母稿;英文页面只译壳与章节名,不译正文(页面已明说"served as authored")。
en/README.md提供英文快速入门(语言策略 / 8 天弧线 / 零 key 命令 / 诚实边界 / L0–L3), 并用一整节列出仍缺什么——包括"课堂产出物本身是中文优先"。快速入门不等于能上课。 - 国内市场也不只我们一家在讲。 国内官办与商业培训已在快速铺开(§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 · Post-course depth and shadow projects
14course-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 客户侧准入四件套(缺一不可)
- 书面同意书:范围、数据范围、签字人、退出机制,四样都写进同一份文件。
- 场景边界说明书:一句话问题定义(客户的问题,不是平台能力)+ 明确不做什么。
- 数据最小化声明:只要必需字段;能匿名就不假名化,能假名化就不带标识。
- 退出/中止条款:任一方可随时中止,并写明中止后的数据处置时限。
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 沙盘 ≠ 现场:这一节自己的诚实标注
沙盘能练到「材料怎么写、门怎么拦、缺什么」,练不到三件事:
- 真实的脏数据——seed 档案是干净的结构化演示值,现场数据不会这么客气。
- 真实的签字压力——SAT 的客户签字、工会的共决,沙盘里是字符串,现场是政治。
- 真实的停机成本——沙盘里
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 天里有明确的靶子:
- 结业等级 B 及以上;
- 独立跑完 ≥2 个档案且门禁全绿(不是"跟着抄");
- D+90 复评通过;
- 工业方向加一条:§5 的 7 份沙盘材料齐全。
⚠ 这四条是门槛设计,不是招生承诺。Level 2 的开课时间、形态与价格都还没定—— 在
13§9 的过期提醒机制里登记了这一项,一旦变动先改那里。
7. 反模式:这六种练法等于没练
- 把 seed 数据当真项目写进简历——虚构档案在简历里叫"编造项目经历",一票否决级别的问题。
- 影子项目写成"主导交付"——
10§8 与 §3.6 的措辞纪律;写"参与并完成 X 输出物"不丢人。 - 打卡式刷量:90 天里建了 20 个档案全卡在
qualification——数量不是纵深,跑完全链路的 2 个胜过 20 个半截。 - 只写材料不打开情境开关——练出来的全是"不适用"(§5.1),等于没练。
- 没有客户书面同意就动数据——这是红线,不是"先做着看";触发即中止(§3.7)。
- 给"待补"的表格填数字——
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 天我改掉了什么习惯(具体到一个动作,不写"提升了认知")
上一章:
13GTM 页面与竞品对比|下一章:15公信力与结果度量 相关:03评估体系与通关门禁 ·04交付实施手册 ·09运营指标与复盘
15 · Credibility and results measurement
15course-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 叠加的实操顺序(建议,不是规定)
- 先结课、先攒作品集。 认证是锦上添花,作品集才是你的证据(
README§3 的八件产出)。 - 再挑一门考试。 复习素材就是你的 8 件产出:它与 CFDE 的 7 个模块有大面积重叠—— 但没有官方对照表,重叠到什么程度以你自己读考纲为准。本课不出"考点对照表"(出了就是代人言)。
- 简历 / 作品集怎么并列写(措辞纪律,与
10§8 同源):
✅ FDE 训练营结业(A 级,8 件产出见作品集索引页)
✅ ADaSci Certified Forward Deployed Engineer (CFDE),2026
❌ 工信部认证 FDE —— 证不是从那个渠道拿的,就是虚假陈述
❌ 学完本课可直接通过 CFDE 考试 —— 我们没考过,这句话没有任何依据
2.3 我们不做的三件事
- 不办"包过班"、不代报名、不收返佣——若未来出现合作,会在本节明示合作范围与是否收费。
- 不声称"上完本课即可通过 XX 考试"。
- 不用第三方的 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 对外发布四条纪律
- n < 20 只做定性,不做百分比。 小样本比率毫无意义(
09§11 对内的线是 8 人; 对外取更严的 20——因为对外引用没有机会解释口径)。 - 永远带分母与样本量: ✅「第 1 期:作品集完整率 63%(19 / 30,实际开课 30 人)」 ❌「作品集完整率 63%」
- 不挑期次。 有 ≥ 2 期数据后,对外必须连续展示(含表现差的那期);只发最好的一期 = 樱桃采摘(
09§10)。 - 差评与掉队同等发布。 每期对外页同时写明"这期没过哪条硬线"——与
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(一票否决) | 待补 | 待补 | 待补 | 待补 |
| 本期未达标的硬线 | —(如实列出哪条没过) | 待补 | 待补 | 待补 | 待补 |
填表规则:
- 只有
09§6 的期报冻结后(结营 48h 内)的数字才能填; - 每格必须能回答"分母是谁、什么时候采的、谁采的";
- 空格写「待补」,不允许用 0、
—、"数据整理中"糊弄; - 对外引用整行引用(含分母、样本量、采集日期)。
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. 本章不改变的事实
- 不承诺就业、不承诺收入(
10§8 逐字有效)——有了数据也不改口。 - 不声称任何第三方互认或等价(§2)。
- 课文仍为中文母稿(
13§6 #9 仍成立);英文侧只有页面壳与仓库里的英文快速入门 (course-level-1/en/README.md,快速入门 ≠ 课文翻译),不译正文。 - 本课证书不是职业资格(§1.1)。
13§6 #2 的"不能拿认证当卖点"仍逐字有效——叠加第三方认证是你个人的资产,不是本课的卖点。
7. 反模式:自毁公信力的六种写法
- 给「待补」填数字。 一个假数字毁掉的是整张表——包括那些真的数字。
- 小样本海报。 把 n = 5 的那期做成宣传图,等于承认其他期不敢发。
- 换算就业率 / 涨薪率。 问卷没问的问题,答案从哪来?
- 拿第三方认证做课程卖点。 那是人家的证;用人家的证给自己贴金,两头都不占理。
- 只发最好的一期。 见 §3.3 第 3 条。
- 把"过期"说成"作废"。 今天混淆这两个概念,明天就会混淆"撤销"和"没通过"。
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运营指标与复盘 ·13GTM 页面与竞品对比
16 · D1 lesson plan: orientation day
16course-level-1/16-D1逐节教案.md
本文件是 D1 六小时直播的逐节执行稿:每节课讲什么、怎么说、屏幕放什么、学员做什么、卡住怎么救、下一节怎么接。 上游时间盒:
02-逐日教学大纲.mdDay 1|通用骨架与控场:05-讲师手册.md§2 / §8 备课底料:00-FDE方法论历史与原理.md(讲师看、学员不看)|学员侧任务卡:06-学员手册与作业包.mdD1 本日演示数据: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 念,不展开
五条要点(投屏,学员在群里回"已签署"):
- 时间:D1 全天 6 小时;D2–D8 每天约 2.25 小时(90 min 直播 + 45 min 自练),整期约 22 小时。
- 每天交一件产出,产出里必须有证据(命令、文件、截图)——没有证据 = 没交。
- 门禁制:当天产出不过关,暂时进不了下一关;补交可以,但留痕。
- 练习只用虚构数据或你自己已脱敏的数据;真实客户名与 PII 一律不进群、不上传。
- 鼓励用 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 三条各讲成一句话故事:
- "我们缺的不是前身,缺的是闭环。" → "国内早有解决方案架构师、交付工程师、AI 售前——差异在于:很少形成'现场经验反哺产品'的闭环。 所以做 FDE,第一步是把闭环补上,不是把岗位名字改掉。"
- "美国是加装大脑,中国是对话驱动。" → "很多客户的流程不写在系统里,写在默契和人情里。 过去的软件要求客户先填表、画流程、配规则; AI 的入口是自然语言——所以在中国,'一边跑、一边修路'反而更容易起步。"
- "经济性约束是真实的。" → "硅谷高价值客户能撑六到七位数美元年合同;国内大量项目在十万到百万人民币量级。 所以中国 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 结束前写完,不是课后):
- FDE 和售前/实施/外包,最大的差别是:______
- 我现在的岗位最像哪个前身?缺的是哪一块?
- 我公司现在是谁在干 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%?(三条理由,念一遍即可)
- LLM 是概率系统——数学上不存在 100% 保证;
- 从 99% 推到 99.9%,边际成本指数级增长、边际收益递减;
- 高风险场景那 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 节排查表;仍不行进"环境急诊室"; 最差情况助教共享屏代跑、学员口头指挥——照样算完成(02D1 降级路径)。
讲师提醒:这 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 分钟):
Schema表:4 个字段、类型、是否可空。PII?那一列全空——但不亮 ≠ 没有 PII。讲师当场追问:"这份数据的
content列里,如果写着'我的手机号是 138xxxx',它算不算 PII?" —— 算。schema 探测只按字段名判(name/email/phone这类列名才亮), 自由文本必须逐条看值。这是 D3 的第一个坑,今天先埋。rows≈20:只有 20 条。"客户说'我们有海量数据',你打开一看是 20 条。这就是真实数据的第一课。"
- 9 个类别:20 条分成 9 类,平均每类 2 条多——极度不均衡且极度稀疏。
✅ 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):
- 清洗后可用量(原始 → 可用)
- PII 脱敏数
- 覆盖盲区(K 个类别,各差多少)
- train / eval / test 切分
话术示范(讲师念,学员记):
"您给的这 20 条,我们一条没浪费,但里面就有 2 处个人信息,我们做了脱敏。 它最大的价值是让我们看清了您业务的 9 个类别长什么样; 但它太小了——所以我们的做法是按这 9 个类别补样本、把每一类补到至少 100 条, 补了多少、哪些是补的,报告里都写着,您可以随时抽查。"
注意这句话里的"零术语"要求:没说"覆盖度""语料""合成"——D4 会专门练这个。
⑤ 故意翻车(33–41 min)——红线 2,必演
脚本(顺序很重要,一定要"演得像"):
- 明明已经跑完
corpus了,假装忽然想起来:"哦对,我好像……还没定成功标准?"
- 对着屏幕停顿两秒,然后问全班:
"我刚才跳过了哪一站?跳过它的代价是什么?"
- 等 10 秒(不要急着替他们答)。期望答案:第 4 站(成功标准契约化); 代价:不知道"客户用什么数字验收",所以永远不能说'做完了'—— 这正是 Infinite Pilots / Demo-Debt 的开场。
- 补一刀(关键):
"更糟的是——我刚才做的东西看起来完全正常。报告生成了、数字很漂亮、 415 条语料、2 处 PII 都脱敏了。跳过成功标准不会报错。 它只会在三个月后,让你删掉两百行代码。"
- 引出 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。 没有这步,本节最重要的红色就看不到(
06D1 任务卡已注明)。
讲稿要点
① 工作台与 engagement 矩阵(6–16 min)
进入 fde-scope web 后,按顺序讲三块(不要一次讲全):
- 工作台(首页):一眼看到"现在手上有什么"。
"你有多个客户同时跑的时候,这张表就是你的记忆——哪家卡在哪一站,一眼可见。"
- engagement 矩阵:把每个客户按 4 区 × 18 阶段排开。
"上午你们画的地铁图,在这里变成了格子。每一个格子,就是一个客户当前站的位置。"
- 每个 engagement 的档案:进去能看到委托单、成功标准、journal(过程流水)。
② gate 面板 + 红色 blocker(16–28 min)——本节高潮
讲述顺序(很重要):
-
先看「茶语万象」(标杆案例)——它的门禁是绿的。
"这是别人家的满分作业:10 个 mock 档案里的标杆。看清楚每一站该长什么样。" (档案版成功标准:≤14d 完成数据接入 · ≤90d AI 订货预测上线覆盖 90% 门店 · MAE 较基线下降 ≥20% · ≤120d 完成运维移交,SLO 99.5%)
-
再看「南湾汽车」(工业案例,门禁被真实拦截)——停在
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。 这正是今天想让你亲眼看到的:工业现场的'上线'不是技术动作,是合规动作。"
-
再看「星澜科技(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 分钟再举手"。
- 达标的标志(投屏,学员自对):
connect输出里能看到 Schema 表和rows≈20corpus输出里能看到20 real + 395 synthetic = 415 totalreports/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 的承诺。
- 常见问题的标准答法(
02D1 常见问题表 +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-逐日教学大纲.mdDay 1(时间盒总表)·06-学员手册与作业包.mdD1 任务卡 ·07-实战剧本与案例库.md(案例 D 星澜科技)
17 · D2 lesson plan: setting the boundary
17course-level-1/17-D2逐节教案.md
本文件是 D2(90 分钟直播 + 45 分钟自练)的逐节执行稿:每节课讲什么、怎么说、屏幕放什么、学员做什么、卡住怎么救、下一节怎么接。 上游时间盒:
02-逐日教学大纲.mdDay 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-学员手册与作业包.mdD2|门禁条款: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
三处要点,逐句讲:
--profile ticket→ 这就是**qualification(值不值得做)**的第一个判断:这条链路用哪套。 "同一件事,工厂和互联网公司的交付链路不一样。选错 profile,后面每一站都白走。"phase: qualification · zone: pre_engagement→ 你现在站在地图的第一站。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 │ 🏢 │
└───────────────────┴───────────────────────────────────────────────────────┴─────────────────┘
必须讲清的三件事(学员最容易在这里踩坑):
- 这 10 个不是本课程的门禁 G0–G8。 它们是工具门禁,管的是 SOP 链路某个阶段能不能推进。
"两套门禁,一个标准,别搞混——
03§1.1 专门写了这件事。" - 🏢 通用的只有 3 个:
success_criteria·slo·handoff_signoff。 "今天我们要过的是第一个。" - ⚠️ 不要演示
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 原文,让规则替讲师说话 |
学员动作(现场)
- 读客户简报(5 分钟,只看简报)
- 独立写 3 条成功标准(4 分钟,不许讨论)
- 组内对齐,找出分歧(2 分钟)
- 补完委托单其余各节(13 分钟)
- 接受助教扮演的客户 CTO 压力测试(2–3 分钟/桌)
- 自评 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 钩子 |
学员动作(现场)
- 对照案例 A 的四条,检查自己是否"每条都指得出来一个人"
- 把三种失败模式抄进笔记
- 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 的落地版):
① 每一条成功标准,客户能自己验收吗? → 不能 → 改
② 干系人图上,有第二发起人吗? → 没有 → 写上"死亡风险"
③ 放弃标准里,有没有一句"什么情况下不做"? → 没有 → 补
| 坑 | 症状 | 处方 |
|---|---|---|
| 成功标准只有工程师能测 | 全是 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-逐日教学大纲.mdDay 2(时间盒总表)·06-学员手册与作业包.mdD2 任务卡 ·07-实战剧本与案例库.md§2.1 / §2.4 / §2.5 / §3.1 / §4.1 ·12-附录-术语表与模板库.md§2.1(委托单模板)
18 · D3 lesson plan: data intake (look before you load)
18course-level-1/18-D3逐节教案.md
本文件是 D3(90 分钟直播 + 45 分钟自练)的逐节执行稿:每节课讲什么、怎么说、屏幕放什么、学员做什么、卡住怎么救、下一节怎么接。 上游时间盒:
02-逐日教学大纲.mdDay 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-学员手册与作业包.mdD3|门禁条款: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 的内容(02Day 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 工具路径)。 列名叫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),因为 南湾汽车是manufacturingprofile。绝对不要在 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 起步(
02Day 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 | "时间范围?大概是去年的吧。" | "大概"= 一个不能进报告的字段 | 把"大概"变成确认项:写进第 ① 节"待客户确认",或明确标注"未确认" | 有没有把模糊信息变成待办,而不是照抄 |
助教扮演纪律(讲师提前给助教看这三条):
- 不许一次放行——学员说"好的我收下"时,追问"你确定?要不要再翻翻?"(给第二次机会,但只给一次)
- 学员反问时照实回答(问"有没有手机号"→"你们自己看"),不许顺着学员说
- 学员点破坑时,当场承认并追问一句"那你写进报告的哪一节?"——把口头判断逼成书面判断
③ 车间主任(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-逐日教学大纲.mdDay 3(时间盒总表)·06-学员手册与作业包.mdD3 任务卡 ·07-实战剧本与案例库.md§2.2 / §2.3 / §3.2 / §4.4 ·11-工具与环境准备.md§6(数据合规与 PII 红线)·12-附录-术语表与模板库.md§2.2(数据体检报告模板)
19 · D4 lesson plan: corpus forging (ore into metal)
19course-level-1/19-D4逐节教案.md
本文件是 D4(90 分钟直播 + 45 分钟自练)的逐节执行稿:每节课讲什么、怎么说、屏幕放什么、学员做什么、卡住怎么救、下一节怎么接。 上游时间盒:
02-逐日教学大纲.mdDay 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-学员手册与作业包.mdD4|门禁条款: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 的姐妹症状:一个是不敢碰真数据,一个是用假数据撑场面。 反制只有一句话:报总数的时候,真实量和合成量必须一起出现。"
四条高频漏项(投屏):
- 只说总量、不说比例
- 数字链缺环(说不清 395 怎么来的)
- 裸用"准确率"(没有分母)
- 覆盖度只有形容词("基本覆盖"——没有数字)
投屏·板书
- 左:抓到的词 + 替换说法(现场写成两列)
- 中:反模式 数据"凑数" → 真实量 + 合成量 + 比例,三个一起报
- 右:四条高频漏项
- 白板角落:停车位
互动设计
| 环节 | 讲师动作 | 目的 |
|---|---|---|
| 举手 | 规定"举手指、不打断" | 让抓词不伤人 |
| 抽组 | 只抽 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-逐日教学大纲.mdDay 4(时间盒总表)·06-学员手册与作业包.mdD4 任务卡 ·07-实战剧本与案例库.md§2.2 / §2.3 / §3.3 / §4.4 ·11-工具与环境准备.md§6(数据合规与 PII 红线)·12-附录-术语表与模板库.md§2.3(客户话术模板与禁用词表)
20 · D5 lesson plan: validation and evaluation (let the evidence speak)
20course-level-1/20-D5逐节教案.md
本文件是 D5(90 分钟直播 + 45 分钟自练)的逐节执行稿:每节课讲什么、怎么说、屏幕放什么、学员做什么、卡住怎么救、下一节怎么接。 上游时间盒:
02-逐日教学大纲.mdDay 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-学员手册与作业包.mdD5|门禁条款: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.pyscore_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 秒。然后给三条结论(学员照着抄):
- 指标好看 ≠ 系统好。 好看可能只是"没测到"。
0.000有两种含义:全错,或者根本没这一列。(幕 5 会看到第三种:真的一个都没有。)- 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
三句话,一句比一句重:
- 平均值掩盖了最该修的那一个。 聚合 OEE 0.7236,看着"还行";
ASSY-HUMANOID-01是 0.5111, 碰撞率 0.0321 是全厂最高的 3~7 倍。如果只看平均分,你永远不会知道要先修它。 → 这就是今天要挖 Top3 bad case 的理由:平均分是用来汇报的,bad case 是用来干活的(05§4 D5 第 2 条)。 PAINT-01的grasp_success_rate 0.0000不是"抓取全失败"——喷涂工位根本没有抓取这一列数据。 → 0.0 有三种含义了:全错(幕 2 的 intent 0.000)、没这一列(这里)、真的一条都没发生。 所以看到 0 不要下结论,先问一句:这个 0 是怎么来的?- 数错了对象,工具不报错。 我们试过把工业样本喂给工单 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 分钟,我不说话——你们跑,我们(助教)扮客户。 记住一件事:今天你只要能说清'我怎么知道的',你就赢了;说得再好听说不清,等于没说。"
学员笔记要点
- 六幕六句(板书原文抄一遍):
- 全绿的表,九行是填充物——唯一真信号是
escalation_rate expected_category填错版本 → 假 0.000(子串匹配;mock 从不报类别名)- 最差的 agent 也能拿满分卷——指标好看 ≠ 系统好
- 可复现 = 不随机,不是"结果好"(同命令同结果)
- 平均分掩盖 bad case(0.7236 藏着 0.5111);0 有三种含义
- 工具里没有证据门——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 的零基础三步走):
- 5 行就够起步——从你自己的 D3/D4 数据里挑 5 条真实感最强的(虚构或脱敏)
- 存成
.jsonl,记事本存文件时把类型改成"所有类型",否则会存成.jsonl.txt(实测报FileNotFoundError,见卡点急救) - 一行一个 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 人轮流念刁难,念的人不许自己编——照着屏幕上的五条念
- 学员的硬规则(写屏幕上):
- 不许讲情怀("我们很有热情""一定会努力")
- 不许裸承诺("95% 我们能做"——除非能给出基线与路径)
- 说"不知道" = 合法,但必须补一句 "我 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 引子(原话):
- (角色扮演收口)"今天你们被反对过一次了。明天开始,你要为凌晨 2 点值班的人写文档。"
- "先想一个问题,明天开场我要问:'你走了以后,谁修?'"
- "还有一个更难受的问题留给你:你今天这套东西,半夜三点坏了——修它的人认识它吗?"
补一句与工具相关的预告(别破梗,只说现象):
"另外,明天我们会碰到一个今天完全没碰的字母组合: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 三问(抄一遍):
- 你走了以后,谁修?
- 半夜三点坏了,谁看?
- 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-逐日教学大纲.mdDay 5(时间盒总表)·06-学员手册与作业包.mdD5 任务卡 ·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 lesson plan: operationalising (make it hold)
21course-level-1/21-D6逐节教案.md
①本文件是 D6(90 分钟直播 + 45 分钟自练)的逐节执行稿:讲师按节念、助教按节做;文中所有命令与输出均为本仓库实测。 ②上游时间盒:
02Day 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|学员侧任务卡:06D6|门禁条款: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|今日地图
- 三个新概念写黑板(今天就这三个,多一个都进停车位):
- SLO 与错误预算——"坏了多久算坏"+"这个月还能坏多久"
- Runbook(事件响应与回滚)——"出事照着做的纸,退路写在里面"
- 漂移与监控——"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 |
- 三个结论,逐条钉死:
- 工具只挡"零"——
noslo被拦,因为它是"什么都没写"; - 工具不挡"糊弄"——
nobudget全无错误预算,照样静默通过。G6 ② 是 blocker,但工具根本不查它; - "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|自查 + 命名
- 练
06D6 任务卡的门禁自查四条 + 命名:
| 提交物 | 文件名 | 对应 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|两两交换再测
- 规则(写屏幕):
- 念的人用嘴,不用手——不许帮作者解释"我懂你的意思";
- 卡住就举手,两秒内举;
- 作者只记不辩——现在不是辩护时间,是找断点时间;
- 测完交换角色,两轮各测一份。
- 讲师/助教走动听,重点盯三种人:写满术语的(抽象层断点多)、联系人写"找我就行"的(= #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 引子(原话):
- "预告:'明天你要把手里的东西交给一个不爱你的人。'"
- (D7 核心心态)"交接不是走过场,是你专业度的最后一道签名。"
- (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 三问(抄一遍):
- 明天你要把手里的东西交给谁?(一个不爱你的人)
- 技能卡的"适用边界"是什么?
- 你留的"最后一次签名"是什么?
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(交接与沉淀:交得出去,带得走) 本日配套:02Day 6(时间盒总表)·06D6 任务卡 ·07§2.3 / §3.5 / §5 ·11§6(数据合规与 PII 红线)·12§1.4 / §1.6 / §2.7 / §2.8 / §2.9 / §3.5
22 · D7 lesson plan: handover and distillation (hand it over, carry it away)
22course-level-1/22-D7逐节教案.md
①本文件是 D7(90 分钟直播 + 45 分钟自练)的逐节执行稿:讲师按节念、助教按节做;文中所有命令与输出均为本仓库实测。 ②上游时间盒:
02Day 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|学员侧任务卡:06D7|门禁条款: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|今日地图
- 三个新概念写黑板(今天就这三个,多一个都进停车位):
- 交接包(四件套)——"我走了你手里有什么":Runbook + 评估报告 + SLO 卡 + 培训材料题纲
- 知识转移(教会 ≠ 讲完)——"你能自己教别人了吗":技能卡 + 培训材料
- 退场(有始有终的时间盒)——"我什么时候走":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: ❌"客户接受:否。你看,一次遗漏的参数,就把'已验收'打回了'未验收'。" -
收口成两句话:
- 每次调用 = 一次完整状态声明,不是"补差异"——生产纪律:只在四件都在手上的时候跑,跑完立刻
gate check(不然你的档案会被一次马虎的调用打回原形); - 退出码是 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 · v1tags=[...] · 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|换包两问(把清单念给邻座)
- 两问(写屏幕):
- "如果我是客户,我会在哪一条上犹豫签字?"(找出清单里最虚的一行)
- "这一条的证据文件,我 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 次,组内轮转。
- 讲师/助教走动听,重点盯四种人:验收清单没有签字人的(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 三个钩子(写屏幕):
- 7 件产出,你手里有几件?(今晚清点一次)
- 三套包装,先装哪套?(求职版 / 内部汇报版 / 接单版)
- "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 三问(抄一遍):
- 7 件产出我手里有几件?
- 三套包装先装哪套?
- 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 件产出换成职业资产) 本日配套:02Day 7(时间盒总表)·06D7 任务卡 ·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 lesson plan: monetisation day (turn 7 artefacts into career assets)
23course-level-1/23-D8逐节教案.md
①本文件是 D8 全天直播(结营日)的逐节执行稿:讲师按节念、助教按节做。本日为装配日与检验日——不跑新命令、不改数据、只讲和评。 ②上游时间盒:
02Day 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(结果度量待补) ⑤学员侧任务卡:06D8 + §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 是结营日:按
02Day 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 题并写下答案要点(
06D8 任务卡);今天没答完的,课后补齐到 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(证书核验 / 申诉通道 / 第三方认证路径) 本日配套:02Day 8(时间盒总表)·06D8 任务卡 + §11(结营前终极自检)·10§2–§10 ·12§2.14 / §2.15 ·03§3 G8 · §5 · §6