跳到主要内容

ADR-022 · 术语整顿与统一编号命名规范

状态

accepted(2026-06-05,owner 逐条对齐)。工作底稿见 术语审词裁决表

背景

owner 2026-06-04/05 指出:本仓文档、工程包、代码与 CURRENT-MILESTONE 充斥只有"造词那次会话"才看得懂的术语——自造黑话(「硬化铺面」「不完整的绿」)、借比喻(「结算」「账本」)、框歪心智模型(「问责」)、私有编号(带撇号的不变量 I-NN')。后果:换一个人或没有同等上下文的 Agent 接手迭代/维护/修 bug 会读不懂、对不齐、理解和执行漂移。一个只有原作者读得懂的 SSOT 不是事实源。 经全量审词(glossary 全词条 + FinBayes 工程术语 + 代码标识),确认问题集中在个别 contested 词与一套散落的编号体系。

决策

1. 三原则(裁决判据)

  • A 语义准确:不自创黑话、不模糊、防理解与执行漂移。
  • B 易读可维护:他人与 Agent 接手文档和代码都读得懂、改得动。
  • C 全球一致:面向全球用户,术语要能干净翻译、各语种意义一致,不依赖单一语言特有联想。

元规则:精确与易懂冲突时朝易懂偏;普通日常词优先,借比喻/自造词先当有罪;状态词不夹带时态或程度;想用"部分"是"底层是复合的"信号、应拆开;术语分内部/产品面向/外部标准三层对待。

2. 术语裁定

理由
问责 / 可问责判断跟进 + 校准(不挂伞形标签)"问责"把自省—对账—校准框成追责庭、带偏设计往记分牌、官场色彩跨文化失败
三态结算 / 校准账本判断跟进两层验证枚举 + 校准记录"结算/账本"借金融比喻、不透明
交易行动前检查交易决策参考材料修「检查」词性错位;"决策"是用户的、材料是 FinBayes 的——不让 FinBayes 站进决策者位
认知材料保留"材料"是刻意的"我供料、你决策"框架(对照其 glossary"不是 指令/信号/推荐")
金融认知体系五件套金融认知体系(构成开放描述)体系本就动态演进,不写死数字;"五件套"俏皮、跨文化译出怪
CMCommons 资产(退缩写)缩写抽象、有撞 L/D/S 史
escalation / 升级上报裁决(英文 escalation 保留)中文"升级"撞"版本升级"
L / D / S「对齐颗粒」「对齐层级」,字母保留作简写、首次带词(战略层 L / 设计层 D / 执行层 S)"颗粒"怪词;字母嵌得太深不全删
Readiness(两条词条)合并一条近重复
MCA「横切维度 / 桶」市场结构分轴(7 分轴)/「按市场结构分组」"横切"软件借词、"桶"ML 黑话;代码留 MCA + 索引带全称
横切(子流程)跨机制同上;S1 = 跨机制一致性校验

3. 统一编号命名规范

  • 去隐晦标点(撇号 ' 首当其冲);类型(契约/禁令等)不进 ID、进索引列。
  • ID 形如 可读前缀-编号;引用处首次出现必带展开名(写"组件 9 主动性与触发""M5 事件传导链路",不光写编号)。
  • 真改 ID 的只有不变量 I-NN'INV-NN(碰代码,交工程会话);M1–M8/S1/D1–D11/组件/阶段不改 ID,靠"首次带名 + 索引"达到看得懂。
  • 代号与编号索引:一处可查所有编码体系(代号 → 人话 → 事实源)。

4. 阶段 3 重定义(连带)

CURRENT-MILESTONE 曾漂移为"阶段 3 = 问责闭环(核心 P0)",与 owner 2026-06-04 议定相反。纠正:阶段 3 = 加固与可用化(让 agent 真能被用起来、经得起用);判断跟进 + 校准(原"问责")移出编号阶段,作单独产品设计课题,待真 agent 用起来、有真实手感后再设计其"好体验"。

与既有决策的关系

  • 修订「行动判断」弃用决议(FinBayes 战略白皮书重写工作流 2026-05-27):补「交易决策参考材料」为「交易行动前检查」的替代名。
  • 重新摆位 ADR-020 可问责定位:「可问责」从伞形概念拆为「判断跟进 + 校准」组件层能力,正式系统移出早期编号阶段。
  • 衔接 ADR-021 kelly_cap 退役:不变量 I-06' 已退役。
  • 延续 ADR-013 Build-Y:命名规范"先说要做成什么、用大白话"是 Build-Y 在术语层的体现。

落地(分步)

  1. ✅ SSOT 阶段 3 漂移已修(CURRENT-MILESTONE §1/§4/§3quater,commit 484e95f)。
  2. ✅ 本 ADR + 代号与编号索引(本轮)。
  3. ⏳ 回写 ecosystem/glossary.md:术语改名 + 弃用术语表记理由 + 新增「判断跟进 / 校准 / 验证状态·验证结论两层枚举」词条(经本 ADR 授权,走 governance/change-protocol.md)。
  4. ⏳ 文档措辞全仓传播(「问责→判断跟进+校准」「横切→跨机制」等)。
  5. ⏳ 代码标识符改名(I-NN'INV-NNs1 等)交工程会话,排在词敲定之后。

Audit trail

  • 2026-06-04/05:owner 发起术语整顿,逐词对齐;裁决全程见 术语审词裁决表
  • 本 ADR 为正式决策记录;glossary 与文档的实际改动以本 ADR 为授权依据。