FDE 项目全流程操作手册 v0.5

读者:刚入行、不懂 AI 落地的 FDE 同事。目标:从见到客户第一面,到把数字员工建进平台、跑起来、收尾复盘,全程知道自己在哪一段、这一步要做什么、做到什么算过。

本版=完整目录 + 第 3–6 章铺开(阶段 1 组织诊断 / 阶段 2 业务规划 / 阶段 3 本体建模 / 阶段 4 平台落地)。第 6 章的平台操作细节部分待定(等平台标准接口),已写死的那部分是「你在 4.4 看什么、怎么拒」。

六段法四人工介入点格=一个可交付动作未定标 ⏳待定v0.5 · 新增第 10、12 章

本版怎么读

手册写「人做什么」每段只讲你这个真人要做的动作、要交的东西、怎么判断过关。AI(智兑现)干的那部分只列名字,不写操作步骤——那是工具手册的事。
一格=一次能做完的事全流程拆成格(如 1.2 组织与流程)。一次只推一格:做完回填状态卡,再进下一格。
每格四件套问什么(原话)/产出什么(手上多哪份东西)/什么算过(可判定)/能不能跳(跳了会怎样)。四件缺一件=这格没写清。
⏳待定 不许装没定的写 ⏳待定+卡在哪,第 13 章汇总。⛔ 不写好听的空话顶上。
怎么用这本手册:① 第一次接项目,按第 2 章看清六段在哪;② 每天开工前读当前段那一章的「逐格推进」;③ 每格做完,把四件套回填成状态卡贴给智兑现(格式见 2.4);④ 出关前读该章「出关判定」,逐条打勾。

0 三分钟速览

一条线:客户的一句话 → 客户能用的数字员工

1 组织诊断看懂这家单位
谁说了算、活怎么流
→
2 业务规划定做哪几个数字员工
值不值、承诺什么
→
3 本体建模画图纸
对象·属性·关系·动作
→
4 平台落地照图纸施工
建进客户平台并验证
→
5 运行让人真用
出运行数据
→
6 沉淀复盘、入库
下个项目少踩坑

新人第一周只需要记住四句

  1. 我们卖的不是软件,是「数字员工」——能把某个人某段重复活接过去的 AI 员工,它要知道这个单位的业务长什么样(=本体)。
  2. 材料不到手,不开工。五类输入缺一类,先出「缺什么、去哪拿、谁给、什么时候给」,不是硬着头皮编。
  3. 凡是「大概、差不多、行业上一般」的数字,一律不能写进方案。要么有出处,要么标待确认。
  4. 四个决定只能人做:给业务、拍方案、确认变更集、授权账号。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 入库与脱敏复盘+SOP6.2 可延后
为什么拆格而不是拆任务:格有边界(做完手上多一份东西)。任务没有边界,新人会一直「在调研」。

2.2 状态卡(每格做完必贴)

【现状】第 X 段·段名 | 第 Y 格 【已确认】n 项:…… 【待确认】n 项:……(卡在谁 / 去哪拿 / 什么时候给) 【这一格】问什么 | 产出 | 算过 | 可否跳

作用:① 你自己清楚到哪了;② 交给智兑现,它据此推下一格,不会重复问你;③ 换人接手,贴一张卡就接得上。没有状态卡=这格等于没做。

3 阶段 1 组织诊断 样章 · 已完稿

3.1 这段要解决什么

一句话:搞清楚这家单位靠什么活、谁对什么负责、每一段活怎么流转,并且让客户确认你理解的和他说的一致。

解决对象边界、岗位责权、流程走向、术语、数据拿不拿得到。
不解决具体建什么对象、怎么建模、报价、写方案——那是后面的事。
时长参考中小单位 1–2 周;跨多部门的大型单位 3–4 周。宁可慢,不可缺。
谁必须见到决策人(拍板的人)、业务专家(干活的人)、对接人(传话的人)——三种人缺一种就有一块是空的。

3.2 逐格推进

格 1.1 收料(五类输入准入)

四件套内容
问什么「我们这个项目,先要五样东西:① 你们靠什么赚钱/靠什么完成主责主业 ② 部门、岗位和各自管什么 ③ 从接到事到办完,中间经过谁 ④ 平时用的表单/台账/系统截图 ⑤ 这些数据现在在哪、能不能导出。这五样哪样现在能给,哪样要走流程?」
产出① 资料清单(每份标:来源人、日期、形式、可信度)② 缺口清单(缺哪类、去谁那要、什么时候给);手上有 4 类以上、缺的第 5 类写明来源与时间=这格可过。
算过五类输入里 ≥4 类已到手且有出处;缺的每类都写明「谁给、什么时候给」。⛔ 不合格写法:「资料基本齐全」「客户会配合」。
可否跳⛔ 不可跳。跳了=后面对象边界全错,返工重做整个阶段 3。

资料可信度排序(拿不准时按这个排):台账/表单/系统截图 > 访谈记录 > 制度文件 > 行业通识。只有前两类能支撑属性和动作。

数据可得性分四级(决定这事能不能做):

级别含义结论
L1有接口可直读能做
L2能导出文件能做(半自动)
L3只能人工补录慎做,要算人力成本
L4数据根本不存在不能做,当场说清
要点:客户给不出数据的活,别在阶段 1 含糊过去——到最后建成空表,返工成本和信任损失都是你的。

格 1.2 组织与流程

四件套内容
问什么组织:「你们一共几个部门?每个部门几个人、分几个岗?某个活出问题,最后谁负责、谁能拍板?」
流程:「拿最常见的那个事举个例子——从接到到办完,第一步谁做、第二步到谁手上、卡在谁那最久、返工最多的是哪一步?」
产出① 组织建模信息:部门/岗位/人数/责权/汇报关系/决策人 ② 业务流程清单:3–8 条主流程,每条有起点、终点、涉及岗位、当前最痛的点
算过每个关键岗位能答出「谁问、谁写、参与哪个判断」;主流程走到「端到端」——起点终点都在,中间不留「这里大概是这样」;决策人姓名与职务已确认(不是「领导」)。
可否跳⛔ 不可跳。跳了=后面动作只能编,本体一建就假。
访谈节奏(新人照做):先决策人(15–20 分钟,只问目标与痛点,不问细节)→ 再业务专家(单部门 45–60 分钟,带台账逐行问)→ 最后对接人(确认资料与时间表)。一天最多两个部门,回来当天整理,隔夜细节会丢。

