FDE 本体建模操作手册 v1.2

写给 FDE 同事:从接客户到把本体建进平台、交出去、能回滚,全流程一件事一张表。
数据口径与 建模方案 V5.0 一致:14 对象 / 105 属性 / 21 关系 / 45 动作 / 22 字典 / 14 权限。门禁评审已取消,阶段出关改用 exit_met / exit_gap。

适配 FDE 项目管理本体 V5.0机检 T1–T14(含双向判定)技能 17 个四项数字比对版本号三段式

0 三分钟速览

六段全景

① 组织诊断理组织与岗位
→
② 业务规划出建模方案
→
③ 数字员工构建按方案建本体
→
④ 上岗冒烟+交付
→
⑤ 全面运行盯成效
→
⑥ 沉淀口径与资产入库

每段做完有出关检查:对照 entry_gate(退出门槛)逐条核对,达成情况写 exit_met(是/否),没达成的差距写 exit_gap(AI 对照 entry_gate 逐条推导、标注来源,机密级)。门禁评审会已取消——出关靠证据不靠开会。

谁干什么

角色干什么
FDE(你)收资料→整理需求→出方案→跑机检→落平台→写变更记录
数字员工(智兑现)登记/查询/推进等日常动作的执行者;exit_gap 由它推导初稿
部门领导审推进阶段(advance_phase)、方案确认、高危动作
老板/真人复核只看四块:新增对象、权限表、机检 ERROR/WARN、变更清单

最容易踩的坑

三个高频事故:① 表格改了正文没改(14 对象改了,正文还写 16)→ 交付前跑四项数字比对;② 草稿直接叫正式版本号 → 未验收带 -draft;③ 验证 A 文件发 B 文件 → 只对「即将发布的那一个文件」做比对。

1 怎么开始

五类输入准入(缺一不开工)

输入从哪来缺了会怎样
业务全貌(靠什么赚钱、价值链)访谈 + 业务分析对象边界全错
组织与岗位责权组织诊断答不出「谁问/谁写」
业务流程(端到端)组织诊断 + 访谈动作只能编
业务对象与术语台账/表单/系统截图属性全靠猜
数据可得性依赖分析建出来是空表

资料可信度排序

台账/表单/截图 > 访谈记录 > 制度文件 > 行业通识。只有前两类能支撑属性和动作;制度文件只覆盖「规则」,不能当业务全貌。

数据可得性 L1–L4

级别含义结论
L1接口直读能做
L2导出文件能做(半自动)
L3人工补录慎做
L4数据不存在不能做

2 六段流程(每段:它做 / 你做 / 产出 / 出关)

2.1 组织诊断

它做你做产出出关(entry_gate→exit)
查部门/人员/角色组织诊断、定准入组织与岗位清单五类输入齐→exit_met 写是

2.2 业务规划

它做你做产出出关
查口径库/依赖整理需求、出建模方案(draft_plan)需求条目+方案版本方案 confirm→exit_gap 记差距

2.3 本体建模(数字员工构建)

它做你做产出出关
登记岗位/提议工作项建对象/属性/关系/动作、跑机检建模清单+机检报告ERROR=0 且四项比对过

2.4 平台落地(上岗)

它做你做产出出关
launch_employee 上架平台落地、冒烟、register_deliverable可用数字员工+交付物冒烟通过→mark_plan_applied

2.5 运行(全面运行)

它做你做产出出关
跑工作项、record_roi_metric盯成效、处理 issue/dependency成效数据指标达标→出关

2.6 沉淀

它做你做产出出关
查历史口径口径入库、close_project 或 terminate_project资产复用包资产入库→关项目/终止
V5.0 变化:阶段被卡用 block_phase,恢复用 unblock_phase;项目暂停 pause_project 后用 resume_project 恢复(旧版暂停了出不来,已修);确认不做用 terminate_project(状态 aborted=不做了)。

3 常用话术(照着说)

