# FDE六模块工作簿

ticket-lab-v1

虚构客户「青禾设备」：操作员提交故障标题，调度员人工分类并确认派单。负责人林负责批准范围，数据管理员陈负责审批材料，值班员周负责接管。试点只给调度员建议，不自动派单。练习使用合成工单，不访问客户系统或外部模型。

所有人物、模型记录与门槛均为教学假设。规则运行不是模型评估。免费自主学习，无讲师评分或证书；付费培训即将上线、暂不提供。

## foundations: 把“上线助手”拆成责任与证据

1. 先画事件流：提交工单→提出分类建议→调度员确认→维修员接单。把“自动派单”划出范围。
2. 给每次决定标出批准者和执行者。数据可用不等于已获审批，代码通过不等于有人接管。
3. 分别列演示、生产准备和采用证据。采用需要观察真实任务，本地练习只能设计观察方案。

### 完成示范

错误示范：“FDE负责所有事情，测试通过即可上线。”
修正：林批准范围；陈确认合成数据之外的权限；FDE实现并说明限制；周复跑运行与恢复；调度员确认建议。演示证据是本地输出，生产准备还需权限、变更批准和接管，采用证据是目标调度员在约定窗口完成真实任务。

### 独立任务

独立练习：林要求演示后直接自动派单，周尚未收到运行手册。写责任表、拒绝或延后决定及两项能力缺口，解释向谁升级。保存为01-role.md。

- [ ] 每个决定有负责人，范围变化有升级对象。
- [ ] 三类证据分别列出；没有把本地输出当作客户采用。

### 我的产物与决定（请填写）

文件/版本：
依据与决定：
实际命令/输出：
未验证范围：
缺项与修正：
复核方式（自检/同伴）：

### 参考解释

应延后自动派单：它改变了试点范围，且缺少运行接管。向林确认范围变更，向周补交运行材料；不能把林的要求解释为陈的数据授权。能力缺口应写成可练的行为，例如“不能解释失败升级路径”，而不是“技术一般”。

## discovery: 从客户原话形成可暂停的定界包

1. 输入材料：调度员说“重复工单要合并”；林说“先减少错派”；陈说“原始工单禁止发外部模型”；周说“夜班没有专职算法支持”。保留四条原话，分别核对事件、优先级、权限和支持。
2. 访谈问题要能回放一次工作：“上次错派发生后，谁发现、如何改正？”不要问“你想要AI吗？”
3. 盘点四项来源：本练习合成工单、本地规则表、客户历史工单、值班记录。前两项随材料包提供；后两项获取和审批均待确认，禁止假设已有权限。
4. 出口判断写为“仅进入合成数据验证；历史数据试点暂停，待陈确认授权”。明确成功条件是建议可解释且可人工确认，不承诺错派减少比例。

### 完成示范

来源：历史工单｜获取：客户只读导出，待陈审批｜时效：待确认｜限制：不能发外部模型｜决定：暂不使用。
PoC范围：合成标题→规则建议→人工确认；不接生产、不留存原始客户数据、不承诺上线效果。

### 独立任务

独立练习：新增要求“读取值班群聊天，自动识别重复故障”。给三类访谈对象各写一个事件问题；填四行数据表；列一处分歧、PoC范围与进入/暂停条件。保存为02-scope.md。

- [ ] 四来源均写获取、审批、时效、限制；未知没有被补造。
- [ ] 事件问题、分歧理由和暂停条件能指向输入材料。

### 我的产物与决定（请填写）

文件/版本：
依据与决定：
实际命令/输出：
未验证范围：
缺项与修正：
复核方式（自检/同伴）：

### 参考解释

聊天记录含人员信息且审批未知，因此暂停读取；先问调度员如何判断重复，再由林决定优先级、陈确认允许的数据和处理位置。重复合并不是分类建议的同一个里程碑，应另列范围和验收。未知时效填写待确认，不填“实时”。

## implementation: 运行并修复一个可验收节点

1. 下载下方ticket-lab.mjs，在独立练习文件夹安装Node 22或更高版本（已有Node无需重装）。用node --version确认。文件无依赖，不需要npm install、密钥或网络。
2. 运行node ticket-lab.mjs baseline。五条合成用例中，未知故障被错误分类、越权请求被输出；失败退出码为1。读CASE行定位原因，不删除用例。
3. 运行node ticket-lab.mjs candidate，比较修正后的规则：空输入拒绝，含密钥请求拒绝，未知类别转人工。它只是确定性规则示范，不是模型效果。
4. 复制文件为my-ticket-lab.mjs。将baseline中的未知默认值改为review，并在分类前拒绝secret请求；运行node my-ticket-lab.mjs baseline验证。每次只改一个节点并保留失败记录。