格 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 客户话术

「王经理,这周想跟您约三个人:您本人 20 分钟,说说今年最想让谁轻松点;张姐和李哥各 1 小时,把他们手上那张表拿给我看一遍。看完我出一份《你们现在的活是怎么流转的》,请您过目——不是方案,就是确认我有没有看错。」
「这几份东西我只看事实,不看制度怎么写。制度我另外看,用来对规矩。」
「这个数据现在导不出来是吧?那我先记成『卡点』,等 IT 那边有答复我们再定这块做不做——先不做承诺。」
⛔ 别说的三句:「这个很简单,一周就能做完」(承诺早了就下不来台)/「行业上一般都这么做」(客户只认自己的活)/「AI 都能做」(到阶段 1 你还没资格判断)。

4 阶段 2 业务规划 已完稿

4.1 这段要解决什么

一句话:把客户嘴里的「活」,翻成「要做哪几个数字员工、每个接哪一段、做到什么算成」,并且让客户把「算成」写下来签掉。

解决优先级(先做哪个)、编制(做几个、各自管哪段)、承诺(做到什么算成)。
不解决具体建哪些对象字段(阶段 3)、报价(销售)、平台怎么建(阶段 4)。
时长参考中小项目 1–2 周;无现成需求书、要重做业务分析的 3 周左右。承诺口径那一步决策人必须到场。
谁必须在场决策人(定目标与预算)、业务专家(核痛点数据)、对接人(管进度与书面确认)。
这段是全流程唯一「同时得罪人也救人」的地方:定得越狠,后面越好过;含糊一句「提升效率」,到阶段 5 出运行报告时就是各说各话。

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 客户话术

「上次看的那几段活,我理了一遍。想先跟您定一件事:如果只能先上一个『新同事』,您希望它先接哪一段?为什么是这一段?」
「咱们把话说实:三个月后怎么算这件事成了?您给个数——是每周省几个小时,还是这份表几天变半天,还是错得少了。数字从哪看得到,我去确认能不能拿到。」
「这个指标您说得对,但我们现在系统里查不到,只能人工统计。要么我们先换一个能查到的,要么这条写『待数据打通后再定』——您选。」
⛔ 别说的三句:「这个肯定能提效 50%」(你自己算不出来就别替客户报数)/「功能都能做,先上都行」(编制没拆清,建出来是废的)/「验收标准后面再定」(后面定=没有标准)。

5 阶段 3 本体建模 已完稿

5.1 这段要解决什么

一句话:把第 4 章定下的「做哪几个数字员工」,画成客户看得懂、认得的图纸——对象、属性、关系、动作、字典、查询权限,机检 0 ERROR,客户业务方逐对象签过。

解决对象边界、字段归属、流程动作、谁能看哪部分数据。
不解决怎么建进平台(阶段 4);也不解决报价与合同。
时长参考中小项目 1–3 周;对象 30 个以上的 4 周。返修主要在「客户不认同一个词」,不在技术。
谁必须在场业务专家(核每个对象「谁问/谁写」)、决策人(最后拍这份图纸)。
硬边界:本段产出的是图纸,⛔ 不进平台。方案没审批通过、或客户业务方没确认,一律不许开始建(见第 11 章红线)。

5.2 逐格推进

格 3.1 准入判定(五类输入,缺一不开工)

四件套内容
问什么这一格不新问客户,是自查:业务全貌/组织与岗位责权/端到端流程/业务对象与术语/数据可得性——五类逐条打「有/缺」。缺的写:缺什么、去哪拿、谁给、什么时候给。
产出准入判定表(五类 × 有/缺 × 出处)+ 缺口清单(每条有责任人与日期)。
算过≥4 类已到手且有出处;缺的每类写明来源与时间。⛔ 不许「边建边补」——补料期间出的图纸必然要返修。
可否跳⛔ 不可跳。跳了=对象边界靠猜,返工重做整段。

格 3.2 出方案(四表 + 字典 + 查询权限)

四件套内容
问什么「这个东西在你们这儿叫什么?」(要真俗称,不是你想的名字)「平时谁问、谁写?」「这两个东西是不是一回事?」「这条数据谁能看、谁不能看?」
产出建模方案六件:对象表 / 属性表 / 关系表 / 动作表 / 字典(code+name)/ 查询权限表,+ 自检结果;交付形态=HTML(给人看)+ Excel(给人填)。
算过① 每个对象答得出「谁问/谁写/参与什么判断」;② 别名 ≥3 个真俗称(对象名本身不算别名);③ 每个属性有归属(谁填、可不可空);④ 每个对象过动作四格:创建/改关键字段/状态流转(进出双向可达)/作废关闭;⑤ 权限表每行写清三层。
可否跳⛔ 不可跳。四表缺一张,阶段 4 就建不出能用的东西。
越简单越容易翻车的两条:① 「一个属性有两套名字」(驼峰 vs 下划线)——方案里必须写死,阶段 4 的查询与写库走的是两套口径;② 「一列挂两条关系」——挂不了,要拆成两列。这两条在图纸阶段改,比建完再改便宜十倍。

格 3.3 机检到 0 ERROR

四件套内容
问什么不问客户。你只问智兑现一句:「ERROR 几条、每条是什么、你改了什么?」
产出机检报告:T1–T14 逐条结果 + ERROR 0。
算过ERROR 必须 0;WARN 每条要写「接受它的理由」;⛔ 不接受「我看了没问题」「应该不影响」。
可否跳⛔ 不可跳。带 ERROR 的方案不许给人看——老板一眼看出错,整份方案都不可信。

