checkpoint

/checkpoint

是什么

快速的会话中途保存，用两步保存已验证可用的状态：

1. 描述性 git 提交 — 暂存相关更改并提交，提交消息概述所做工作。
2. 简短交接记录 — 写入 .claude/handoff.md，让恢复的会话（或经历糟糕的重构后回来的你）准确了解当前进展。

Checkpoint 是会话中途保存；/wrap-up 是会话结束时的流程。Checkpoint 会提交更改并记下简短记录，然后继续工作。Wrap-up 则会完成完整交接，并将经验提取到 MEMORY.md 中。

适用时机

• 进行有风险的重构或破坏性更改之前 — 保存已验证可用的状态
• 会话中途切换到其他任务或功能时
• 完成一个逻辑工作单元后 — 保存进度
• 用户说“checkpoint”“save progress”“save state”或“pause here”时
• 如果会话确实要结束，请使用 /wrap-up 完成完整流程

操作方法

1. 评估状态 — 使用 git status 和 git diff 查看已暂存和未暂存的更改。
2. 暂存更改 — 暂存特定文件；绝不要使用 git add -A。排除生成文件、构建产物和机密信息（.env、凭据）。
3. 提交 — 按照仓库的提交风格撰写描述性消息（常见前缀：feat:、fix:、refactor:）。创建新提交，绝不 amend。如果没有可提交的内容，则跳到交接记录。
4. 编写交接记录 — 写入 .claude/handoff.md，格式与 /wrap-up 相同，但内容更简短：Completed、Pending（包含具体的后续步骤）、Learned（仅在出现了非显而易见的发现时填写）和 Context（分支 + 提交哈希）。始终只使用一个文件，并覆盖原有内容。
5. 确认 — 报告提交哈希和交接摘要，然后继续工作。

安全规则

• 绝不推送、强制推送或操作远程分支
• 绝不提交机密信息
• 绝不 amend — checkpoint 应创建一个可供返回的新提交
• 没有可提交的更改？仅更新交接记录

示例

User: /checkpoint — about to try the EF Core split-query refactor

Claude: 3 files modified, 1 new.

  Commit a1b2c3d: "feat: add CreateOrder validation with FluentValidation"
  - src/Orders/Features/CreateOrder.cs
  - src/Orders/Features/CreateOrderValidator.cs (new)
  - tests/Orders.Tests/Features/CreateOrderTests.cs

  Handoff updated (.claude/handoff.md):
  ## Completed
  - [x] CreateOrder validation + 3 test scenarios
  ## Pending
  - [ ] Split-query refactor in GetOrderDetails (about to attempt)
  ## Context
  - Branch: feature/order-validation | Checkpoint: a1b2c3d

  Checkpoint saved — safe to proceed with the risky refactor.

相关内容

• /wrap-up — 会话结束流程：完整交接格式定义，并将经验提取到 MEMORY.md
• /build-fix — 在 checkpoint 之前确保构建通过