### 完成示范

四要素指令示范：实现未知故障转人工；输入未知标题返回review；不自动派单、不访问外网、不输出secret；五用例全部通过且越权失败单列。
蓝图事实：输入只有title，输出category或rejected；约束：纯函数、本地合成数据；M1为输入校验，M2为分类回归，M3为接管材料。

### 独立任务

独立练习：完成上述两处修复，保存03-blueprint.md与终端真实输出。写出六步循环的每一步、修改差异、PASS/NEEDS_FIX判断和未验证范围。工具安装失败时先记录错误，再继续角色与定界，不猜测运行成功。

- [ ] 保留修改前失败和修改后输出，全部五用例执行。
- [ ] 蓝图、四要素指令和六步记录一致；未验证范围明确。

### 我的产物与决定（请填写）

文件/版本：
依据与决定：
实际命令/输出：
未验证范围：
缺项与修正：
复核方式（自检/同伴）：

### 参考解释

修复后五用例应全部PASS，SUMMARY failed=0且退出码0。若只修未知分类，secret用例仍失败，因此不能放行。软件通过不证明大模型可靠、真实客户数据可用或生产接管完成。

## evaluation: 解释高分仍不能放行的原因

1. 先运行材料包baseline与candidate，记录文件版本、命令与输出。五例覆盖供电、机械、未知、空输入和越权请求；secret是独立红线。
2. 再阅读合成模型结果：基线常规8/10、红线0/2失败；候选常规9/10、红线1/2失败。两者数据集与裁判相同，但提示词变化。它们是练习给定记录，不是本站模型实测。
3. 先检查禁止项，再比较常规表现。红线失败必须阻断；提出修正与独立复验，不能仅调平均分。五例是教学种子，不是充分生产评估集。

### 完成示范

候选判断：NEEDS_FIX。常规改善不能抵消1/2红线失败；补充失败输入、提示词版本、上下文与裁判理由，修复后同条件回归并用未参与调试的材料独立验证。规则程序通过与这份合成模型记录是不同证据。

### 独立任务

独立练习：新候选常规10/10、红线仍1/2失败。写04-evaluation.md：逐例预期、禁止项、版本表、放行判断、修正计划与未运行声明；附你实际复跑的规则输出。

- [ ] 红线结果与常规分数分开，决定有逐例依据。
- [ ] 规则实跑、合成记录、未运行模型三种证据清晰区分。

### 我的产物与决定（请填写）

文件/版本：
依据与决定：
实际命令/输出：
未验证范围：
缺项与修正：
复核方式（自检/同伴）：

### 参考解释

仍为NEEDS_FIX。相同红线没有通过，常规满分也不能豁免。若没有模型访问条件，只能声明“完成合成结果分析练习”，不能声明“已完成真实模型评估”；真实模型实训必须另附获授权运行、输出与人工核查。

## handover: 让接手者可以复跑与升级

1. 接管对象是实现模块已修复的本地规则程序，不是评估模块的纸面设计。把文件、版本、运行命令和预期结果交给接手者。
2. 周先执行node my-ticket-lab.mjs baseline，按五例核对。演练故障：把unknown默认值改错，在副本中复跑失败，恢复已保存版本再检查；不操作任何客户环境。
3. 运行负责人与权限批准者分开。红线失败停止使用建议并升级给FDE，范围变更给林，数据请求给陈。设计采用窗口与真实任务口径，尚未观察时留空结果。

### 完成示范

运行：Node 22+，本地合成数据，命令见实现记录。故障：一条红线失败即停止建议并通知FDE；保留错误输出，不发送原始数据。恢复：替换为已保存的通过版本，复跑五例。采用计划：目标调度员、人工确认分类任务、约定窗口、任务完成/中断及原因；本练习没有生产采用结果。

### 独立任务

独立练习：写05-handover.md；让同伴只看手册复跑并记下卡点。没有同伴时自己按空白环境清单演练，标明“自演练，未由独立接手者验证”。记录一次恢复和升级，不伪造采用人数。

- [ ] 运行、恢复、升级每项有命令或具体责任人。
- [ ] 自演练、独立接管与未观察采用分开标注。

### 我的产物与决定（请填写）

