checkpoint-read

/checkpoint-read

读取检查点提交历史，在开始新会话时恢复项目上下文。查询 Git 历史中由 /checkpoint-commit 创建的检查点提交，显示最近的相关检查点详情，并总结已实现的内容、待完成的事项以及记录的决策，从而实现会话的无缝延续。

用法： /checkpoint-read

无需参数。此命令会自动读取本地 Git 历史中最近的检查点提交。

工作流程

按顺序执行以下步骤。

步骤 1：列出最近的检查点

查询 Git 历史中的检查点提交：

git log --oneline --decorate --grep '^checkpoint.*:' -n 25

• 如果没有结果： 报告“此仓库中未找到检查点提交。”并停止。继续本次会话，不使用检查点上下文。
• 如果有结果： 显示最近的检查点提交列表，概览检查点历史。

步骤 2：读取最近的检查点

从列表中最新的（第一条）检查点提取 SHA，然后读取其完整详情：

# Show commit stats (files changed)
git show --stat {SHA}

# Show full commit message and diff
git show {SHA}

解析提交消息的主题行和正文，以恢复上下文。

步骤 3：总结上下文

分析检查点提交消息，并按以下三个部分整理总结：

1. 已实现的内容： 从提交正文的项目符号列表和差异内容中提取已完成的工作。
2. 待完成的事项： 找出提交消息中提到的待处理事项、TODO 或未完成的工作。
3. 记录的决策： 记下提交消息中记录的架构或设计决策。

步骤 4：报告

向用户提供结构化总结，包括：

• 检查点提交的 SHA 和日期，以供参考
• 提交主题中的 CR 标识符（例如 CR-XXXX）
• 三部分上下文总结（已实现的内容、待完成的事项、记录的决策）

安全规则

• 不得执行有破坏性的 Git 操作：git reset、git rebase、git commit --amend、git push --force
• 不得创建提交、修改文件或以任何方式更改 Git 状态
• 必须完全只读——只允许使用 Git 查询命令
• 必须仅依赖本地 Git 操作（不得进行网络调用）