格 3.4 业务方确认(你签字的依据)

四件套内容
问什么「这份对象表你认不认?」(逐个念名字与一句话说明)「这两个是不是一回事?」「这个字段实际是谁填的?」「这条数据他们部门能不能看?」
产出确认记录:逐对象标 认可/改了/暂缓 + 异议处理结果(改了什么、或为什么不做)。
算过每个对象都有业务方明确意见;「暂缓」的必须写清卡在谁;异议全部有去处(改了 or 记进未定项)。
可否跳⛔ 不可跳。这是你向上签字、向下开工的唯一凭据。

5.3 你手上要交出什么

产出内容要求存哪
建模方案(六件)对象/属性/关系/动作/字典/权限;带版本号;头部写「基线:上一版」项目档案 + 我方平台「方案版本」对象
机检报告T1–T14 逐条 + ERROR 0 + WARN 接受理由同上
确认记录逐对象意见 + 异议处理同上,另存一份给客户

版本纪律:每版一个新文件、⛔ 绝不覆盖;草案带 -draft 后缀,验收通过才占正式版本号;改结构升主版本、改内容升次版本、纯排版升修订号。

5.4 智兑现干哪些活(你不用自己干)

  • 按五类输入出四表初稿,把客户口头说法翻成对象/属性/关系/动作
  • 跑 T1–T14 机检,自己把 ERROR 修到 0,再交给你看
  • 出 HTML(给人看)+ Excel(给人填)两版交付物,并做「交付前四项数字比对」(对象数/属性数/关系数/动作数与正文是否一致)
  • 把客户确认时的异议落成变更,标出「影响哪些对象、要不要升主版本」
  • 标出资料之间的矛盾(口头说 30 人、名册 26 人),列成问题清单让你去问
边界:它能自己修 ERROR,但不能替客户认词——「这个东西你们叫什么」只有客户能答;它给你的确认记录是草稿,签字的人是你。

5.5 出关判定(逐条打勾,缺一条不出关)

☑判定项判定方式
☐五类输入 ≥4 类有出处,缺的写明谁给/何时给数准入表
☐六件齐(对象/属性/关系/动作/字典/权限)逐件点开看非空
☐每个对象答得出「谁问/谁写/参与什么判断」抽 3 个对象问智兑现,答不出即返修
☐每个对象动作四格齐全,状态双向可达看动作表是否有「出向」
☐机检 ERROR 0,WARN 每条有接受理由看机检报告原文
☐客户业务方逐对象确认,异议有去处看确认记录,抽查 5 条
☐方案版本号与「基线:上一版」写全看文件头

5.6 新人常犯的三个错

错后果怎么避免
拿制度文件当业务全貌建对象制度写「应该怎么做」,不是「实际怎么做」,建出没人用的理想世界制度只用来对规矩;对象与属性必须有台账/访谈出处
只建对象不建动作建出来只能看不能改,客户第一天就问「怎么不能改」,等于没建每个对象过动作四格,缺一格补一格
属性照抄列名、不问归属字段建出来没人填,或谁都能改;到运行期数据是空的每个属性写清「谁写、必填与否、密级」

5.7 客户话术

「我把你们说的那些事画成一张表了。先不看字段,就念名字给你听——这个名字你们平时是这么叫的吗?不对我改。」
「这个东西,平时是谁在填、谁会去查?我要写清是给谁用的,不然建出来没人用。」
「这一条数据我先标『暂缓』——等你们信息中心答复能不能导出来,我们再定这块做不做。先不做承诺。」
⛔ 别说的三句:「这个我们业内都这么建」(客户只认自己的活)/「字段先随便定,后面再改」(建好改类型要重建)/「先建进去你们再用着看」(没确认就建=把草稿建进生产)。

6 阶段 4 平台落地 部分待定 ⏳

6.1 这段要解决什么

一句话:把图纸建进客户平台,并证明「能用」而不是「建好了」——建完要真跑一次查询、核一遍渲染,出了问题能回退、能说清改了什么。

本段实操条款部分待定。原因:截至 2026-11-04,平台尚未提供标准建模接口(建对象/属性/关系/动作/权限的批量接口),现有做法靠页面逐点或复用登录态直连,属侵入式,已停用。⇒ 现在能写死的是「你在 4.4 看什么、怎么拒」和七步的顺序与判据;具体怎么点、怎么调,等接口文档到位再补。见第 13 章未定项。
解决落得对不对、能不能用、出事怎么退。
不解决画图纸(阶段 3);也不解决客户用不用(阶段 5)。
时长参考14 对象级 1 周内;50 对象以上按段分批。慢在核对,不在执行。
谁必须在场你(变更集确认)+客户 IT(账号授权)。

6.2 七步怎么走(每步:谁做 / 产出 / 算过)

步做什么谁做算过
4.0 接入验权拿客户给的账号/接口权限,先只做一次读操作智兑现;你取授权读得到=通;不通就停,⛔ 不硬试、不换野路子
4.1 三方比对方案 V_n × 平台现状 × 上次基线,分出三类:我方变更/平台漂移/冲突智兑现三类都有明确归属;漂移必须报人,不许当噪声覆盖
4.2 变更集按风险分级:低风险批量(新增对象/属性/关系/动作/权限、改描述);高风险逐条智兑现出清单每条变更能说出「影响谁」
4.3 dry-run只出「将执行哪些调用」的清单,零副作用智兑现清单能对着表格逐行核,不含「大概」
4.4 你确认唯一人工卡点:低风险批量过,高风险逐条拍你见 6.3 三条拒绝条件
4.5 分段执行字典 → 对象 → 列 → 属性 → 关系 → 动作 → 权限;每段回读,断点能续智兑现每段执行后回读数量对得上,不对就停在这一段
4.6 冒烟测试真跑一次查询 + 核一遍渲染智兑现;你抽看「查得到真数据」才算能用;只点开页面不算
4.7 归档变更报告 + 新基线快照 + 方案版本号写进对象备注智兑现下一个人拿到基线能接着做

