跳到主要内容

L3 §11–13 评审汇总 + 修订记录

CC 评审(逐文件核对实际代码)为主依据;Codex 本轮触发 remote-compaction 失败、仅回收 N1 一条(与 CC 收敛)。另:用户补充「避免自创术语 / 黑话」原则,本轮一并执行去黑话。

A. 代码事实修订(CC 核对,已落)

#问题修订
B1§11.2「重复丢弃/处理失败」代码非两终态(单 status=3 + last_err duplicate: 前缀)§11.2 补代码对应留痕,落字段留 §27
B2§13「现行推送有重试」:PushJob 失败即置终态、不自增 retry_count,retry_count<3 是死代码§13 改「无重试、是缺口」+ 待补 + 登 §22/ADR-04;§12 幂等去「现行有重试」
N1§11.1 Source 现行仅启用/停用(Codex 亦印证)补代码对应留痕,降级/死源/退役为目标态
N2§13「翻译失败有限重试」无代码支撑改「记日志后继续、不重试」+ 待补
N3现行无「低置信」中间态(status 仅 0/1/2/3)§13 注:低置信须落独立字段、勿复用 status
N4§13「去重不可用退化规则去重」无兜底(Weaviate nil→静默放行)标「现行静默放行」+ 待补 + §24 风险
N5§12「两任务都完成才置已分发」偏乐观(task 失败不阻断、仅日志)改准确 + 关联 CLAUDE.md「错误必须返回」张力

B. 去自创术语 / 黑话(用户原则,横跨 §1–13,已落)

  • G6 → 「ATM 消费对象形态(待与 Trading Matrix 对齐)」(gap 索引标签脱离会话上下文无人能懂;只留 workstream 评审稿)
  • 时效内核 → 突发事件实时主链路;first-class → 独立建模对象(首处白话注释);投影 → 派生/留存、对外交付快照;通道中性 → 不分推送/拉取通道;背压 → 上游积压
  • 残留可溯源术语(感知资产/资产化/沉淀/底座)保留;核心词「感知/感知资产」交上游术语重审(owner 拍板要重审)

亮点(CC)

  • §11 五状态机与 L2 §15.3 逐行可对、四状态不变量每图有句。
  • §12 cron/SkipIfStillRunning/表状态轮询/Weaviate 去重描述与实际代码吻合,频率标观察值。
  • §13/§12 阈值/熔断/调度参数留下游,未冻结。
  • DH 语义纯净,无 FinBayes 残留。

方法

  1. 代码事实逐文件核对实际代码(raw_news_consts.go / standardize.go / push_message_job.go / push_log_model.go / raw_news_job.go / cron_manager.go / crawler_sources_consts.go),不信任已漂移的 CLAUDE.md。
  2. Codex 大上下文规避:architecture.md 已 ~6000 行,Codex 读全文 + 代码触发 remote compaction;后续 L3 评审给 Codex 只附受审小节文本。
  3. 去黑话作为往后所有下位文档硬约束(4 测试)。