| name | save-game |
| description | 项目存档（Save Game）。审视→反思→调整→写交接，不只是抄状态。 适用于：工作段结束需要保存进展、compaction 即将发生、移交给其他 agent、需要设定未来检查点、或任何"下次回来时需要知道现在做到哪了"的场景。 当用户表达类似意图时触发——不限于特定措辞。常见表达举例："存档"、"save game"、"写交接"、"记一下进度"、"今天先到这"、"我要去忙了"、"先放一放"、"把进展存下来"、"下次继续"、"记录一下当前状态"、"别忘了我们聊到哪了"。 Agent 也应在以下情况主动建议存档：上下文即将溢出、长时间项目讨论即将中断、用户明显要离开。
|
| version | 0.1.0 |
| author | MindCode |
| tags | ["project-management","handoff","clawiser"] |
Save Game — 项目存档
存档不是"把当前状态抄到文件里"——是一轮完整的 review + 调整 + 交接。
写出来的 HANDOFF.md 是给下次启动项目的 agent 看的。它读完这一个文件就能理解目标、知道进度、知道下一步。
存档流程
Step 0: 定位项目
- 搜索已有项目：
ls memory/projects/ + memory_search 搜项目关键词
- 找到匹配的 → 先读旧 HANDOFF.md 再写新的，不能覆盖旧内容
- 没找到 → 创建
memory/projects/<name>/
两个禁忌：
- ❌ 明明有项目却新建（重复）
- ❌ 把新项目塞进不相关的旧项目（混淆）
Step 1: Review 工作进展
回顾这个工作段：
- 完成了哪些任务？做到了什么程度？
- 产出了哪些文件/代码/配置？（列出具体路径）
Step 2: 对比原有计划
找到原始计划（HANDOFF.md 的"下一步"、product-plan.md 等），逐项对比：
| 检查项 | 回答 |
|---|
| 计划完成的完成了吗？ | |
| 出现了计划外的工作吗？ | |
| 有什么计划了但没做的？为什么？ | |
Step 3: 提炼经验和教训
- 有效的做法：什么决策/方案被验证有效？
- 踩的坑：什么假设被推翻了？根因是什么？
- 意外发现：过程中发现了什么不在计划内的信息？
关键问题：这些经验是否影响后续计划？
Step 3.5: 产出封装检查
回顾产出清单，逐项判断：
- 需要持久化的（数据、配置、文档）→ 直接写文件
- 需要封装为 skill 的（可复用工作流）→ 不在 save-game 里执行，写入 HANDOFF.md 的"下一步"作为待办
- 都不是 → 跳过
为什么不当场封装：save-game 通常发生在 context 快满时，skill 设计需要讨论确认，多轮对话会让 context 爆掉。
Step 4: 评估计划调整
原有计划还成立吗？
- 成立 → 直接进 Step 5
- 不成立 → 确定调整方案，更新受影响的所有文档（不只是 HANDOFF）
Step 5: 写 HANDOFF.md
存放位置：memory/projects/<project>/HANDOFF.md
# <项目名> 交接文档
> 最后更新：YYYY-MM-DD HH:MM | v<N>
> 下次 agent 读这一个文件就够了
## 🎯 项目目标
## 📍 当前进展
## ➡️ 下一步
## 关键经验 & 铁律
## 架构
必写内容
| 字段 | 为什么 |
|---|
| 项目目标 | 新 agent 要先理解"为什么" |
| ⚠️ 用真实名字 | HANDOFF 里用 USER.md/IDENTITY.md 的真实名字，不用通用的"用户"/"agent" |
| 当前进展 | 不查 git log 就知道做到哪了 |
| 下一步 | 不猜就知道接下来做什么 |
| 关键数字/ID | compaction 后会丢（cron ID、端口号、群 ID） |
| 铁律 | 踩过的坑不能重蹈 |
Skill 关联检查
写完后检查：本次工作中新建了 skill 吗？如果与当前项目直接关联 → symlink 到项目。
Deferred Check
当某个任务需要未来跟进时，存档后设 cron：
openclaw cron add --at "<时间>" --name "<项目>-check" \
--session isolated --wake now --no-deliver \
--message "读 memory/projects/<project>/HANDOFF.md，执行 load-game 恢复上下文，检查状态，汇报给用户。" \
--delete-after-run
存档检查清单
依赖关系
- 前置：
project-skill-pairing（项目结构和 Tier 分级）
- 配合：
load-game（存档的消费者）