6.3 你在 4.4 看什么、怎么拒

看三样:① dry-run 清单是否与变更集数量一致(多了少了都问);② 有没有「漂移」被塞进「我方变更」(别人手工改的东西被当成我们的要改);③ 高危三项有没有混在批量里。

拒绝条件(碰到就停,⛔ 不许「先过了再说」)为什么
删对象对象 id 一变,关系变孤儿、员工订阅失效,且很难复原
改列类型平台建好列后不允许改 SQL 类型,只能研发介入或删列重建
改关系挂钩列等于重建关系,历史数据断链
清单里出现「大概/应该是/需要试一下」说明没做 dry-run,风险不可控

6.4 你手上要交出什么

产出内容要求存哪
变更集与 dry-run 清单逐条变更+风险级别+影响面项目档案
变更报告执行了什么、回读结果、失败与回退记录同上
新基线快照落库后的平台现状(对象/属性/关系/动作/权限计数+清单)同上
冒烟证据一次真实查询的原始结果同上

6.5 智兑现干哪些活(你不用自己干)

  • 三方比对、变更集分级、dry-run 清单生成
  • 分段执行并每段回读,把回读数字与方案逐项对
  • 漂移与冲突的识别与报告(不许自己裁)
  • 冒烟测试执行 + 归档(变更报告、新基线、版本号回写)
边界:它不能自己决定「删不删、改不改类型」;也不能在 4.0 不通时换别的通道硬上——不通就停,报人。

6.6 出关判定(逐条打勾)

☑判定项判定方式
☐4.0 用客户正式授权通道读通看到一次成功读操作的原始返回
☐三方比对完成,漂移已报人比对表三类都有归属
☐dry-run 清单与变更集数量一致两个数字对
☐4.4 变更集已由你逐条确认(留痕)签字或书面确认在档
☐每段执行后回读,计数与方案一致回读记录逐段对
☐冒烟真跑一次查询,拿到真实数据原始返回在档
☐新基线快照与变更报告已归档文件都在,版本号已回写

6.7 新人常犯的三个错

错后果怎么避免
不做 dry-run 直接执行批量建到一半发现列类型错,前面全废,且平台不给回退4.3 必须先出零副作用清单,你核过再执行
把平台漂移当噪声覆盖别人手工改的东西被无声抹掉,出事查不出是谁改的漂移一律报人,由人决定改不改
冒烟只点开页面页面能打开≠能查到数据,客户第一天用就露馅冒烟必须是「一次真实查询 + 一条真实写入」

7 阶段 5 运行 骨架 · 待展开

本段将写:员工真用起来怎么推(上线沟通、试跑期、谁答疑)、采哪些指标、运行报告怎么写、成效不达标怎么办。

实操条款等第一个项目走到运行期再补(现在写会是空模板)

8 阶段 6 沉淀 骨架 · 待展开

本段将写:复盘怎么写(不是总结成绩,是找返工根因)、哪些东西能入库复用、脱敏怎么做、项目怎么关闭或终止。

9 四张表怎么审 已完稿

9.1 这段要解决什么

一句话:让你在 30 分钟内看懂一份建模方案,并说出「哪条不行、为什么不行」——不是重做方案,也不是学平台怎么点。

你要审的四张表 + 字典 + 查询权限:边界对不对、字段有没有人填、关系接得上接不上、动作够不够用、权限漏不漏。
你不用审的平台怎么建、接口怎么调、脚本怎么写——那是智兑现与工具手册的事。
审不过怎么办一次只说三处以内,写清「哪张表哪一行、错在哪、改成什么」;⛔ 不说「整体感觉不对」。
审完留什么一份审查记录(谁审的、哪天、哪几处、改没改);这是你签字的依据。
审的核心只有一句:这个对象/字段/动作,客户那边有没有一个具体的人,在某件具体的事上真的会用它?答不出来就是多余的。

9.2 对象表怎么审(7 处)

看哪里合格长什么样⛔ 不合格(见到就退)
名称业务叫法,客户嘴里就是这么说的(如「源材料」)写表名、写英文(`t_material`)
编码英文小写下划线 + 项目前缀,全局唯一(`fde_customer`)驼峰、中文、无前缀、两个对象撞码
一句话描述说清「这是什么」+「边界在哪」(如:只收已签合作意向的单位)只写「客户信息表」——没有边界就等于没有定义
别名≥3 个真俗称(甲方/单位/客户方)把对象名本身当别名;编几个没人说的词
典型问句2–3 条客户真会问的话(「我们现在在服务哪几家?」)写成功能名(「查询客户列表」)——那是菜单不是问句
主键无表模式用 `id`;业务唯一键另设列(如 `customer_code`)拿业务编码顶主键
三问每个对象答得出:谁问/谁写/参与什么判断答不出「谁写」=这对象没人维护,建出来是空表
别把平台自带的东西写进方案:`id / tenant_id / creator / create_time / updater / update_time / deleted` 平台自动生成,⛔ 不要出现在属性表里——出现了说明这份方案是「照着数据库抄的」,不是照业务画的。

9.3 属性表怎么审(6 处)

看哪里合格长什么样⛔ 不合格
类型只用 9 个平台原值逐字照抄(字符串 varchar / 长文本 text / 整数 bigint / 小数 numeric / 日期 date / 日期时间 timestamp / 枚举 varchar / 是-否 boolean / 文档 bigint)「字符串(50)」「text/varchar」这类自造写法;类型空着
必填只有业务上真不能空的才标是一列全标必填——那是把自己锁死,写入一路被拦
密级按字段定,不按对象定:同一对象可以混级(退出门槛达成=公开,退回差距=机密)整个对象一刀切「机密」;或该机密的姓名手机号写成公开
描述意义+可否为空+格式+范围+容易用错的点(如「改这里只改快照,不影响组织中心」)只写中文名;坑留到别处
枚举字典值段英文小写 snake(`in_progress`),中文只做标签;同时给 code 与中文 name值段写「进行中」;只给值不给名
布尔只用于「不给动作写」的场景;要能写就换文本或枚举方案里让动作去写布尔列 —— 平台会整条事务回滚(见 9.7)

