checkpoint
保存与恢复工作状态检查点。会记录 git 状态、已做决定和剩余工作, 让你在中断后能准确续跑,包含跨分支、跨 Conductor workspace handoff 的场景。 当用户说“checkpoint”“保存进度”“我刚做到哪了”“resume”“我在做什么” 或“接着上次做”时使用;也适合在 session 即将结束、用户要切换上下文、 或长时间暂停前主动建议。 (gstack)
SKILL.mdreferences/translations/gstack/checkpoint/SKILL.md
GitHub<!-- 中文参考译文。共享 preamble 见 ../SKILL.md。 -->
/checkpoint
把当前工作状态落成可恢复的检查点,或者把之前的检查点重新读回来。
命令模式
/checkpoint或/checkpoint save:保存当前状态/checkpoint resume:恢复最近或指定检查点/checkpoint list:列出可恢复检查点
Save 流程
- 收集 git 分支、改动文件、最近提交和当前任务上下文。
- 用对话历史补齐摘要:
- 当前在做什么
- 已做过哪些决定
- 剩余工作有哪些
- 还有什么注意事项
- 计算 session 持续时间。
- 以固定格式写入 checkpoint 文件,并向用户确认:
TitleBranchFileModifiedDuration
Resume 流程
- 找到当前分支或用户指定范围内的 checkpoint。
- 读取 checkpoint,并回显:
- 标题
- 保存分支
- 保存时间
- 上次 session 时长
- 状态
- 用
AskUserQuestion询问下一步:- 继续处理剩余工作
- 显示完整 checkpoint
- 只取上下文,不继续执行
List 流程
- 默认只列当前分支的 checkpoint
--all时扩展到所有分支- 输出为表格,重点显示日期、标题、状态,以及必要时的分支名
关键规则
- 这是状态保存 / 恢复技能,不修改业务代码。
- checkpoint 必须带分支名,便于跨 branch 恢复。
- checkpoint 文件只能追加,不能覆盖或删除旧记录。
- 优先从 git 状态和上下文里推断,不要把本可推断的信息都丢给用户回答。