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 残留。
方法
- 代码事实逐文件核对实际代码(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。
- Codex 大上下文规避:architecture.md 已 ~6000 行,Codex 读全文 + 代码触发 remote compaction;后续 L3 评审给 Codex 只附受审小节文本。
- 去黑话作为往后所有下位文档硬约束(4 测试)。