另外两处新手常漏:① 前 4 个属性排最前(AI 索引只显示前 4 个),把最能说明这个对象是什么的放前面;② 多值/列表/JSON 一律长文本存,要能查就拆子表。

9.4 关系表怎么审(5 处)

看哪里合格长什么样⛔ 不合格
方向 + 基数都写死:单向/双向、1:N / N:1 / 1:1 / N:N留空或写「看情况」
挂钩列只能单列:多侧存外键、一测存主键写「A+B」组合列;一列挂两条关系
反向关系名双向的必须给英文 snake 名双向却不给反向名——查回来找不到路
N:N给出中间表名 + 两列名说「平台会自己建」但不说建什么
同名关系都叫「属于」的必须有不同编码两条关系同名同码,平台分不清

9.5 动作表怎么审(先看够不够,再看对不对)

第一步:每个对象过四格,缺一格就是缺陷。

四格含义缺了会怎样
①创建一条新记录怎么进来只能手工录,数字员工写不进去
②改关键字段业务上会变的那几个字段怎么改建完只能看不能改,客户第一天就问「怎么改不了」
③状态流转进入 + 离开,双向可达只进不出=死胡同(暂停了不能恢复,这坑我们踩过)
④作废/关闭业务结束后怎么收尾数据只增不减,报表永远不干净

第二步:逐个动作看五个必填。

  • 大白话描述:什么情况下用(带口语例子)+边界注意——这是 AI 判断该不该触发的唯一依据,写「更新客户」等于没写。
  • 参数:名英文小写下划线、类型只有文本/日期/数字三选、必填要克制、「数据归属人」每动作最多一个且必须指向对象上真实存在的人员列。
  • 授权三样都要配:角色 + 人员 + 数字员工。只配一样,调用会被拒(`授权未命中`)。
  • 审批:高危动作必须写审批人(角色或人名),超时 24 小时取消;⛔ 只写审批人不写多级流程。
  • 执行逻辑:优先配置式规则(字段 ← 参数),规则表达不了才用脚本;脚本要写清「按什么定位记录」。

9.6 查询权限表怎么审(这张最容易漏,一漏就全表可见)

看哪里合格⛔ 不合格
组合模式要做数据隔离必须是「或」「且」——且模式下「在完全查看角色里=全量」,中间态不存在,永远做不到「只看自己的」
①完全查看角色写角色名写人名;把需要隔离的角色留在这里
②归属字段 + 可见身份归属字段是对象上真实存在的人员列;身份=自己/直接上级归属字段指向一个不存在的列,或存的是用户编号而平台按姓名匹配
③指定记录只用于特例,写清哪条给谁拿它当常规隔离手段
做隔离三件事必须一起改:把角色从①移出、模式改成「或」、②配好归属字段。只改一样等于没改——平台曾"调整了配置"却只动了归属字段,单子因此长期判「不修」。

9.7 审完怎么留痕,以及三条一票否决

一票否决(见到直接退,不用往下审)为什么
方案里有动作要写布尔列平台写布尔会整条事务回滚,且页面不报错——建完「看着成功、库里没变」
关系挂钩列写成「A+B」或一列挂两条关系外键冲突,平台只允许单列;改起来要重建关系
权限表缺②(只有①角色)建完谁都能看全表;后面补要动数据权限配置,客户已经在用的数据会突然看不见

审查记录怎么写:一张表,四列——「表名/行(对象编码+列名)|问题|改成什么|改没改」。一次不超过三处,写完发智兑现改;改完它要逐处回读给你看,⛔ 不接受「都改好了」。

合格审查记录长这样
✅ 「fde_phase · exit_met 列:类型是 boolean 且动作「推进到下一阶段」要写它 ⇒ 改成 varchar(8),取值 yes/no;已改,回读类型=varchar」
⛔ 「属性表有点问题,你再看看」

9.8 新人审方案常犯的三个错

错后果怎么避免
只审对象名,不审「谁写」字段建出来没人填,运行期全是空列,客户说「这系统没用」每个对象问一句「这个字段实际谁填」,答不出就砍掉或补流程
把「动作很多」当成「完备」建了 8 个动作却没有「离开」的路,状态进得去出不来按四格过一遍,别数个数
权限表空着先上线全表可见,客户内部数据串门,事后补要动权限配置权限表和另外三张表同权重审,缺②直接退

10 客户沟通:话术与禁区 已完稿

10.1 这段要解决什么

一句话:把已经定下来的口径,用客户听得懂、不紧张、能点头的话说出来。这一章不讲新东西,只把散在各章的话术按场景集中,附上每个场景的三句禁说。

三条通用原则:① 一次只说一件事,说完等答复;② 说事实带出处,说推断带「我猜」;③ 客户给不出答案时,给两条路让他选,⛔ 不逼他当场拍。

10.2 第一次见面

「我们今天不谈方案。就想请您说说,今年最想让哪件活轻松一点——是活太多人不够,还是数据散在各处、汇总太费劲?」
「这件事最后是谁定?我们后面做的每一步都要给他看,别到时候白做。」
⛔ 别说的三句为什么
「我们 AI 什么都能做」这个阶段你没资格判断;说出去就是承诺
「这个很简单,一个月就能上线」周期靠后面数据可得性定,早说就是给自己上绳
「行业上一般都这么做」客户只认自己的活,套模板会被当场顶回来

10.3 要资料