场景照着说
客户答复口径「陈工,客户王经理说报表口径按自然月」→ register_caliber_result
材料可信「这份台账出处核过了,可以引」→ mark_evidence_verified
材料不可信「这份口头数字跟台账对不上,不采信」→ reject_evidence
提出需求「客户要周报自动发」→ raise_requirement
需求重复「REQ-003 和 REQ-007 都是说导出报表」→ merge_requirement
登记卡点「要客户开 CRM 接口,登记卡点」→ raise_dependency
卡点解除「客户把接口开通了」→ resolve_dependency
登记问题「数据接口要 3 周才能给,风险」→ raise_issue
项目暂停「客户预算调整,项目暂停」→ pause_project
项目复工「预算批了,项目复工」→ resume_project
项目终止「客户砍了预算,项目终止」→ terminate_project(aborted)
阶段出关「阶段2 退出门槛达成,推进到阶段3」→ advance_phase(一并落 exit_met/exit_gap)
数字员工退役「客户项目结束,舆情秘书退役」→ retire_employee
依赖 vs 问题,只登记一处:依赖=外部方应给而未给(等客户接口);问题=已发生的状况(接口调试发现 bug)。

4 四张表怎么看

对象表(14 个)

每个对象答得出「谁问/谁写/参与什么判断」,编码=英文小写下划线+项目前缀,别名 ≥3 个真俗称(对象名本身不算别名)。V5.0 共 14 个:客户、交付项目、阶段、数字员工岗位、需求条目、源材料、口径确认、外部依赖、交付物、ROI 记录、问题与风险、方案版本、平台变更记录、工作项。

属性表(105 条)

  • 类型只用 9 种原值逐字照抄;长度/精度必填
  • 密级按字段内容定,不按对象:同一对象可混级(exit_met 公开、exit_gap 机密)
  • 字典值段一律英文小写 snake(level1~level4,不是 L1~L4)
  • 状态类枚举每个值写清到达路径(动作可置/默认值/仅后台人工改)

关系表(21 条)

  • 挂钩列只能单列,⛔ 别写 A+B;一列只能挂一条关系(挂两个目标建两列,如口径的 mount_requirement_code / mount_project_code)
  • 方向+基数必填;双向必须有反向关系名;N:N 给中间表名与两列名

动作表(45 个)与动作完备性

每个对象过四格:①创建 ②改关键字段 ③状态流转(进+出双向可达)④作废/关闭。终态清单:ended/closed/aborted/retired/dropped/resolved/rejected/deployed/applied/superseded/merged。

只进不出=死胡同:旧版 paused 能暂停不能恢复,被双向判定抓出后补了 resume_project。

查询权限表(14 行)

做隔离三件事一起改:角色移出①、模式改「或」、②配归属字段(必须是对象真实人员列)。不写这层建完谁都能看全表。

5 机检与验收

三层分工

层谁干什么
机检脚本(T1–T14)格式与完备性,ERROR=0 才许交付
自检FDE 本人42 条业务自检(fde-ontology-checklist),任一条未过不得交付
真人复核家辉/老板只看四块,不逐行

ERROR 三分类

A 可自修类型/格式类,改完重跑 | B 待决策权限/口径类,报人挂起,⛔ 不许编值凑合 | C 缺信息客户资料缺,停,报「缺什么去哪拿」。

真人只看四块

① 新增对象 ② 权限设计表 ③ 机检 ERROR/WARN ④ 变更清单。变更差值必须代码 diff,⛔ 手算。

T1–T14 规则

规则查什么级别
T1属性类型在 9 原值内ERROR
T2/T3挂钩列单列且真实;关系编码唯一ERROR
T4参数类型合法;归属人参数指向真实列;owner 档必须有归属人参数(双向判定)ERROR
T5/T6枚举绑字典;密级三档内ERROR
T7/T8别名≥3 真俗称;长度/精度WARN
T9/T10双向有反向名;fixed 写明审批人ERROR
T11/T12文档属性开挂载;字典值段 snakeERROR
T13每对象有查询权限ERROR
T14四格完备 + 状态双向可达(能进也要能出,终态豁免)ERROR

交付件与审阅件分开

审阅件(md/HTML):含沿革、典型问句、变更清单。交付件(xlsx):只含平台真字段,⛔ 混进「沿革」列会被当成要建的字段。

