checkpoint

Git 检查点系统

管理 Git 检查点（储藏），以便安全地探索代码并在需要时恢复。

调用时机

• 在进行有风险的更改或重构之前
• 想要快速保存一个状态点，但不提交时
• 实验失败后恢复到之前的状态
• 维护多个进行中的工作状态

用法

/checkpoint create [name]     # Create a named checkpoint
/checkpoint list              # List checkpoints
/checkpoint restore [name]    # Restore a specific checkpoint
/checkpoint pop               # Restore the most recent checkpoint
/checkpoint clear             # Remove checkpoints

说明

创建检查点

1. 检查是否位于 Git 仓库中
2. 检查是否存在未提交的更改
3. 创建 Git 储藏，名称为：claude-checkpoint_YYYYMMDD_HHMMSS: [name]
4. 确认检查点已创建

列出检查点

1. 运行 git stash list
2. 筛选以 claude-checkpoint 开头的储藏
3. 以格式化表格显示：
   • 索引（stash@{N}）
   • 时间戳
   • 描述
   • 更改的文件数量

恢复检查点

1. 查找与指定名称或索引匹配的储藏
2. 使用 git stash apply stash@{N} 应用储藏
3. 不要删除储藏（保留以确保安全）
4. 报告恢复详情

弹出检查点

1. 查找最近的 claude-checkpoint 储藏
2. 使用 git stash pop stash@{N} 应用该储藏
3. 报告恢复详情

清除检查点

1. 列出 claude-checkpoint 储藏
2. 继续操作前先请求确认
3. 删除每个匹配的储藏
4. 报告删除数量

示例

# Create checkpoint before risky changes
/checkpoint create "before refactoring auth module"

# List checkpoints
/checkpoint list

# Restore if something went wrong
/checkpoint restore "before refactoring auth module"

# Quick restore of the recent one
/checkpoint pop

# Clean up old checkpoints
/checkpoint clear

备注

• 检查点在底层使用 Git 储藏
• 将未跟踪文件也包含在检查点中
• 检查点会跨会话保留
• 使用描述性名称以便识别