「我们要五样东西:主责主业怎么干、部门岗位和各自管什么、一条事从接到到办完经过谁、平时用的表单台账、这些数据在哪能不能导。哪样现在能给,哪样要走流程?」
「这几份我只看事实,不看制度怎么写。制度我另外看,用来对规矩。」
「这个材料能不能给复印件、把客户名字遮掉?我们只要格式和字段,不要人家隐私。」
⛔ 别说的三句为什么
「你先随便给几份我看看」拿不到全貌就开始建模,后面全返工
「资料不给也能做」能做的只有空壳,客户会拿这句话反问你
「我上你们系统里自己导」越权;且数据怎么取要客户 IT 定流程

10.4 口径不一致

「您说 47 人,名册上是 43 人。这不是要挑错——我要写进模型里的人数是哪个,另一个是什么口径?」
「这条口径我记成『待确认』,标明卡在人事那边。等有答复我们再定这块做不做。」
⛔ 别说的三句为什么
「那按您说的写吧」口径错→对象错→动作错,逐层放大
「这个小差异不影响」你说的不算,客户考核时它就会冒出来
「你们内部先统一了再找我」客户内部统一不了才是常态,你得帮他挑一个口径

10.5 进度慢 / 客户拖着

「这件事现在卡在信息中心能不能导数据。我们在系统里登记成『外部依赖』,写清谁给、什么时候给——这样它对您也是个看得见的待办,不用您记。」
「这个项目先放到几月?放到那时候我们重启,还是等信息中心有答复就重启——您定一个,我登记下来。」
⛔ 别说的三句为什么
「那先等着吧」没有登记=僵尸项目,考核时说不清
「你们再不配合就做不成了」把压力推给客户,关系就断了
「我这边先做着,你们慢慢来」没料的活做出来必返工,还显得你不专业

10.6 客户要加需求

「这个能加。但它属于第 2 段之后的变更,会动到已经确认的对象和动作——我出一条变更单,写清影响哪几块、要多久,您签字了我们再动。」
「这条我先记进需求条目,标『待评估』。今天不承诺时间,评估完给您一个数。」
⛔ 别说的三句为什么
「顺手就加了」一个顺手,后面一串连带改动,最后你背锅
「这个做不了」没评估就说不了,等于拒生意
「加了要加钱」商务口径轮不到你谈,应交回销售

10.7 上线阻力(员工不用)

「不用它,多半是因为它出的东西还要您改一遍。您告诉我哪一步最费劲,我改那一步,不改整套。」
「这一周先只让它在星期五出初稿,您照旧自己写,出完您比一比——不满意我们就停。」
⛔ 别说的三句为什么
「这是领导定的必须用」用权力压出来的使用数据是假的,运行报告全废
「用熟了就好了」把问题推给用户,等于承认它不好用
「AI 就是这样,会越来越准」空话,且把责任推给未来

10.8 验收签字

「咱们按当初定的那三条对:周报每周五 18:00 前出初稿、人工修改不超过 3 条、连续 4 周达标。这三条数据我都带来了,您过一遍。」
「有一条没达标的,我写清原因和补齐时间,不糊过去——这条不签我没话说。」
⛔ 别说的三句为什么
「大概都达到了」验收要的是数字不是感觉,客户一句「哪个数」你就哑
「这个指标当时没定清」说明第 2 段白做了,责任在你不在客户
「先签了,剩下我们慢慢补」签完就没人补了,交付尾巴永远拖着

10.9 一句话总纲

对客户永远只有三种话:① 事实——带出处(「名册上是 43 人」);② 选择——给两条路让他挑(「放到三月,还是信息中心有答复就重启」);③ 承诺——只在你有证据时给(「机检 0 ERROR,报告在这里」)。
⛔ 第四种话不要说:猜测(「应该是」「一般都能」「问题不大」)。

11 红线(碰到就是事故)

红线为什么
客户没确认的方案不进客户平台草稿进生产环境,撤不干净,信任一次就没了
不替客户拍业务板(口径、优先级、谁负责)你拍错了,责任在你;客户内部的事归客户
不在方案里写无出处的数字一个假数字被客户抓住,整份方案都不可信
不删客户平台对象、不改列类型、不改关系挂钩列静默丢关系与订阅、历史断链,且平台不支持回退
不承诺没验过的效果(「AI 都能做」「一周上线」)阶段没到,你没资格判断;承诺变成合同义务
账号密码/token 不写进任何文档、不发群泄密+客户追责

12 术语表 已完稿

12.1 怎么用这张表

两列都要会:自己人怎么说(准确)和对客户怎么说(大白话)。⛔ 对客户不说左列的黑话——客户听不懂不是他的问题,是你的问题。

12.2 术语

术语自己人怎么说(准确)对客户怎么说(大白话)
FDE前沿部署工程师,驻客户现场把 AI 落成能用的东西我们这种人:既懂你们业务、又懂怎么让 AI 干活
数字员工承担一段具体业务、能被调用与追责的 AI 岗位实例一个新同事,专干某一段活,干完有记录
本体这个单位业务的结构化描述:有哪些东西、它们什么关系、能做什么操作把你们业务画成一张图,AI 靠它才看得懂你们在干什么
对象业务上的一类实体(客户、项目、材料)你们业务里的一种「东西」,比如客户、项目、材料
属性对象上的一列事实(客户名称、合作状态)这种「东西」有哪些信息,比如名字、状态、对接人
关系两个对象之间的挂接与基数(一个客户有多个项目)这些东西之间怎么连着,比如一个客户下有几个项目
动作对对象的一次可执行操作(登记、推进、终止)能对这种「东西」做什么,比如新建、改状态、作废
字典枚举值的编码与标签对照(`in_progress=进行中`)状态就那么几种写法,统一一下,别一人一个叫法
查询权限谁能看哪些行/哪些字段的规则(三层+组合模式)谁能看哪些数据,比如部门只能看自己部门的
工作项数字员工名下一条可调用的固定流程(平台旧称「职责」)这个新同事负责的一件固定的事
L1–L4数据可得性四级:接口直读/导出文件/人工补录/数据不存在这数据现在能不能拿到——能直接连、能导出、只能人填、还是根本没有
六段法组织诊断→业务规划→本体建模→平台落地→运行→沉淀我们干这活的六个阶段,一步不跳
门禁阶段能不能往下走的条件(不是开会评审)这一步的活干完了没有,干完才往下走
结果契约客户书面确认的成效衡量口径,含可量化指标与数据来源咱们先说好「怎么算成了」,白纸黑字
变更集一批要进平台的改动,按风险分级这次要改的东西的清单,风险高的我单独列给您看
dry-run只出「将执行哪些调用」的清单,零副作用先不动手,把要做的事列一遍给您核
冒烟测试建完跑一次真实查询+写入,证明「能用」建完真跑一遍,确认能查出数来,不是光建好了
漂移平台现状与方案/基线不一致,且不是我方改的平台上有别人改过的东西,我先报给您,不自己动
机检按固定规则(T1–T14)对方案做的自检,要求 0 ERROR用一套规矩把方案自己查一遍,查出问题先改完再给您看
止损同一处修两次失败就回退重建,不继续打补丁这条修两回还不行,我就不硬修了,退回去重做

