跳到主要内容

Data Horizon L1/L2/L3 文档链级评审(四准则)

三路独立评审(CC-A 易读+越界 / CC-B 对齐+工程落地 / Codex 四准则窄抽样)。总体结论:三层抽象高度守得极好、承接链可逐跳追溯、防漂移机制内建、对齐度强、工程「有条件就绪」。 查出的真问题集中、可控。

总评(按四准则)

  1. 易读/准确/无歧义/无漂移:高。核心事实(私域职业信号与 P1 并列、突发事件优先、行情后置、webhook 无业务确认、七维度、不变量)三层逐字一致。少量真漂移见下。
  2. 不过度文档化/不越界:三层守得好(L1 不写 schema、L2 §15「给清单不给字段」、L3 才落表名状态机;频率标「观察值非 SLA」、阈值留实施方案)。轻微防御性重复(判断题)。
  3. 上下对齐:高度对齐(强)。差异化主线/不变量/优先级一脉相承,无未授权新主线。
  4. 工程落地:有条件就绪(接近)。M0 骨架齐备,但有硬依赖未闭合。

三路收敛的真问题 → 修订计划

A. 现在修(文档内一致性/可读性,低成本高价值)

编号问题收敛修法
C1「已采纳」终态:L3 §11.3 引入 L2 §15.3 没有的终态,且 §2 把它写进「继承 L2」的不变量①(收尾时已推到 §6/§10/§2)——属「L3 自创称继承」CC-A 1-1 + CC-B #2§11.3/§2 标「已采纳」为 L3 细化态;L2 §15.3 加前瞻注(L3 细化采纳终态)
C2ADR-04 拆分 + 09–12 单向漂移:L3 把消费确认从 04 拆到新 ADR-11、加 09–12,但 L2 §15.5 仍 8 条、04 含消费确认CC-A 1-2/1-3 + CC-B #1L2 §15.5 加回指注「L3 评审拆 04 + 新增 09–12,以 L3 §23 为索引准」
C3§11.6「待 §15 协调点」过程便签泄漏(§15 已落定)CC-A 1-5 + CC-B #5改「见 §15 已定」
C4L3 frontmatter status: draft 与「正文全部完成」矛盾CC-A 1-6status → in-review(或 active)
C5L1 图1 RLE/FEFM 缩写先于全称(line 19 vs 244)CC-A 1-4图注首次出现给全称
C6P0–P4 双轴误读风险(P1 先做硬 vs P2 私域信号与 P1 并列)Codex 必修L2/L3 固定一句「P0–P4 是闭环归属,不是线性优先级」(L2 §5 已有类似,强化一处)

B. 判断题(过度文档化,可选轻修,非硬错)

  • L3 战略边界三句重申 ~9 处(CC-A 2-2):保留不变量表,收敛重复散文。
  • L3 §4 整段克隆 L2 §15.2 消歧(CC-A 2-3):可压为「承接 L2 §15.2,不复述」。
  • L1 §4.4「K线仅在图像分析中读图」微下沉(CC-A 2-1):可软化。
  • 各层都有阅读/维护元节(CC-A 2-4):可不动。

建议:B 类按「内容大于形式、不为治理而治理」原则轻修 2-2/2-3,其余保留。

C. 留 M0(工程就绪硬依赖,属下一工作流,非文档缺陷)

阻塞说明出处
ADR-03 ATM 消费对象形态跨项目外部依赖,未对齐前 P1 输出契约无法冻结(最大单点)三路一致;保持 proposed 不冻结正确
5 条高优先 ADR 待起草02 授权 / 04 交付 / 08 存储切分 / 10 密钥 / 11 反馈;ADR-08 不定 → 资产表 schema 悬空CC-B #2 + Codex 必修
状态机字段未落质量/置信独立字段、七维度强制、反馈记录 schema 待工程包Codex 必修
工程债未绑 WP明文凭证 / 主链路测试两高风险落在「(新增工程债任务)」未编号格;gap-map 首批无安全/测试 WPCC-B #3 + Codex
M0 治理入口「工程债先行」需在 implementation/风险治理有同等入口,避免 M0 任务从 L3 单点冒出Codex 必修
DH-WP-001 ≠ 完整 P1 闭环是首条可观测样板,仍需 WP-P1-02/03 + ADR-03/04/11 补消费契约与反馈Codex 建议

建议 M0 工作流:补 gap-map WP-SEC-01(凭证迁移)+ WP-TEST-01(主链路测试);M0 前落盘 ADR-02/04/08/10/11;与 Trading Matrix 对齐 ADR-03。

亮点(保留)

  • 三层抽象高度守得极好;§15「承接补强」专节是教科书式层间交接。
  • 边界不变量逐层逐条带编号承接,Agent 可机械追踪。
  • 诚实标注现状缺口 vs 目标态;文档↔代码漂移(dn_event_news_std/CLAUDE.md)主动登记为风险。
  • 承接链可逐跳追溯(承接 L2 §x / gap-map WP-x / 不变量 x)。

处置

A 类(C1–C6)+ B 类轻修(2-2/2-3)建议现在由 CC 主笔修;C 类留 M0 工作流。

✅ 已执行(2026-06-01,owner「执行 A 和 B」):A 类 C1–C6 + B 类 2-2/2-3 全部应用(详见 status.md「✅ 已执行」表)。C 类(ADR-03 对齐 / 高优 ADR 落盘 / WP-SEC-01·WP-TEST-01 工程债 / 状态机字段·反馈 schema)留 M0 工作流,非本评审范围。