name: checkpoint description: Git 检查点管理 - 创建、列出、恢复检查点。在开始风险更改或需要安全恢复点时调用。 allowed-tools: Bash, Read, Write, Glob
Git 检查点系统
管理 Git 检查点(暂存)用于安全的代码探索和恢复。
何时调用
- 在进行风险更改或重构前
- 当您想要一个快速保存点而不提交时
- 在实验失败后恢复先前状态
- 以维护多个进行中的工作状态
用法
/checkpoint create [name] # 创建命名检查点
/checkpoint list # 列出检查点
/checkpoint restore [name] # 恢复特定检查点
/checkpoint pop # 恢复最新检查点
/checkpoint clear # 移除检查点
指令
创建检查点
- 检查是否在 Git 仓库中
- 检查未提交的更改
- 创建名为
claude-checkpoint_YYYYMMDD_HHMMSS: [name]的 Git stash - 确认检查点创建
列出检查点
- 运行
git stash list - 过滤以
claude-checkpoint开头的 stash - 以格式化表格显示:
- 索引(stash@{N})
- 时间戳
- 描述
- 更改的文件数
恢复检查点
- 找到匹配给定名称或索引的 stash
- 使用
git stash apply stash@{N}应用 stash - 不要删除 stash(保持安全)
- 报告恢复详情
弹出检查点
- 找到最新的
claude-checkpointstash - 使用
git stash pop stash@{N}应用它 - 报告恢复详情
清除检查点
- 列出
claude-checkpointstash - 操作前询问确认
- 删除每个匹配的 stash
- 报告移除数量
示例
# 在风险更改前创建检查点
/checkpoint create "重构认证模块前"
# 列出检查点
/checkpoint list
# 如果出现问题,恢复
/checkpoint restore "重构认证模块前"
# 快速恢复最新的一个
/checkpoint pop
# 清理旧检查点
/checkpoint clear
备注
- 检查点底层依赖 Git stash
- 检查点包含未跟踪文件
- 检查点跨会话持久化
- 应用描述性名称以便识别