ClaWiser load-game

install
source · Clone the upstream repo
git clone https://github.com/MattWenJun/ClaWiser
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/MattWenJun/ClaWiser "$T" && mkdir -p ~/.claude/skills && cp -r "$T/assets/load-game" ~/.claude/skills/mattwenjun-clawiser-load-game && rm -rf "$T"
manifest: assets/load-game/SKILL.md
source content

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 实际

逐项核实:

检查项怎么查
"已完成"的真的完成了?跑验证命令、查输出文件
Cron job 还在跑?
openclaw cron list
阻塞项解除了?查相关 API / 文件 / 状态
时间线还现实?当前日期 vs 计划日期

Step 3: 识别偏差 + 调整

级别定义处理
🔴 P0阻塞后续工作立即修复
🟡 P1影响质量但不阻塞本次 session 修
🟢 P2优化项记录,下次处理

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

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、用户指令