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"不是 指令/信号/推荐") |
| 金融认知体系五件套 | 金融认知体系(构成开放描述) | 体系本就动态演进,不写死数字;"五件套"俏皮、跨文化译出怪 |
| CM | Commons 资产(退缩写) | 缩写抽象、有撞 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 在术语层的体现。
落地(分步)
- ✅ SSOT 阶段 3 漂移已修(
CURRENT-MILESTONE§1/§4/§3quater,commit484e95f)。 - ✅ 本 ADR + 代号与编号索引(本轮)。
- ⏳ 回写
ecosystem/glossary.md:术语改名 + 弃用术语表记理由 + 新增「判断跟进 / 校准 / 验证状态·验证结论两层枚举」词条(经本 ADR 授权,走governance/change-protocol.md)。 - ⏳ 文档措辞全仓传播(「问责→判断跟进+校准」「横切→跨机制」等)。
- ⏳ 代码标识符改名(
I-NN'→INV-NN、s1等)交工程会话,排在词敲定之后。
Audit trail
- 2026-06-04/05:owner 发起术语整顿,逐词对齐;裁决全程见 术语审词裁决表。
- 本 ADR 为正式决策记录;glossary 与文档的实际改动以本 ADR 为授权依据。