文件/版本：
依据与决定：
实际命令/输出：
未验证范围：
缺项与修正：
复核方式（自检/同伴）：

### 参考解释

合格手册能回答“运行哪个版本、预期是什么、失败何时停、找谁、如何恢复、恢复后查什么”。只有安装说明不够。自演练可用于补缺，但独立接管证据必须保留接手者实际记录。

## practice: 合并证据，再做独立迁移

1. 把01至05文件及真实规则输出整理到一个练习文件夹。先逐项查缺，不把文件数量等同能力。
2. 先写四案例的决定，再读案例讲解；区分源码恢复、数据迁移、状态规则与评估红线，禁止套用同一答案。
3. 综合实训从四题选一，并增加一个有明确价值与风险的AI辅助环节。把本练习方法迁移到新场景，逐项提交FDE必交证据。

### 完成示范

“文件齐全所以毕业”不成立。若02缺权限审批、04没有红线决定、05没有接手记录，结论应为待补证据。基础路线完成可证明练习产物已整理，真实模型交付仍需授权模型运行与独立评阅。

### 独立任务

独立练习：写06-review.md，列五个文件各自证据与缺项；写四案例决策；选择实训题并说明AI环节、不得自动决定的动作及进一步需要的评阅。

- [ ] 五文件缺项逐一记录，四案例各有场景相关判断。
- [ ] 实训AI环节、人工边界与需要复核的证据明确。

### 我的产物与决定（请填写）

文件/版本：
依据与决定：
实际命令/输出：
未验证范围：
缺项与修正：
复核方式（自检/同伴）：

### 参考解释

允许“尚未达标”作为诚实结果。实训不能只交CRUD功能，应包含客户事件与权限、评估逐例结果和接管演练。需要独立评阅时先看进阶方式并说明当前缺项；咨询不代表已提供评阅或已报名。

## FDE实训必交证据

- [ ] 客户事件、责任、范围、数据获取与审批表
- [ ] AI环节、确定性替代、人工确认与输入输出契约
- [ ] 实现版本、命令、实际输出与修正轨迹
- [ ] 模型/提示词/上下文/工具/数据集/裁判版本与逐例结果；红线独立阻断
- [ ] 接手者独立复跑、恢复、升级与采用观察计划

基础分析路线可用明确标注的合成记录与自演练；不代表真实模型交付完成。缺模型实跑或独立接管时记录尚未完成。

## 可填写模板（不要复制示范当作自己的证据）

### 责任与阶段证据
| 决定或任务 | 批准者 | 执行/接管者 | 证据 | 未知/升级对象 |
|---|---|---|---|---|
| | | | | |

### 定界与数据盘点
事件流：____ → ____ → ____
问题与价值假设：____
范围内/范围外：____
分歧、决定、理由、影响：____
| 来源 | 获取路径 | 审批者/依据 | 时效 | 限制 | 进入或暂停 |
|---|---|---|---|---|---|
| 合成工单 | 材料包 | 教学材料 | 静态 | 只作练习 | |
| 本地规则 | 材料包 | 教学材料 | v1 | 不是真实模型 | |
| 客户历史工单 | 待确认 | 待确认 | 待确认 | 不发外部模型 | |
| 值班记录 | 待确认 | 待确认 | 待确认 | 含人员信息 | |

### 蓝图与指令
事实、术语与输入输出：____
技术与权限约束：____
里程碑依赖、验收标准：____
四要素：做什么____；需求细节____；技术约束____；验收____
六步记录：拆解____；下发指令____；编码____；验收____；分支判断____；更新图纸____

### 评估逐例与版本
证据类型（规则实跑/合成模型记录/真实授权模型运行）：____
| 用例与来源 | 输入 | 预期 | 禁止项 | 实际输出 | 判定/理由 |
|---|---|---|---|---|---|
| | | | | | |
| 版本变量 | 基线 | 候选 | 是否可比 |
|---|---|---|---|
| 模型 | | | |
| 提示词/参数 | | | |
| 上下文/工具 | | | |
| 数据集/裁判 | | | |
常规表现：____；红线失败：____；放行决定：____；独立复验计划：____

### 接管与复盘
运行版本/环境/命令/预期：____
故障停止条件/升级责任人：____
已保存版本/恢复操作/恢复后复查：____
接手者与独立复跑记录（自演练需标明）：____
采用计划：目标用户____；真实任务____；窗口____；未观察结果留空____
好的决定____；需要修正____；下一轮练习____