用途:在新会话开始时恢复项目上下文。该命令读取本地 Git 历史中由 /checkpoint-commit 创建的 checkpoint 提交,展示最近的相关检查点详情,并总结已实现内容、剩余工作与已记录的决策,帮助实现会话连续性。
用法:/checkpoint-read,无需参数,自动读取本地 Git 历史中最近的 checkpoint 提交。
工作流程:
- 列出最近检查点,查询命令为 git log --oneline --decorate --grep '^checkpoint.*:' -n 25。若无结果,报告“No checkpoint commits found in this repository.”并停止,继续无检查点上下文的会话;若有结果,展示最近检查点提交列表。
- 读取最近检查点,从列表第一条提取 SHA,执行 git show --stat {SHA} 查看变更文件统计,执行 git show {SHA} 查看完整提交信息与差异,解析提交主题与正文以恢复上下文。
- 总结上下文,分析提交信息并生成三部分结构化摘要:已实现内容(从提交正文要点与差异中提取)、剩余工作(待办、TODO 或未完成项)、已记录决策(架构或设计决策)。
- 报告,向用户展示结构化摘要,包括检查点提交 SHA 与日期、提交主题中的 CR 标识(如 CR-XXXX)以及三部分上下文摘要。
安全规则:不得执行破坏性 Git 操作,包括 git reset、git rebase、git commit --amend、git push --force;不得创建提交、修改文件或以任何方式改变 Git 状态;必须完全只读,仅允许 Git 查询命令;必须仅依赖本地 Git 操作,不进行网络调用。
适用场景:需要跨会话延续项目上下文、回顾最近检查点进展与决策时。限制:仅读取本地 Git 历史,依赖已有 checkpoint 提交;无检查点时无法提供上下文;不修改任何状态。