交付前四项比对

① 章节标题数 ② 表格实数(代码数)③ 机检 COUNT ④ 正文段落里的规模数字——四者全等才许发布。附加:标题=版本行、基线指向上一版、被删对象/动作全文出现 0 次。⛔ 不许用「我验证过」代替「我比对过这个文件」。

6 平台落地

七步

1 接入登录验权
→
2 快照拉现状
→
3 比对方案vs现状
→
4 变更集出清单
→
5 dry-run先演练
→
6 执行分段落库
→
7 留痕JSONL 日志

执行顺序固定:字典→对象→属性→关系→动作→权限;关系必须等源/目标对象都建完(平台约束);每段完成即回读。

三方比对

方案 vs 平台现状:平台有方案无 → 标「来源不明」⛔ 不进变更集,先报人。⛔ 不许从平台反导当方案。

回滚能力

每次写操作登记 fde_platform_change:payload 可重放、rollback_way(revert/delete/disable/migrate/irreversible)。irreversible 须 FDE 书面确认。每条写操作落 JSONL 日志(只增不删)。

7 红线(碰到就是事故)

1 token 不落盘、不打印、不写文档
2 未确认方案 ⛔ 进客户平台
3 平台变更不登记就执行
4 机检 ERROR≠0 就说「可交付」
5 未验收的文件占正式版本号
6 覆盖同名交付文件
7 推断值录进 ROI(只录实测)
8 从平台反导当方案
9 交付件混进「沿革/典型问句」验收列
10 用「我验证过」代替「我比对过这个文件」

8 真实案例(都真发生过)

#事故怎么发现改成什么规矩
1别名凑数:「方案版本」「工作项」把对象名本身当别名家辉复跑机检抓出T7 判定排除对象名本身;别名必须是员工口头真俗称
2属性新增数手算 18,实际 36家辉代码 diff 对出变更差值必须代码 diff,⛔ 手算
3会话自报 WARN 4,文档写 WARN 0家辉比对文档与自报机检结论一致性:文档数字必须与代码输出逐字一致
45 个对象一个动作都没有(零动作对象)家辉复查设计B2 补「动作完备性」四格;T14 落地
5属性描述写了动作名,动作表里没这个动作机检 blocked/dropped 字面 0 次描述提到的动作必须在动作表存在,否则 ERROR
6xlsx 交付件混进「沿革」列(删列按索引删错)回读生成日志发现删列按列名不按索引;交付件只含平台真字段
7验证的是 14 对象的数据,发布的是 16 对象的旧文件家辉复跑对不上四项数字比对:只对「即将发布的那一个文件」做比对
8表格改成 14,正文还写 16 对象/115 属性家辉看叙述层矛盾四项比对第 4 项:正文规模数字正则扫全文逐个比对
9paused 能暂停不能恢复(状态死胡同)T14 双向判定设计时复盘T14 出向可达:非终态必须有离开动作;补 resume_project

9 技能清单(17 个,按六段归类)

阶段技能一句话作用
第1段 组织诊断fde-org-diagnosis组织诊断准入:判这个客户能不能建模、理组织与岗位
fde-source-evidence资料取证:客户给的材料怎么分级、什么能当事实写进交付物
fde-dependency-analysis外部依赖:判断数据拿不拿得到、要客户给什么授权
第2段 业务规划fde-requirement-structuring需求结构化:把现场资料/访谈口述整理成需求条目
fde-caliber-confirmation口径确认:模糊口径向客户确认的话术与登记
第3段 本体建模fde-capability-attribution能力归属判断:一个功能该放本体/流程/技能/职责/界面哪层
fde-ontology-modeling本体建模主标准:对象/属性/关系/动作怎么设计
fde-ontology-lint机检 T1–T14:交付前自动校验,ERROR=0 才许出
fde-ontology-checklist42 条自检清单:业务正确性逐条过,任一未过不得交付
第4段 平台落地fde-platform-connect接入验权:登客户本体平台拿 token、验权限
fde-platform-snapshot现状快照:拉平台已有对象全量存档,只增不删
fde-platform-diff三方比对:方案 vs 平台现状出变更集,反导⛔
fde-platform-apply变更执行:dry-run 先行、分段落库、JSONL 留痕可回滚
通用fde-phase-gate六段门禁判断:项目在哪个阶段、该产出什么、能否进下一段
fde-deliverable-report交付物与汇报:结构、话术、四项比对、版本命名
通道remote-shell-tasks远程执行通道:需要远程跑命令时用
workbench-delivery交付与消息通道:发文件、发通知
每个技能字符数上限 6388(平台实测单技能容量),超了必须拆——本体建模主标准就是把 42 条自检拆成 fde-ontology-checklist 才腾出空间的。