12.3 三组最容易混的词

别混一句话分清
工作项 vs 技能工作项=一条固定流程(入参出参固定、能一次做完);技能=一种能力(换个场景也能用)
依赖 vs 问题依赖=外面的人还没给我们东西;问题=已经发生、要处置的状况
两套本体FDE 项目管理本体=我们自己管项目用;客户业务本体=客户自己业务的对象,别混着装

13 未定项清单 ⏳

#未定项卡在什么谁定
1阶段 5–6 实操条款还没项目走到运行/沉淀期,现在写=空模板跟项目走,走到就补
245 个本体动作的说明等建模方案 V5.0 定稿,动作清单可能变家辉出 V5.0
3编制方案/结果契约模板等真实客户样本(NFXH 为候选)项目走到阶段 2
4客户交付版手册本手册是内部新人版,客户版另做(口径不同、要去商业信息)第一个正式客户交付时
5时长与人力估算表样本不足,现在估=编攒够 3 个项目数据后
凡本手册里出现 ⏳待定 的地方,都是上表某项。⛔ 不许为了让手册「完整」而临时编一套填上。

14 待办总表

✅ 现在能做

项说明状态
本手册目录+第 3 章样章本文件已完成(待你点头)
第 1、2 章(开工前四件事 / 六段与格)已同步写出,等样章确认后一并定稿已出草
第 4 章 阶段 2 业务规划已按第 3 章模板铺全(七小节)v0.2 已完稿
第 5 章 阶段 3 本体建模七小节铺全(不重复工具手册的操作步骤,只写判断与签字)v0.3 已完稿
第 6 章 阶段 4 平台落地七步 + 4.4 卡点写死;接口细节待平台出标准接口v0.3 部分待定
其余各段展开(第 7–9 章)按同一模板铺排队中
第 9 章 四张表怎么审四张表 + 权限表逐处审法、一票否决、审查记录v0.4 已完稿
第 10 章 客户话术 / 第 12 章 术语表话术按 7 个场景汇总;术语 20 条含「对客户怎么说」v0.5 已完稿

⏸ 等条件

项卡在什么
动作说明、编制模板、运行/沉淀实操条款见第 13 章未定项清单
客户交付版手册首个正式客户交付时

🐞 平台侧(不在本手册范围)

禅道问题单由对接人跟踪,手册不列。

附录 A · 智兑现技能触发口语示例 2026-11-04 实测

数据来源:在交互工作台让它现场 skills_list 查的 22 条(不是凭记忆),名字与描述原文逐字取回。

⚠️ 现状已变:22 条已合并为 19 条(2026-11-04 12:19)。下面的 A.3 / A.5 保留 22 条原始数据(作为改前留档),现行体系看 A.6:三处合并、两处删重复段、19 条清单、合并后回归结果。

A.1 它是怎么被触发的(一句话)

每次回话前,它上下文里常驻的只是技能索引——每条技能只有 名字 + 描述(描述超 60 字符会被截断)两行;它按语义判断这句话该不该加载某条技能,加载了才读全文。所以触发靠"描述长得像你说的话",不靠关键词匹配。

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-lintT1–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低(场景差异明显)暂不动
⛔ 别靠增加技能解决撞车。22 条已经有 5 组重叠,再加技能只会把一件事分散到更多地方。正解是压窄描述、写清边界。
关于「Use when」——不是机制要求:技能描述的唯一消费者是模型的路由判断,它认的是「这是触发条件」还是「这是功能定义」,不认某个固定英文词。现有 13 条用 Use when … 是早期照搬英文模板;中文描述里它占 7 个字符(57 字符预算的 12%),换不来任何额外命中。⇒ 统一规则改为:首句必须是触发条件(「…时用」),触发词放最前,末尾带一句边界;不强制 Use when。

A.5 22 条描述终稿(触发前置+撞车互斥)

按 A.4 的撞车诊断,把「边界/该转哪条」直接写进描述——能提前规避的都在描述里规避,不指望模型自己猜。全部 ≤50 字符(平台限 60,留余量给截断)。这批文本由智兑现自己改,改完回读 description 原文核对。

