mirror of
https://github.com/sweetwisdom/everything-claude-code-zh.git
synced 2026-03-21 22:10:09 +00:00
75 lines
1.7 KiB
Markdown
75 lines
1.7 KiB
Markdown
# 检查点（Checkpoint）指令
|
||
|
||
在工作流（Workflow）中创建或验证检查点。
|
||
|
||
## 用法
|
||
|
||
`/checkpoint [create|verify|list] [name]`
|
||
|
||
## 创建检查点（Create Checkpoint）
|
||
|
||
创建检查点时：
|
||
|
||
1. 运行 `/verify quick` 以确保当前状态干净
|
||
2. 使用检查点名称创建一个 git stash 或提交（Commit）
|
||
3. 将检查点记录到 `.claude/checkpoints.log`：
|
||
|
||
```bash
|
||
echo "$(date +%Y-%m-%d-%H:%M) | $CHECKPOINT_NAME | $(git rev-parse --short HEAD)" >> .claude/checkpoints.log
|
||
```
|
||
|
||
4. 报告检查点已创建
|
||
|
||
## 验证检查点（Verify Checkpoint）
|
||
|
||
对比检查点进行验证时：
|
||
|
||
1. 从日志中读取检查点
|
||
2. 将当前状态与检查点进行对比：
|
||
- 自检查点以来新增的文件
|
||
- 自检查点以来修改的文件
|
||
- 当前与当时的测试通过率对比
|
||
- 当前与当时的代码覆盖率对比
|
||
|
||
3. 报告：
|
||
```
|
||
CHECKPOINT COMPARISON: $NAME
|
||
============================
|
||
Files changed: X
|
||
Tests: +Y passed / -Z failed
|
||
Coverage: +X% / -Y%
|
||
Build: [PASS/FAIL]
|
||
```
|
||
|
||
## 列出检查点（List Checkpoints）
|
||
|
||
显示所有检查点，包括：
|
||
- 名称
|
||
- 时间戳
|
||
- Git SHA
|
||
- 状态（当前、落后、超前）
|
||
|
||
## 工作流（Workflow）
|
||
|
||
典型的检查点工作流：
|
||
|
||
```
|
||
[Start] --> /checkpoint create "feature-start"
|
||
|
|
||
[Implement] --> /checkpoint create "core-done"
|
||
|
|
||
[Test] --> /checkpoint verify "core-done"
|
||
|
|
||
[Refactor] --> /checkpoint create "refactor-done"
|
||
|
|
||
[PR] --> /checkpoint verify "feature-start"
|
||
```
|
||
|
||
## 参数（Arguments）
|
||
|
||
$ARGUMENTS:
|
||
- `create <name>` - 创建具名检查点
|
||
- `verify <name>` - 对比指定的检查点进行验证
|
||
- `list` - 显示所有检查点
|
||
- `clear` - 移除旧检查点（保留最后 5 个）
|