FDE 本体建模操作手册 v1.2
写给 FDE 同事:从接客户到把本体建进平台、交出去、能回滚,全流程一件事一张表。
数据口径与 建模方案 V5.0 一致:14 对象 / 105 属性 / 21 关系 / 45 动作 / 22 字典 / 14 权限。门禁评审已取消,阶段出关改用 exit_met / exit_gap。
0 三分钟速览
六段全景
每段做完有出关检查:对照 entry_gate(退出门槛)逐条核对,达成情况写 exit_met(是/否),没达成的差距写 exit_gap(AI 对照 entry_gate 逐条推导、标注来源,机密级)。门禁评审会已取消——出关靠证据不靠开会。
谁干什么
| 角色 | 干什么 |
|---|---|
| FDE(你) | 收资料→整理需求→出方案→跑机检→落平台→写变更记录 |
| 数字员工(智兑现) | 登记/查询/推进等日常动作的执行者;exit_gap 由它推导初稿 |
| 部门领导 | 审推进阶段(advance_phase)、方案确认、高危动作 |
| 老板/真人复核 | 只看四块:新增对象、权限表、机检 ERROR/WARN、变更清单 |
最容易踩的坑
-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 | 资产复用包 | 资产入库→关项目/终止 |
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 |
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。
查询权限表(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 | 文档属性开挂载;字典值段 snake | ERROR |
| T13 | 每对象有查询权限 | ERROR |
| T14 | 四格完备 + 状态双向可达(能进也要能出,终态豁免) | ERROR |
交付件与审阅件分开
审阅件(md/HTML):含沿革、典型问句、变更清单。交付件(xlsx):只含平台真字段,⛔ 混进「沿革」列会被当成要建的字段。
交付前四项比对
6 平台落地
七步
执行顺序固定:字典→对象→属性→关系→动作→权限;关系必须等源/目标对象都建完(平台约束);每段完成即回读。
三方比对
方案 vs 平台现状:平台有方案无 → 标「来源不明」⛔ 不进变更集,先报人。⛔ 不许从平台反导当方案。
回滚能力
每次写操作登记 fde_platform_change:payload 可重放、rollback_way(revert/delete/disable/migrate/irreversible)。irreversible 须 FDE 书面确认。每条写操作落 JSONL 日志(只增不删)。
7 红线(碰到就是事故)
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 | 家辉比对文档与自报 | 机检结论一致性:文档数字必须与代码输出逐字一致 |
| 4 | 5 个对象一个动作都没有(零动作对象) | 家辉复查设计 | B2 补「动作完备性」四格;T14 落地 |
| 5 | 属性描述写了动作名,动作表里没这个动作 | 机检 blocked/dropped 字面 0 次 | 描述提到的动作必须在动作表存在,否则 ERROR |
| 6 | xlsx 交付件混进「沿革」列(删列按索引删错) | 回读生成日志发现 | 删列按列名不按索引;交付件只含平台真字段 |
| 7 | 验证的是 14 对象的数据,发布的是 16 对象的旧文件 | 家辉复跑对不上 | 四项数字比对:只对「即将发布的那一个文件」做比对 |
| 8 | 表格改成 14,正文还写 16 对象/115 属性 | 家辉看叙述层矛盾 | 四项比对第 4 项:正文规模数字正则扫全文逐个比对 |
| 9 | paused 能暂停不能恢复(状态死胡同) | 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-checklist | 42 条自检清单:业务正确性逐条过,任一未过不得交付 | |
| 第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 | 交付与消息通道:发文件、发通知 |
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