10 术语表

术语意思
本体/对象组织里一类被记录被询问的事物(≈表)
属性对象的信息字段(≈列)
关系对象间连接(≈外键),必须单列挂钩
动作对对象可执行的操作(≈函数),须过四格
entry_gate / exit_met / exit_gap退出门槛 / 是否达成 / 差距明细(机密)
机检 T1–T14交付前自动校验规则,ERROR=0 才许交付
归属套管理本体(我们平台)vs 客户业务本体(客户平台)
source_tag对象溯源标记:哪个方案版本哪天谁建的
dry-run平台写操作先演练不落库
四项比对标题数=表实数=机检 COUNT=正文数字,全等才发布
版本三段式结构性变更升主版本;内容修正升次版本;排版升修订号
-draft未通过验收的草案后缀,验收通过才占正式版本号

11 常见问题

问题答
门禁评审去哪了?取消了。出关看证据:advance_phase 时一并落 exit_met/exit_gap,不需要评审会记录。
为什么只有 14 个对象?V5.0 删了门禁评审(仪式不产生决策)和建模对象登记(残缺,查已建对象走平台快照)。
口径到底挂客户还是挂项目?主挂项目(caliber_belong_project),customer_code 只是快照列。跨项目继承用 inherit_from_code。
caliber 挂需求还是挂项目?两列各自可选(mount_requirement_code/mount_project_code),至少填一个。旧 mount_id 单列挂两条关系平台建不起来。
项目做不下去了怎么登记?terminate_project→status=aborted(不做了),区别于验收完结的 closed。
机检 ERROR=0 是不是就万事大吉?不是。ERROR=0 只代表格式与完备性过;业务正确靠 42 条自检+真人复核。
什么时候升主版本?增删对象/关系/动作、改挂靠列、改枚举语义、改必填——结构性变更必须升主版本,不许用次版本糊。
草案能发给别人看吗?能,但文件名带 -draft(如 v5.0-draft1),⛔ 不许占正式版本号。
发现技能规则缺一条怎么办?只提「建议补哪条」,报家辉批准后才落。讨论业务时⛔顺手改技能。
客户平台已有的对象要重建吗?不。先拉快照比对,平台有的不重建;方案从快照 diff 出变更集。

12 验收单(交付前逐项打勾)

✓项
☐五类输入齐,缺项已报「缺什么去哪拿」
☐机检 T1–T14 跑完,ERROR=0,覆盖数已报
☐ERROR 三分类列清:A 已修 N / B 待确认 M / C 缺信息 K
☐42 条自检逐条过(fde-ontology-checklist)
☐四格完备:每对象创建/改关键字段/状态进+出/作废
☐真人确认页四块齐(新增对象/权限/机检/变更清单)
☐变更差值代码 diff 得出,非手算
☐xlsx 交付件只含平台真字段(无沿革/典型问句列)
☐四项数字比对 PASS(标题=实数=COUNT=正文数字)
☐标题=版本行=基线指向上一版,上一版文件还在
☐被删对象/动作全文出现 0 次
☐文件名规范:未验收带 -draft;每版新文件名不覆盖
☐平台变更已登记(含 rollback_way),dry-run 先行
☐明文链接已贴给验收人(非按钮/卡片)

FDE 本体建模操作手册 v1.2 | 数据口径:建模方案 V5.0(14/105/21/45/22/14)| 技能清单见第 9 节(17 个) | 生成日期 2026-11-03