#技能现在的描述改成(触发前置+互斥)
1fde-business-mappingUse when 从台账/访谈推出该建哪些对象、属性、归属。别名:业务映射判据 A1。从台账/表单推该建哪些对象、属性、归属时用;只整理需求→需求结构化,只判可信→资料取证。
2fde-requirement-structuringUse when 收到现场资料、访谈记录、客户表单、业务口述,需要整理成需求条目。别名:B1-需求结构化。把资料/访谈/表单整理成需求条目时用;要推对象属性→业务映射。
3fde-source-evidenceUse when 收到现场资料要整理成结构化内容、或判断某条信息能不能当事实写进交付物。别名:A2-资料接入与取证纪律。判断某条信息能否当事实写进交付物、资料可信度时用;要出条目→需求结构化。
4fde-caliber-confirmationUse when 要为某个模糊口径向客户确认、或要写确认清单交给 FDE 去问。别名:C3-口径确认话术。要问客户模糊业务口径、写确认清单时用。
5fde-dependency-analysisUse when 要判断某个数据能不能拿到、需要客户给什么授权、拿不到怎么办。别名:C2-外部依赖与制约分析。判断数据能不能拿到、要客户给什么授权时用。
6fde-org-diagnosis组织诊断:判定建模准入、理组织与岗位、出数字员工清单摸清客户组织/岗位/流程、判能否开工建模时用。
7fde-capability-attribution当需要判断某个功能或数据该放到本体、流程、技能、职责还是界面哪一层时使用。别名:B3-能力归属判据。判断某事该放本体/工作流/技能/界面哪层时用。
8fde-ontology-modeling本体建模标准与自检:按平台配置项产出对象/属性/关系/动作并逐条自检出对象/属性/关系/动作四表建模方案并按规范自检时用。
9fde-ontology-lint建模清单自机检:跑 T1–T13 判据,非 0 ERROR 不许交付建模方案跑 T1–T13 机检看是否 0 ERROR 时用;交付前总检→checklist。
10fde-ontology-checklist建模清单交付前必跑的 42 条自检(含 ERROR 级汇总)建模产出后、交付前跑 42 条总检汇总 ERROR 时用;机检→lint。
11fde-platform-connect接客户本体平台:账号登录取 token、验权限、失败排查要连客户本体平台验权限、或连接鉴权失败排查时用。
12fde-platform-snapshot拉平台现状快照:对象/属性/关系/动作/字典全量归一化存档拉客户平台现状快照存档时用;要与方案对比→平台比对。
13fde-platform-diff方案与平台现状三方比对:出变更集、辨平台漂移与冲突把方案与平台现状比对、出变更集、识漂移时用。
14fde-platform-apply按确认变更集执行建模:dry-run、断点续做、变更日志与回滚计划变更集已确认、要执行落地并回读时用;还没比对→先平台比对。
15fde-phase-gateUse when 判断FDE项目处于哪个阶段、该产出什么、能否进入下一阶段。别名:C1-六段法与阶段门禁。判断项目在第几段、能否出关进下一段时用;问下一步做什么→导航。
16fde-project-navigatorUse when FDE 接新项目或问下一步干什么。陪跑导航:一格一格推。别名:项目运营导航 A2。接新项目或问下一步该干什么时用(一次只推一格);能否过阶段→门禁。
17fde-deliverable-reportUse when 产出分析报告、建模文档、清单或汇报材料,需要定结构和话术。别名:B4-交付物结构与汇报。要出文档型报告/汇报材料、定结构与话术时用;发网页→网页手册。
18fde-html-manual-deliveryUse when 生成 HTML 手册/速查交付物并发布到 fileport,数据取自落库清单时。把手册/清单做成网页并发布链接时用;只写文档→交付物规范。
19fde-versioned-doc-releaseUse when 发布版本化建模清单(md+xlsx)到交付目录,先三项数字自证后发布。发布版本化清单 md+xlsx 到交付目录、先三项自证时用。
20智能体-skill-maintenanceUse when 更新或新建技能(skill_manage 被拒、改自家技能超限、回读校验)时。别名:技能库维护。要新建或改它自己的技能(被拒、超限、回读校验)时用。
21remote-shell-tasksUse when 需要在远程服务器跑 SSH 命令(勘察、同步、运维),尤其当前会话无终端工具时。要在远程服务器跑 SSH 命令时用。
22workbench-deliveryUse when delivering files or sending proactive messages.要发文件或主动发消息时用。
已执行(2026-11-04 11:11–11:17):22 条 description 全部按上表改完,全量 skills_list 回读与终稿逐条一致。随后跑路由首测:已跑 12 条、12 条与期望一致(A 组 8/8 命中;跨段只推一格;闲聊不加载 FDE 技能;无邮件通道时拒答不硬做)。记录见 智兑现_路由测试结果_20261104.md。
跑法坑(已踩):① 单脚本一次跑 8 句会超时 ⇒ 一次最多 3 句;② 超时后旧脚本仍在发消息,与新脚本并发 ⇒ 同一句发两次、回复错位,本轮 B2/B3 因此作废;③ 平台思考态措辞不固定(思考中/推理进行中/分析进行中),按词判「答完」会误判 ⇒ 用「尾部内容变化 + ⏱」判定。

A.6 现行体系:19 条(22→19 合并结果,2026-11-04)

合并判据(三条缺一就不该独立存在):① 有独立触发语义位(真人会说一句只指向它的话)② 有独立实质判据(≥1500 字符的判断规则,不是清单摘要)③ 有独立交接点(上一步交什么、产出什么、交给谁)。

三处合并 + 两处删重复段

#动作为什么结果(回读实测)
1ontology-checklist → ontology-lint被并技能整条只有 1 节「交付前自检清单」,没有独立触发位;同一件事两套编号(13 条 vs 42 条)lint 正文 3360 → 5337,新节「交付前总检(42 条)」42 行连续无缺
2phase-gate → project-navigator六段模型写了两遍;两条都产出「现状/下一步」格式navigator 正文 1488 → 3748,新节「阶段与门禁」8 个小节
3versioned-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
段 5 运行 / 段 6 沉淀仍 0 条:这两段主体是人(排期、催数据、组织验收、复盘入库),⛔ 不建数字员工技能——沿用 D-20261103-01 §十六 的执行主体分类。

合并后回归(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 处磁盘残留。

对新人的用法没变:A.3 那些口语示例仍然照说;只是「会不会命中已删技能」这件事不用你操心——19 条里没有旧名,命中只会落到现存技能上。

FDE 项目全流程操作手册 v0.5 · 2026-11-04(基线:v0.4)| 真源:FDE项目全流程架构_V1.0_20261102.md