cheat-retro

/cheat-retro — 数据回收与复盘

抓 T+N 天的实际表现 → 对比预测 → 提炼新观察 → 写入 rubric-memo.md。只追加 ## 复盘 段，绝不改预测段。rubric_notes.md 是 blind 白名单，只能保存通用公式、维度定义和抽象规则，不能写入样本名、实绩、评论、链接或播放/阅读数。

Overview

[用户：复盘 predictions/2026-05-04_...]
  ↓
[Phase 0: 校验 immutability + 校验时间窗口]
  ↓
[Phase 1: 抓数据（manual paste 或 adapter）]
  ↓
[Phase 2: 写实绩段 + top 评论关键词]
  ↓
[Phase 3: 验证/推翻预测的各假设]
  ↓
[Phase 4: 提炼新观察]
  ↓
[Phase 5: 落盘（追加到 ## 复盘 段）]
  ↓
[Phase 6: 写入 rubric-memo.md 的"观察记录"段]
  ↓
[Phase 7: 检测是否触发 bump 候选 → 提示用户跑 /cheat-bump]

Constants

• RETRO_WINDOW_DAYS = 3 — 默认 T+3d。短视频快平台可设 1，长文设 7
• DATA_SOURCE = manual — manual: 用户粘数字；adapter: 调对应平台 adapter（需配置）
• AUTO_PROPOSE_BUMP = true — Claude 判断是否系统性偏差时自动提议 /cheat-bump
  • 默认参考：连续 ≥3 次同向偏差（high/low）→ 提议
  • 但 Claude 可以更早提议：1 次极端偏差（如中枢 50w 实绩 5w 这种 ≥10x），即使没有"连续"也提议
  • 也可以更晚：3 次同向但每次偏差都很小（<25%），可能只是噪声不是系统性
• TOP_COMMENTS_N = 20 — 抓 / 粘 top N 高赞评论

💡 调用时覆盖：/cheat-retro <file> — window: 7 — source: adapter

Inputs

必填	来源
<prediction-file> 或 <video-folder>	用户参数；缺失则从 .cheat-state.json 的 pending_retros[0]
rubric_notes.md	用户项目根（只读，用于当前规则上下文；不得写入实绩观察）
rubric-memo.md	用户项目根（写入复盘观察、实绩证据、样本名与评论信号）
.cheat-state.json	状态文件

入参解析（同 cheat-predict 双形态接受）

用户给的可能是：

• predictions/2026-05-04_<id>_<short>.md → 直接用这个 prediction 文件
• videos/2026-05-04_<id>_<short>/ → 找对应的 prediction 文件（按 id 匹配）+ 把 report.md 写到该 video folder 里
• 缺省 → 从 pending_retros[0] 取最早的

Workflow

Phase 0: 校验

1. 读 <prediction-file>，确认存在
2. 识别有效预测段：扫所有 ## 预测... 段（可能含 ## 预测、## 预测 v1、## 预测 v2 等）：
   • 取最后一个## 预测 vN 作为本次校准的依据（v2 存在则用 v2；只有 v1 则用 v1；legacy 单段 ## 预测 直接用）
   • state.shoots 对应项的 v2_prediction_written 应与"是否存在 v2 段"一致——不一致则警告（state 与文件脱节）
3. 校验 immutability：在内存 cache 住所有 ## 预测... 段的内容（用于 Phase 5 后核对——全部段不可改，不只是有效段）
4. 校验文件 header 有 Published at → 没登记的不能复盘，提示用户先 /cheat-publish
5. 校验时间窗口：今天 - published_at >= RETRO_WINDOW_DAYS。不够 → 提示"还差 X 天"，询问用户是否仍坚持复盘（标 early_retro: true）
6. 校验已有复盘段是否已填——已填则询问"是补充还是修正？"
   • 补充 → 在已有复盘段下追加新子段，标日期
   • 修正预测段（用户错觉）→ 拒绝