FDE 项目全流程操作手册 v0.2
读者:刚入行、不懂 AI 落地的 FDE 同事。目标:从见到客户第一面,到把数字员工建进平台、跑起来、收尾复盘,全程知道自己在哪一段、这一步要做什么、做到什么算过。
本版=完整目录 + 第 3–4 章完稿(阶段 1 组织诊断 / 阶段 2 业务规划)。第 4 章按第 3 章同一模板铺,写法与颗粒度以此为准,其余各段照此推进。
本版怎么读
0 三分钟速览
一条线:客户的一句话 → 客户能用的数字员工
谁说了算、活怎么流
值不值、承诺什么
对象·属性·关系·动作
建进客户平台并验证
出运行数据
下个项目少踩坑
新人第一周只需要记住四句
- 我们卖的不是软件,是「数字员工」——能把某个人某段重复活接过去的 AI 员工,它要知道这个单位的业务长什么样(=本体)。
- 材料不到手,不开工。五类输入缺一类,先出「缺什么、去哪拿、谁给、什么时候给」,不是硬着头皮编。
- 凡是「大概、差不多、行业上一般」的数字,一律不能写进方案。要么有出处,要么标待确认。
- 四个决定只能人做:给业务、拍方案、确认变更集、授权账号。AI 再强也不替你签字。
1 开工前必须搞清的四件事
1.1 FDE 交付的是什么
客户买单的是一段活的结果,不是一个系统上线。所以验收口径永远是「这个季度周报是不是它自动出了、准不准、人还要不要返工」,不是「功能都点得开」。
| 阶段 | 客户眼里的进展 | 你交付的实体 |
|---|---|---|
| 1 组织诊断 | 「他们真看懂了我们的活」 | 诊断三件套(组织建模信息 / 业务流程清单 / 业务场景地图) |
| 2 业务规划 | 「知道要做哪几个数字员工、值不值」 | 业务分析报告 / 编制方案 / 结果契约 |
| 3 本体建模 | 「图纸我看懂了,也认了」 | 建模方案(对象表·属性表·关系表·动作表·字典·权限),机检 0 ERROR |
| 4 平台落地 | 「我平台里真建出来了,能用」 | 客户平台上建好的本体+冒烟证据 |
| 5 运行 | 「员工真在用,指标在动」 | 运行报告+结果数据 |
| 6 沉淀 | 「下个项目能快一点」 | 复盘报告+可复用 SOP/模板 |
1.2 三个角色怎么分工
| 角色 | 管什么 | 不管你的事 |
|---|---|---|
| 👤 你(真人 FDE) | 见客户、要料、定口径、拍方案、签字、推用起来、控进度 | 不用手工画表、不用逐条录平台、不用手写机检报告 |
| 🤖 智兑现 | 资料梳理、需求结构化、出建模方案、跑机检、平台落地执行、出报告草稿 | 不能替你见客户、不能替你拍板、不能替客户答业务问题 |
| 🏢 客户 | 给料、答口径、确认方案、授权账号、安排员工用 | 不懂本体,不要向他要建模术语 |
1.3 两套本体别混
| 本体 | 在哪 | 装什么 | 谁看 |
|---|---|---|---|
| FDE 项目管理本体 | 我们自己的平台 | 客户、项目、阶段、需求、交付物、方案版本、变更集、门禁 | 你和智兑现内部 |
| 客户业务本体 | 客户的平台 | 客户自己的业务对象(岗位、业务单据、客户/学员/候选人…) | 客户和客户侧数字员工 |
1.4 只有人能做的四个决定
| # | 决定 | 什么时候 | 做不了会怎样 |
|---|---|---|---|
| ① | 给业务——讲清这家单位实际怎么干活 | 阶段 1–2 | 对象和动作全靠猜,后面全部返工 |
| ② | 方案拍板——这份本体图纸认不认 | 阶段 3 末 | 建出来客户不认,等于白建 |
| ③ | 变更集确认——这批改动能不能进平台 | 阶段 4.4 | 误删对象、静默丢关系与订阅 |
| ④ | 账号授权——给平台账号/接口权限 | 阶段 4.0 | 进不去客户平台,全流程停摆 |
2 六段全景与「格」
2.1 六段与格
| 段 | 格 | 该段产出 | 能跳吗 |
|---|---|---|---|
| 1 组织诊断 | 1.1 收料 / 1.2 组织与流程 / 1.3 场景地图 | 诊断三件套 | 全不可跳 |
| 2 业务规划 | 2.1 业务分析 / 2.2 场景与编制 / 2.3 结果契约 | 分析报告+编制方案+契约 | 2.1 小项目可省;2.3 不可跳 |
| 3 本体建模 | 3.1 准入判定 / 3.2 出方案 / 3.3 机检到 0 ERROR / 3.4 业务方确认 | 可落库清单 | 全不可跳 |
| 4 平台落地 | 4.1 接入验权 / 4.2 三方比对与变更集 / 4.3 执行与回读 / 4.4 冒烟 | 客户平台上的本体 | 4.4 不可跳 |
| 5 运行 | 5.1 采数据 / 5.2 出运行报告 | 结果数据 | 小项目可合并 |
| 6 沉淀 | 6.1 复盘 / 6.2 SOP 入库与脱敏 | 复盘+SOP | 6.2 可延后 |
2.2 状态卡(每格做完必贴)
作用:① 你自己清楚到哪了;② 交给智兑现,它据此推下一格,不会重复问你;③ 换人接手,贴一张卡就接得上。没有状态卡=这格等于没做。
3 阶段 1 组织诊断 样章 · 已完稿
3.1 这段要解决什么
一句话:搞清楚这家单位靠什么活、谁对什么负责、每一段活怎么流转,并且让客户确认你理解的和他说的一致。
3.2 逐格推进
格 1.1 收料(五类输入准入)
| 四件套 | 内容 |
|---|---|
| 问什么 | 「我们这个项目,先要五样东西:① 你们靠什么赚钱/靠什么完成主责主业 ② 部门、岗位和各自管什么 ③ 从接到事到办完,中间经过谁 ④ 平时用的表单/台账/系统截图 ⑤ 这些数据现在在哪、能不能导出。这五样哪样现在能给,哪样要走流程?」 |
| 产出 | ① 资料清单(每份标:来源人、日期、形式、可信度)② 缺口清单(缺哪类、去谁那要、什么时候给);手上有 4 类以上、缺的第 5 类写明来源与时间=这格可过。 |
| 算过 | 五类输入里 ≥4 类已到手且有出处;缺的每类都写明「谁给、什么时候给」。⛔ 不合格写法:「资料基本齐全」「客户会配合」。 |
| 可否跳 | ⛔ 不可跳。跳了=后面对象边界全错,返工重做整个阶段 3。 |
资料可信度排序(拿不准时按这个排):台账/表单/系统截图 > 访谈记录 > 制度文件 > 行业通识。只有前两类能支撑属性和动作。
数据可得性分四级(决定这事能不能做):
| 级别 | 含义 | 结论 |
|---|---|---|
| L1 | 有接口可直读 | 能做 |
| L2 | 能导出文件 | 能做(半自动) |
| L3 | 只能人工补录 | 慎做,要算人力成本 |
| L4 | 数据根本不存在 | 不能做,当场说清 |
格 1.2 组织与流程
| 四件套 | 内容 |
|---|---|
| 问什么 | 组织:「你们一共几个部门?每个部门几个人、分几个岗?某个活出问题,最后谁负责、谁能拍板?」 流程:「拿最常见的那个事举个例子——从接到到办完,第一步谁做、第二步到谁手上、卡在谁那最久、返工最多的是哪一步?」 |
| 产出 | ① 组织建模信息:部门/岗位/人数/责权/汇报关系/决策人 ② 业务流程清单:3–8 条主流程,每条有起点、终点、涉及岗位、当前最痛的点 |
| 算过 | 每个关键岗位能答出「谁问、谁写、参与哪个判断」;主流程走到「端到端」——起点终点都在,中间不留「这里大概是这样」;决策人姓名与职务已确认(不是「领导」)。 |
| 可否跳 | ⛔ 不可跳。跳了=后面动作只能编,本体一建就假。 |
格 1.3 场景地图(数字员工候选)
| 四件套 | 内容 |
|---|---|
| 问什么 | 「这几条流程里,哪几步最耗人、最容易错、最不想自己干?如果有个新同事专干这一段,你希望他先接哪一段?」 |
| 产出 | 业务场景地图:每条主流程拆成若干场景,每个场景标「谁做/多久一次/一次多久/错在哪/能不能交给数字员工」 |
| 算过 | 至少 3 个场景有频次与耗时数据(来自台账或客户明确口径),且客户当场指认「这几个最痛」;⛔ 不许自己替客户排优先级。 |
| 可否跳 | ⛔ 不可跳。这是阶段 2 编制方案的唯一输入。 |
3.3 你手上要交出什么(诊断三件套)
| 产出 | 内容要求 | 存哪 |
|---|---|---|
| 组织建模信息 | 部门/岗位/人数/责权/汇报线/决策人,每个岗位一句「管什么」 | 项目档案+(已落地项目)平台源材料对象 |
| 业务流程清单 | 3–8 条主流程,端到端,含涉及岗位与当前痛点 | 同上 |
| 业务场景地图 | 场景+频次+耗时+痛点+是否可交给数字员工 | 同上 |
三件套齐全才算这段完。每份都要标:出处(谁给的/哪份台账)、日期、是事实还是推断——推断的写「推断-待确认」,⛔ 不混在事实里。
3.4 智兑现干哪些活(你不用自己干)
- 把访谈记录、台账、截图整理成结构化清单(部门/岗位/流程/术语)
- 标出资料之间的矛盾(口头说 30 人、名册 26 人 → 列出让你去问)
- 按五类输入生成缺口清单,写明缺什么、去谁那要
- 资料可信度分级建议、数据可得性 L1–L4 初判
- 把场景按频次×耗时排成候选表,供你和客户挑
3.5 出关判定(逐条打勾,缺一条不出关)
| ☑ | 判定项 | 判定方式 |
|---|---|---|
| ☐ | 五类输入齐 ≥4 类,缺的写明谁给/何时给 | 数资料清单,逐类对 |
| ☐ | 诊断三件套齐全 | 文件都在,内容非空模板 |
| ☐ | 决策人姓名+职务已确认 | 写得出真人名,不是「领导」 |
| ☐ | 3–8 条主流程端到端,无「大概」段 | 每条能指出起点、终点、涉岗 |
| ☐ | ≥3 个场景有频次与耗时数据 | 数据带出处,不是估计 |
| ☐ | 客户对接人确认三件套无异议 | 书面(邮件/微信/签字)留痕 |
| ☐ | 每个结论标了 事实/推断-待确认 | 抽查 5 条 |
平台侧(项目已进我们平台时):管阶段的对象上 exit_met 填「满足」,不满足的写进 exit_gap,再推下一段。⛔ 不许先推段后补记录。
⛔ 「调研完成,客户很配合」
✅ 「五类输入齐 4 类;缺『数据可得性』——要 IT 王工确认是否能导库,承诺下周三前答复;三件套已发王经理,微信回『没问题』」
3.6 新人常犯的三个错
| 错 | 后果 | 怎么避免 |
|---|---|---|
| 拿制度文件当业务全貌 | 制度写的是「应该怎么做」,不是「实际怎么做」,照它建模=建个没人用的理想世界 | 制度只看规则;流程必须问人+看台账 |
| 只访一个部门就画全流程 | 流程是跨部门的,单部门视角缺一段,建模时动作接不上 | 每条主流程至少两个岗位交叉验证 |
| 把对接人当决策人 | 方案做了没人拍,拖一个月 | 第一次见面就问清「这件事最后谁定」 |
3.7 客户话术
4 阶段 2 业务规划 已完稿
4.1 这段要解决什么
一句话:把客户嘴里的「活」,翻成「要做哪几个数字员工、每个接哪一段、做到什么算成」,并且让客户把「算成」写下来签掉。
4.2 逐格推进
格 2.1 业务分析(现状 → 痛点 → 目标 → 场景 → 价值)
| 四件套 | 内容 |
|---|---|
| 问什么 | 「今年最想解决的是哪一件事?」「现在的活具体怎么干的、卡在哪一步?」「这件事要是做好了,哪个数字会变、从多少变到多少?」「为什么现在做不了——是人不够、数据没有、还是规矩不清?」 |
| 产出 | 业务分析报告:五步各有内容——现状(谁在做、多久一次、一次多久)→ 痛点(带数字)→ 目标(从 X 到 Y)→ 场景(候选)→ 价值基线(省多少人力/多少时间/多少差错)。 |
| 算过 | ① 至少 2 个痛点带量化现状,数字有出处(台账/系统/客户明确口径);② 目标写成「从 X 变成 Y」,⛔ 不接受「提升效率」「减轻负担」;③ 五步缺任何一步都不算过。 |
| 可否跳 | 小项目可省(客户已有完整需求书且有人认账时)。跳了=这一格的现状数据要在 2.2 补回来,否则 2.3 的契约没有基线。 |
格 2.2 场景与编制(做哪几个数字员工)
| 四件套 | 内容 |
|---|---|
| 问什么 | 「这几段活里,你最想先让哪个『新同事』接手?只能上一个,你选哪个?」「哪些必须一个人从头跟到尾,哪些可以拆给不同的人?」「这两件事差得远,你要一个人干还是两个人干?」 |
| 产出 | 编制方案:每个数字员工写清四定义——名称 / 一句话职责 / 接哪一段活 / 与谁协作;外加依赖什么(哪个系统、哪份数据)和缺了怎么降级(数据拿不到时它退回做什么)。 |
| 算过 | ① 每个数字员工都答得出四定义,且「一句话职责」里没有「等」字(有「等」=边界没划清);② 编制覆盖的场景,其耗时/频次合计 ≥ 客户拍板的那个第一优先场景;③ 一个数字员工管两件不相关的事 = 编制拆错,退回重拆。 |
| 可否跳 | ⛔ 不可跳。它是阶段 3 建模方案与阶段 4 上架的直接输入。 |
格 2.3 结果契约(可验收的承诺)
| 四件套 | 内容 |
|---|---|
| 问什么 | 「三个月后我说这件事成了,你认不认的标准是什么?」「是每周少花几个小时、一份本来要三天的表变成半天,还是准确率到多少?」「这个数从哪看得到、多久看一次、谁来看?」 |
| 产出 | 结果契约(一页纸):≥3 个可量化指标,每个写全四要素——口径(怎么算)、数据来源(哪个系统/哪张表)、统计周期(每周/每月)、达标线(多少算成);末行客户书面确认。 |
| 算过 | ① 每个指标四要素齐全,缺一个不算;② 达标线能由现有数据算出来(数据现在拿不到 ⇒ 先定「多久内能拿到」);③ 客户书面确认(签字/邮件/微信留痕),口头不算。 |
| 可否跳 | ⛔ 不可跳。阶段 5 的运行报告只有这一份基准,没有它,成效好不好全靠嘴。 |
⛔ 「周报由 AI 自动生成,大幅提高效率」
✅ 「周报每周五 18:00 前由数字员工出初稿;人工修改条数 ≤ 3 条/期;数据来源=业务系统;连续 4 周达标算成;2026-12-05 起算」
4.3 你手上要交出什么
| 产出 | 内容要求 | 存哪 |
|---|---|---|
| 业务分析报告 | 现状 / 痛点(带数字)/ 目标(从 X 到 Y)/ 候选场景 / 价值基线 | 项目档案;进平台后挂「交付物」 |
| 编制方案 | 每个数字员工四定义 + 依赖 + 降级;标注「本版基于哪版业务分析」 | 同上 |
| 结果契约 | ≥3 个指标 × 四要素 + 客户书面确认页 | 同上,另存一份给客户 |
三件都要标版本号和事实/推断:客户没说过的推断写「推断-待确认」,⛔ 不混在事实里。客户签了字的那一版锁死,后面改要出新版本号。
4.4 智兑现干哪些活(你不用自己干)
- 把访谈记录、台账、系统截图整理成「现状五步」结构化表(谁做/频次/耗时/痛点)
- 把痛点换算成价值基线(人力小时、错误率、周期),并标出每个数字的出处
- 按场景算候选价值并排序,出候选表供你和客户挑——排序建议是草稿,选哪个由客户拍
- 起草编制方案(四定义草稿)与结果契约草稿,把缺口径的地方单独列出来问你
- 核对契约指标「现在能不能算出来」,标 L1–L4 数据可得性
4.5 出关判定(逐条打勾,缺一条不出关)
| ☑ | 判定项 | 判定方式 |
|---|---|---|
| ☐ | 业务分析五步齐,≥2 个痛点带量化现状 | 数报告里的数字,每个能指出来源 |
| ☐ | 目标都写成「从 X 到 Y」 | 正则扫「提升/加强/优化」这类无靶词,出现即返修 |
| ☐ | 每个数字员工四定义齐,职责里无「等」 | 逐个读,两件事塞一个员工的退回拆 |
| ☐ | 编制覆盖第一优先场景 | 场景清单打勾对 |
| ☐ | 结果契约 ≥3 个指标 × 四要素齐 | 逐个指标四要素对照 |
| ☐ | 契约已客户书面确认 | 见到签字/邮件/微信留痕原文 |
| ☐ | 三件产出都标了版本号与事实/推断 | 抽查 5 条 |
平台侧(项目进平台后):阶段对象的 exit_met 填「满足」,没满足的写进 exit_gap 并标来源,再进下一段。⛔ 不许先推段后补记录。
4.6 新人常犯的三个错
| 错 | 后果 | 怎么避免 |
|---|---|---|
| 承诺写「提升效率」 | 阶段 5 没法证明成没成,验收变成人情仗 | 每个目标都必须「从 X 到 Y」,Y 要能被现有数据算出来 |
| 一个数字员工塞三件不相关的事 | 权限、数据源、使用者全对不上,阶段 4 建出来谁都用不顺 | 按使用者与权限档拆,不按操作动作拆 |
| 契约只写指标、不写数据从哪来 | 到期算不出来,客户说「这数不对」,你没法举证 | 每个指标必须写四要素,数据源先验可得性 |
4.7 客户话术
5 阶段 3 本体建模 骨架 · 待展开
本段将写:3.1 准入判定(五类输入缺一不开工)/3.2 出方案(对象·属性·关系·动作·字典·权限)/3.3 机检到 0 ERROR/3.4 业务方逐对象确认。
术语与表格口径与《FDE 本体建模操作手册 v1.2》一致,本手册不重复其操作细节,只写你在这段要做的判断与签字。
45 个动作的说明部分等建模方案 V5.0 定稿后再写(动作清单可能变)
6 阶段 4 平台落地 骨架 · 待展开
本段将写七步:4.0 接入验权/4.1 三方比对/4.2 变更集分级/4.3 dry-run/4.4 你确认(唯一人工卡点)/4.5 分段执行/4.6 冒烟/4.7 归档。
重点写你在 4.4 要看什么、怎么拒:三类必须人来定(删对象/改列类型/改关系挂钩列),以及漂移怎么报人。
7 阶段 5 运行 骨架 · 待展开
本段将写:员工真用起来怎么推(上线沟通、试跑期、谁答疑)、采哪些指标、运行报告怎么写、成效不达标怎么办。
实操条款等第一个项目走到运行期再补(现在写会是空模板)
8 阶段 6 沉淀 骨架 · 待展开
本段将写:复盘怎么写(不是总结成绩,是找返工根因)、哪些东西能入库复用、脱敏怎么做、项目怎么关闭或终止。
9 四张表怎么审 骨架 · 待展开
对象表/属性表/关系表/动作表的审阅要点(新人要能看懂才拍得了板)。⛔ 不写平台操作步骤——那是工具手册。
10 客户沟通:话术与禁区 骨架 · 待展开
按场景汇总裁客话术:第一次见面/要资料/口径不一致/进度延后/要求加需求/上线阻力/验收签字。
11 红线(碰到就是事故)
| 红线 | 为什么 |
|---|---|
| 客户没确认的方案不进客户平台 | 草稿进生产环境,撤不干净,信任一次就没了 |
| 不替客户拍业务板(口径、优先级、谁负责) | 你拍错了,责任在你;客户内部的事归客户 |
| 不在方案里写无出处的数字 | 一个假数字被客户抓住,整份方案都不可信 |
| 不删客户平台对象、不改列类型、不改关系挂钩列 | 静默丢关系与订阅、历史断链,且平台不支持回退 |
| 不承诺没验过的效果(「AI 都能做」「一周上线」) | 阶段没到,你没资格判断;承诺变成合同义务 |
| 账号密码/token 不写进任何文档、不发群 | 泄密+客户追责 |
12 术语表 骨架 · 待展开
新人必须能对客户讲清的一批词:FDE/数字员工/本体/对象·属性·关系·动作/字典/查询权限/L1–L4/门禁/变更集/冒烟/漂移/dry-run。每个词一句大白话+一句「对客户怎么说」。
13 未定项清单 ⏳
| # | 未定项 | 卡在什么 | 谁定 |
|---|---|---|---|
| 1 | 阶段 5–6 实操条款 | 还没项目走到运行/沉淀期,现在写=空模板 | 跟项目走,走到就补 |
| 2 | 45 个本体动作的说明 | 等建模方案 V5.0 定稿,动作清单可能变 | 家辉出 V5.0 |
| 3 | 编制方案/结果契约模板 | 等真实客户样本(NFXH 为候选) | 项目走到阶段 2 |
| 4 | 客户交付版手册 | 本手册是内部新人版,客户版另做(口径不同、要去商业信息) | 第一个正式客户交付时 |
| 5 | 时长与人力估算表 | 样本不足,现在估=编 | 攒够 3 个项目数据后 |
14 待办总表
✅ 现在能做
| 项 | 说明 | 状态 |
|---|---|---|
| 本手册目录+第 3 章样章 | 本文件 | 已完成(待你点头) |
| 第 1、2 章(开工前四件事 / 六段与格) | 已同步写出,等样章确认后一并定稿 | 已出草 |
| 第 4 章 阶段 2 业务规划 | 已按第 3 章模板铺全(七小节) | v0.2 已完稿 |
| 其余各段展开(第 5–9 章) | 按同一模板铺 | 排队中 |
| 第 10 章话术、11 章红线、12 章术语表 | 不依赖外部条件 | 排队中 |
⏸ 等条件
| 项 | 卡在什么 |
|---|---|
| 动作说明、编制模板、运行/沉淀实操条款 | 见第 13 章未定项清单 |
| 客户交付版手册 | 首个正式客户交付时 |
🐞 平台侧(不在本手册范围)
禅道问题单由对接人跟踪,手册不列。
附录 A · 智兑现技能触发口语示例 2026-11-04 实测
数据来源:在交互工作台让它现场 skills_list 查的 22 条(不是凭记忆),名字与描述原文逐字取回。
A.1 它是怎么被触发的(一句话)
A.2 说话三原则
| 原则 | 意思 | 反例 → 正例 |
|---|---|---|
| 说业务,不说术语 | 它听得懂"这张表该建什么",不必说"业务映射判据" | ⛔「跑一下 A1」→ ✅「你帮我看看这些台账该建哪些对象」 |
| 一次只问一件事 | 一句话里塞三段活,它会挑一件做或全摊开 | ⛔「整理需求、出对象、再跑机检」→ ✅ 先说「先整理需求」 |
| 带上当前段 | 跨段的话先说是哪一段,避免调到相邻技能 | ⛔「资料发你了」→ ✅「这是组织诊断阶段的资料,先看可信度」 |
A.3 22 条技能 × 触发口语
阶段 1 · 组织诊断
| 技能 | 它管什么 | ✅ 这么说会触发 | ⛔ 这么说会跑到别处 |
|---|---|---|---|
fde-org-diagnosis | 组织/岗位/流程与准入判定 | 「下周去这家单位,先帮我理一下他们有哪些部门、谁管什么」 「他们把组织架构图发我了,你看能不能开始建模」 「这个活从接到办完要问谁、卡在谁那」 | 只要整理需求条目 → 走 requirement-structuring |
fde-source-evidence | 资料能不能当事实用 | 「这几份台账是客户发的,哪些能直接用」 「他口头说一年三百单,跟台账对不上,这条能写进方案吗」 「资料都在这,先帮我看看可信度」 | 要出对象/属性 → 走 business-mapping |
fde-dependency-analysis | 要客户给什么、拿不到怎么办 | 「他们说数据导不出来,这活还能不能做」 「要客户开接口,得谁批、多久」 「哪些得靠客户给,列一下我去要」 | — |
阶段 2 · 业务规划
| 技能 | 它管什么 | ✅ 这么说会触发 | ⛔ 这么说会跑到别处 |
|---|---|---|---|
fde-requirement-structuring | 资料 → 需求条目 | 「今天访谈到的东西我记了一堆,帮我理成需求」 「客户提了七八件事,别漏」 「这些表单里的要求归成几条需求」 | 要判断可信度 → source-evidence |
fde-caliber-confirmation | 模糊口径 → 确认清单 | 「他说按季度算,上次说按月,这个我该怎么问」 「把还没定清的业务口径列成清单,我去问」 「这个字段到底怎么算我没听懂,写成问题问他」 | — |
阶段 3 · 本体建模
| 技能 | 它管什么 | ✅ 这么说会触发 | ⛔ 这么说会跑到别处 |
|---|---|---|---|
fde-business-mapping | 台账/访谈 → 该建哪些对象 | 「这是我们南京在用的台账,你帮我推一下该建哪些对象」 「这些表能建几个对象,每个对象要哪些字段」 「台账这些列,哪些该是字段、哪些该是字典」 | 只整理需求 → requirement-structuring;只判可信 → source-evidence |
fde-capability-attribution | 该放本体/流程/技能/界面哪一层 | 「这个活放本体、放工作流,还是写成技能」 「这判断让 AI 做还是让流程做」 「这条数据建对象,还是就加个字段」 | — |
fde-ontology-modeling | 出四表方案(主建模) | 「按平台要求把这几个对象做成方案」 「帮我出对象、属性、关系、动作四张表」 「这套建模怎么写才符合规范」 | 只要查错 → lint/checklist |
fde-ontology-lint | T1–T13 机检 | 「跑一下机检,看还有没有 ERROR」 「这份方案能不能交,先自己查一遍」 | 两条几乎同义(见 A.4 第 ② 组) |
fde-ontology-checklist | 交付前 42 条自检 | 「交付前把 42 条自检跑一遍」 「这份清单还有什么没对齐的」 |
阶段 4 · 平台落地
| 技能 | 它管什么 | ✅ 这么说会触发 | ⛔ 这么说会跑到别处 |
|---|---|---|---|
fde-platform-connect | 连客户平台、验权限 | 「客户平台账号给我了,先试试连不连得上」 「接口报 401,是不是权限问题」 | — |
fde-platform-snapshot | 拉平台现状 | 「先把客户平台上现在有什么拉一份下来」 「上次建的还在不在,拉个现状」 | 要对比差异 → platform-diff |
fde-platform-diff | 三方比对、出变更集 | 「方案跟客户平台现在差多少,列个变更清单」 「有没有别人手工改过的地方」 | — |
fde-platform-apply | 按变更集执行、回读 | 「变更单确认了,开始建吧」 「从哪一步建,断了怎么接着做」 | 还没比对就让它建 → 先走 diff |
通用与通道
| 技能 | 它管什么 | ✅ 这么说会触发 | ⛔ 边界 |
|---|---|---|---|
fde-project-navigator | 人下一步干什么(一格一格) | 「我接了个新项目,下周见客户,先干什么」 「下一步该做什么」 「这单能不能接」 | 问"能过阶段吗" → phase-gate |
fde-phase-gate | 阶段判定、能否出关 | 「这项目现在到哪一段了,能不能往下走」 「阶段二能过了吗,还差什么」 | 问"我该干什么" → project-navigator |
fde-deliverable-report | 报告/文档结构与汇报口径 | 「这些内容帮我出一份报告」 「给老板汇报怎么写」 「写份分析报告,带数据来源」 | 要发成网页 → html-manual-delivery |
fde-html-manual-delivery | 做成网页并发布链接 | 「把这份手册做成网页,发我个链接」 「这个清单做成能在线上看的页面」 | 只是写文档 → deliverable-report |
fde-versioned-doc-release | 版本化发布(md+xlsx) | 「把最新版方案 md 和 Excel 一起发布出去」 「发一版 v1.3 给别人用」 | — |
智能体-skill-maintenance | 它自己改技能 | 「把你自己的技能改一下」 「这条判据加到你的技能里」 「新建一个技能」 | — |
remote-shell-tasks | 远程服务器跑命令 | 「在服务器上跑个命令看看」 「把这台机器的文件同步过去」 | — |
workbench-delivery | 发文件、发消息 | 「把这个文件发我」 「下午三点提醒我一句」 | — |
A.4 五组撞车(现状诊断 → 处置)
「撞车」=同一句口语语义上同时命中 ≥2 条技能。后果不是不触发,而是触发了错的那条——给你一套看似专业的错答案。下面五组是 22 条描述比对出来的,按风险排序。
| # | 撞车组 | 为什么撞 | 处置 |
|---|---|---|---|
| ① | source-evidence / requirement-structuring / business-mapping | 三条描述都以"收到资料/台账/访谈"开头 | 最高:描述里各写死「要可信度」/「要条目」/「要对象」三个不同落点;手册 A.3 已给出分流话术 |
| ② | ontology-modeling / ontology-lint / ontology-checklist | "自检"一词三条都有;lint 与 checklist 实际是同一件事的两套编号 | 高:按顺序固定为「建模产出 → lint 机检 → checklist 交付前总检」,并在描述里互指 |
| ③ | deliverable-report / html-manual-delivery / versioned-doc-release | 都要"出交付物" | 中:按形态分(文档 / 网页 / 版本发布),描述首句写形态 |
| ④ | project-navigator / phase-gate | 都谈"阶段" | 中:navigator 答「我下一步做什么」,phase-gate 答「能不能过关」 |
| ⑤ | remote-shell-tasks / workbench-delivery | 低(场景差异明显) | 暂不动 |
Use when … 是早期照搬英文模板;中文描述里它占 7 个字符(57 字符预算的 12%),换不来任何额外命中。⇒ 统一规则改为:首句必须是触发条件(「…时用」),触发词放最前,末尾带一句边界;不强制 Use when。A.5 22 条描述终稿(触发前置+撞车互斥)
按 A.4 的撞车诊断,把「边界/该转哪条」直接写进描述——能提前规避的都在描述里规避,不指望模型自己猜。全部 ≤50 字符(平台限 60,留余量给截断)。这批文本由智兑现自己改,改完回读 description 原文核对。
| # | 技能 | 现在的描述 | 改成(触发前置+互斥) |
|---|---|---|---|
| 1 | fde-business-mapping | Use when 从台账/访谈推出该建哪些对象、属性、归属。别名:业务映射判据 A1。 | 从台账/表单推该建哪些对象、属性、归属时用;只整理需求→需求结构化,只判可信→资料取证。 |
| 2 | fde-requirement-structuring | Use when 收到现场资料、访谈记录、客户表单、业务口述,需要整理成需求条目。别名:B1-需求结构化。 | 把资料/访谈/表单整理成需求条目时用;要推对象属性→业务映射。 |
| 3 | fde-source-evidence | Use when 收到现场资料要整理成结构化内容、或判断某条信息能不能当事实写进交付物。别名:A2-资料接入与取证纪律。 | 判断某条信息能否当事实写进交付物、资料可信度时用;要出条目→需求结构化。 |
| 4 | fde-caliber-confirmation | Use when 要为某个模糊口径向客户确认、或要写确认清单交给 FDE 去问。别名:C3-口径确认话术。 | 要问客户模糊业务口径、写确认清单时用。 |
| 5 | fde-dependency-analysis | Use when 要判断某个数据能不能拿到、需要客户给什么授权、拿不到怎么办。别名:C2-外部依赖与制约分析。 | 判断数据能不能拿到、要客户给什么授权时用。 |
| 6 | fde-org-diagnosis | 组织诊断:判定建模准入、理组织与岗位、出数字员工清单 | 摸清客户组织/岗位/流程、判能否开工建模时用。 |
| 7 | fde-capability-attribution | 当需要判断某个功能或数据该放到本体、流程、技能、职责还是界面哪一层时使用。别名:B3-能力归属判据。 | 判断某事该放本体/工作流/技能/界面哪层时用。 |
| 8 | fde-ontology-modeling | 本体建模标准与自检:按平台配置项产出对象/属性/关系/动作并逐条自检 | 出对象/属性/关系/动作四表建模方案并按规范自检时用。 |
| 9 | fde-ontology-lint | 建模清单自机检:跑 T1–T13 判据,非 0 ERROR 不许交付 | 建模方案跑 T1–T13 机检看是否 0 ERROR 时用;交付前总检→checklist。 |
| 10 | fde-ontology-checklist | 建模清单交付前必跑的 42 条自检(含 ERROR 级汇总) | 建模产出后、交付前跑 42 条总检汇总 ERROR 时用;机检→lint。 |
| 11 | fde-platform-connect | 接客户本体平台:账号登录取 token、验权限、失败排查 | 要连客户本体平台验权限、或连接鉴权失败排查时用。 |
| 12 | fde-platform-snapshot | 拉平台现状快照:对象/属性/关系/动作/字典全量归一化存档 | 拉客户平台现状快照存档时用;要与方案对比→平台比对。 |
| 13 | fde-platform-diff | 方案与平台现状三方比对:出变更集、辨平台漂移与冲突 | 把方案与平台现状比对、出变更集、识漂移时用。 |
| 14 | fde-platform-apply | 按确认变更集执行建模:dry-run、断点续做、变更日志与回滚计划 | 变更集已确认、要执行落地并回读时用;还没比对→先平台比对。 |
| 15 | fde-phase-gate | Use when 判断FDE项目处于哪个阶段、该产出什么、能否进入下一阶段。别名:C1-六段法与阶段门禁。 | 判断项目在第几段、能否出关进下一段时用;问下一步做什么→导航。 |
| 16 | fde-project-navigator | Use when FDE 接新项目或问下一步干什么。陪跑导航:一格一格推。别名:项目运营导航 A2。 | 接新项目或问下一步该干什么时用(一次只推一格);能否过阶段→门禁。 |
| 17 | fde-deliverable-report | Use when 产出分析报告、建模文档、清单或汇报材料,需要定结构和话术。别名:B4-交付物结构与汇报。 | 要出文档型报告/汇报材料、定结构与话术时用;发网页→网页手册。 |
| 18 | fde-html-manual-delivery | Use when 生成 HTML 手册/速查交付物并发布到 fileport,数据取自落库清单时。 | 把手册/清单做成网页并发布链接时用;只写文档→交付物规范。 |
| 19 | fde-versioned-doc-release | Use when 发布版本化建模清单(md+xlsx)到交付目录,先三项数字自证后发布。 | 发布版本化清单 md+xlsx 到交付目录、先三项自证时用。 |
| 20 | 智能体-skill-maintenance | Use when 更新或新建技能(skill_manage 被拒、改自家技能超限、回读校验)时。别名:技能库维护。 | 要新建或改它自己的技能(被拒、超限、回读校验)时用。 |
| 21 | remote-shell-tasks | Use when 需要在远程服务器跑 SSH 命令(勘察、同步、运维),尤其当前会话无终端工具时。 | 要在远程服务器跑 SSH 命令时用。 |
| 22 | workbench-delivery | Use when delivering files or sending proactive messages. | 要发文件或主动发消息时用。 |
skills_list 回读与终稿逐条一致。随后跑路由首测:已跑 12 条、12 条与期望一致(A 组 8/8 命中;跨段只推一格;闲聊不加载 FDE 技能;无邮件通道时拒答不硬做)。记录见 智兑现_路由测试结果_20261104.md。A.6 现行体系:19 条(22→19 合并结果,2026-11-04)
合并判据(三条缺一就不该独立存在):① 有独立触发语义位(真人会说一句只指向它的话)② 有独立实质判据(≥1500 字符的判断规则,不是清单摘要)③ 有独立交接点(上一步交什么、产出什么、交给谁)。
三处合并 + 两处删重复段
| # | 动作 | 为什么 | 结果(回读实测) |
|---|---|---|---|
| 1 | ontology-checklist → ontology-lint | 被并技能整条只有 1 节「交付前自检清单」,没有独立触发位;同一件事两套编号(13 条 vs 42 条) | lint 正文 3360 → 5337,新节「交付前总检(42 条)」42 行连续无缺 |
| 2 | phase-gate → project-navigator | 六段模型写了两遍;两条都产出「现状/下一步」格式 | navigator 正文 1488 → 3748,新节「阶段与门禁」8 个小节 |
| 3 | versioned-doc-release → html-manual-delivery | 都以「发布到交付目录/链接」为主;「三项数字比对」与「行数自证」是同一件事两处写法 | html-manual 正文 5045 → 11927,新节「版本化发布」5 个小节 |
| 4 | 删 source-evidence 第六节「四表口径」 | 与 ontology-modeling 的四表定义重复 | 1887 → 1457,留一行「四表口径见 fde-ontology-modeling。」 |
| 5 | 删 org-diagnosis「数据可得性分级 L1–L4」 | 与 dependency-analysis 的「可获取性四级」重复 | 1303 → 1158,留一行「数据可得性分级见 fde-dependency-analysis。」 |
现行 19 条(按六段归位)
| 段 | 技能(19 条) |
|---|---|
| 1 组织诊断 | fde-org-diagnosis、fde-source-evidence、fde-dependency-analysis |
| 2 业务规划 | fde-requirement-structuring、fde-caliber-confirmation |
| 3 本体建模 | fde-business-mapping、fde-capability-attribution、fde-ontology-modeling、fde-ontology-lint(含 42 条总检) |
| 4 平台落地 | fde-platform-connect、fde-platform-snapshot、fde-platform-diff、fde-platform-apply(四条有意不合并:各自对应一个「必须停下来」的卡点) |
| 通用 | fde-project-navigator(含门禁/格/状态卡)、fde-deliverable-report、fde-html-manual-delivery(含版本化发布) |
| 通道 / 元 | workbench-delivery、remote-shell-tasks、智能体-skill-maintenance |
合并后回归(20 句,2026-11-04 12:25–12:33)
行为 20/20 正确;署名按现存技能名计 17/20——3 处沿用了已删技能旧名(A8/B4 署 phase-gate、B3 附提 checklist)。真实原因是署名时没先核 skills_list,不是残留(memories/ 与 SOUL.md 零命中);已承认并在 ontology-modeling 正文与 .usage.json 清掉 2 处磁盘残留。
FDE 项目全流程操作手册 v0.2 · 2026-11-04(基线:v0.1 目录+样章+附录 A)| 真源:FDE项目全流程架构_V1.0_20261102.md