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

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

本版=完整目录 + 第 3 章样章(阶段 1 组织诊断)。样章用于确认写法与颗粒度,点头后再铺全其余各段。

六段法四人工介入点格=一个可交付动作未定标 ⏳待定

本版怎么读

手册写「人做什么」每段只讲你这个真人要做的动作、要交的东西、怎么判断过关。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 业务规划 骨架 · 待展开

本段将写:2.1 业务分析(现状→痛点→目标→场景→价值)、2.2 场景与编制(做哪几个数字员工、每个管哪段)、2.3 结果契约(可验收的承诺,含 3 个量化指标)。

编制方案与结果契约的模板形态,等真实客户走到本段再定(NFXH 项目可作首个样本)

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

14 待办总表

✅ 现在能做

项说明状态
本手册目录+第 3 章样章本文件已完成(待你点头)
第 1、2 章(开工前四件事 / 六段与格)已同步写出,等样章确认后一并定稿已出草
其余各段展开(4–9 章)按第 3 章同一模板铺等样章点头
第 10 章话术、11 章红线、12 章术语表不依赖外部条件排队中

⏸ 等条件

项卡在什么
动作说明、编制模板、运行/沉淀实操条款见第 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.1(目录+样章+附录 A)· 2026-11-03/04 | 真源:FDE项目全流程架构_V1.0_20261102.md + 智兑现 skills_list 实测 22 条