Checkpoint 命令¶

在工作流中创建或验证 checkpoint。

用法¶

/checkpoint [create|verify|list|clear] [name]

创建 Checkpoint¶

创建 checkpoint 时：

1. 运行 /verify quick，确认当前状态干净
2. 以 checkpoint 名称创建 git stash 或 commit
3. 将 checkpoint 记录到 .claude/checkpoints.log：

echo "$(date +%Y-%m-%d-%H:%M) | $CHECKPOINT_NAME | $(git rev-parse --short HEAD)" >> .claude/checkpoints.log

1. 报告 checkpoint 创建完成

验证 Checkpoint¶

对照 checkpoint 进行验证时：

1. 从日志中读取 checkpoint
2. 将当前状态与 checkpoint 进行比较：
3. Checkpoint 之后新增的文件
4. Checkpoint 之后修改的文件
5. 当前与当时的测试通过率

6. 当前与当时的覆盖率

7. 报告：

   CHECKPOINT COMPARISON: $NAME
   ============================
   Files changed: X
   Tests: +Y passed / -Z failed
   Coverage: +X% / -Y%
   Build: [PASS/FAIL]
   

列出 Checkpoint¶

显示所有 checkpoint，并附带以下信息： - 名称 - 时间戳 - Git SHA - 状态（current, behind, ahead）

工作流¶

典型 checkpoint 流程：

[시작] --> /checkpoint create "feature-start"
   |
[구현] --> /checkpoint create "core-done"
   |
[테스트] --> /checkpoint verify "core-done"
   |
[리팩토링] --> /checkpoint create "refactor-done"
   |
[PR] --> /checkpoint verify "feature-start"

参数¶

$ARGUMENTS: - create <name> - 创建指定名称的 checkpoint - verify <name> - 对照指定名称的 checkpoint 进行验证 - list - 显示所有 checkpoint - clear - 移除较早的 checkpoint（仅保留最近 5 个）