用途:在新 session 中恢复 decision-rich checkpoint,包括当前目标、git 快照、进度状态、已做决策、验证状态、阻塞、剩余工作、下一命令和交接风险。入口为 .claude/checkpoints/ 下的 checkpoint 文件,恢复后呈现上下文摘要并继续原工作流(build / verify / ship 等)。
主要能力与用法:扫描 .claude/checkpoints/ 下所有 .md 文件,按文件名时间序排序;默认加载最新 checkpoint,也支持按标题关键词搜索或按 list 编号选择,例如 /restore、/restore auth、/restore list。读取后呈现最小恢复摘要,检查当前 git 分支与 checkpoint 的 branch 字段是否匹配,不匹配时发出警告但不阻止恢复。
限制与边界:只读操作,不修改代码;恢复上下文后不得直接开始写代码,必须先呈现、再确认、再行动。若 SessionStart 已提供足够 feature state 且不需要决策上下文,或仅询问历史信息、checkpoint 来源不明或与当前 repo 明显不匹配,则不应使用。缺失字段需标记为 legacy checkpoint;引用文件不存在则标记 stale。checkpoint 格式、命令与字段保持原样。