| name | context-checkpoint |
| description | 在长对话中创建检查点，保存任务状态和关键信息，帮助在新对话中快速恢复工作进度。触发场景：用户说「创建检查点」「保存进度」「对话太长了」「上下文快满了」，或长时间对话后需要开始新会话。 |
Context Checkpoint - 上下文检查点管理器
Overview
在长对话中创建"检查点"，智能总结当前任务状态、已完成工作和待办事项，生成可在新对话中快速恢复的文档和指令。
Core Workflow
1. 分析当前状态
- 回顾对话历史，识别关键决策和成果
- 列出已完成的任务和待办事项
- 整理重要的技术细节和约束条件
- 记录项目当前阶段和目标
2. 生成检查点文档
- 创建结构化的状态文档
- 保存到
.claude/checkpoints/checkpoint-[时间戳].md
- 包含项目概况、已完成工作、待办事项、关键决策
3. 输出恢复指令
- 生成简洁的恢复提示词
- 提供文件路径引用
- 包含快速启动指令
Checkpoint Document Structure
检查点文档包含以下核心部分：
# 检查点 - [YYYY-MM-DD HH:MM]
## 项目概况
- 项目名称：[项目名称]
- 当前阶段：[开发/测试/部署等]
- 主要目标：[简要描述项目目标]
## 已完成工作
1. [任务1] - 完成情况和关键成果
2. [任务2] - 完成情况和关键成果
## 待办事项
- [ ] [任务1] - 优先级：高/中/低
- [ ] [任务2] - 优先级：高/中/低
## 关键决策
- [决策1]：原因和影响
- [决策2]：原因和影响
## 技术细节
- 技术栈：[列出使用的技术]
- 重要配置：[关键配置信息]
- 已知问题：[需要注意的问题]
## 下一步行动
1. [具体行动1]
2. [具体行动2]
## 恢复指令
\`\`\` 我正在继续之前的工作。请阅读检查点文档：#file:.claude/checkpoints/checkpoint-[时间戳].md
当前需要继续：[具体任务描述] \`\`\`
Usage Examples
示例 1：长对话需要压缩
用户：「对话太长了，帮我创建一个检查点」
Claude 执行：
- 分析当前对话，提取关键信息
- 创建检查点文档
.claude/checkpoints/checkpoint-2026-03-15-16-30.md
- 输出恢复提示词供新对话使用
示例 2：完成阶段性工作
用户：「我们完成了用户管理模块，创建个检查点吧」
Claude 执行：
- 总结用户管理模块的完成情况
- 记录技术实现细节和关键决策
- 列出下一步要做的其他模块
- 生成检查点文档
Best Practices
- 定期创建检查点：每完成一个重要阶段就创建一次
- 清晰的命名：使用时间戳确保唯一性
- 精简信息：只保存关键内容，避免冗余
- 测试恢复：创建检查点后，可以测试恢复流程是否顺畅
When to Create Checkpoint
- 对话超过 50 轮或感觉开始变慢
- 完成了一个重要的功能模块
- 需要切换到其他任务
- 准备结束当前会话
- 项目进入新的阶段
Notes
- 检查点文档保存在
.claude/checkpoints/ 目录
- 建议在
.gitignore 中添加此目录（避免提交临时文件）
- 定期清理旧的检查点文档
- 不要在检查点中保存敏感信息（密码、密钥等）
