mattwenjun/clawiser/load-game

Load Game — 项目状态恢复 + Review

读档 = 定位存档 → 读 HANDOFF → 对比计划 → 发现偏差 → 调整 → 更新存档。

不是"读完就开干"，是"读完先 review 再干"。

读档流程

Step 0: 定位存档

指定了项目 → 直接进 Step 1

没指定 / 模糊指定 → 发现流程：

# 列出所有可用存档
for f in memory/projects/*/HANDOFF.md; do
  project=$(basename $(dirname "$f"))
  updated=$(head -5 "$f" | grep '最后更新' | head -1)
  echo "$project | $updated"
done

输出：

📂 可用存档：
1. paper-pipeline — v3, 2026-03-05 22:00
2. github-publish — v8, 2026-03-16 19:24
3. ...

模糊匹配：用户说"load 那个论文的" → 关键词匹配目录名 + HANDOFF 标题。唯一结果直接加载，多个结果列出让用户选。

零结果：memory_search 搜关键词 → 可能没有 HANDOFF.md，从 memory 文件重建。

Step 1: 加载存档

读 memory/projects/<project>/HANDOFF.md

如果 HANDOFF.md 不存在或过时（>3 天未更新），先信息收集：

• memory_search 搜项目相关内容
• ls memory/projects/<project>/ 看所有文档
• 读 product-plan.md 等规划文档
• 检查相关 cron job 状态

Step 2: 对比计划 vs 实际

逐项核实：

Step 3: 识别偏差 + 调整

调整方案必须持久化——更新到对应的计划文档，不能只在对话里说。

Step 4: 更新存档

调整完成后，执行 save-game 更新 HANDOFF.md（版本号 +1）。

特殊场景

Compaction 后读档

Compaction summary 只有骨架。第一步读 HANDOFF.md，不是读 summary。

1. 读 HANDOFF.md → 恢复项目全貌
2. 读当前对话的最后几条消息 → 确认用户最新指令
3. 最新指令优先级 > HANDOFF.md 里的"下一步"

子 Agent 接手

子 agent 的 prompt 应包含：

先读 memory/projects/<project>/HANDOFF.md，这是你的完整上下文。
按"下一步"里的第一个待做项开始工作。
完成后更新 HANDOFF.md。

Cron 触发的定时 Check

读 memory/projects/<project>/HANDOFF.md，执行 load-game 恢复上下文。
检查到期的任务，汇报给用户。

读档检查清单

• [ ] 定位完成了吗？（不是猜项目名）
• [ ] HANDOFF.md 读了吗？（不是凭 summary 回忆）
• [ ] "已完成"的实际验证了吗？（不是看到 ✅ 就信了）
• [ ] 偏差识别了吗？
• [ ] 调整持久化了吗？
• [ ] 存档更新了吗？

依赖关系

• 前置：project-skill-pairing（项目结构）、save-game（存档的生产者）
• 被触发：compaction、cron、用户指令