context-checkpoint

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 执行：

1. 分析当前对话，提取关键信息
2. 创建检查点文档 .claude/checkpoints/checkpoint-2026-03-15-16-30.md
3. 输出恢复提示词供新对话使用

示例 2：完成阶段性工作

用户：「我们完成了用户管理模块，创建个检查点吧」

Claude 执行：

1. 总结用户管理模块的完成情况
2. 记录技术实现细节和关键决策
3. 列出下一步要做的其他模块
4. 生成检查点文档

Best Practices

1. 定期创建检查点：每完成一个重要阶段就创建一次
2. 清晰的命名：使用时间戳确保唯一性
3. 精简信息：只保存关键内容，避免冗余
4. 测试恢复：创建检查点后，可以测试恢复流程是否顺畅

When to Create Checkpoint

• 对话超过 50 轮或感觉开始变慢
• 完成了一个重要的功能模块
• 需要切换到其他任务
• 准备结束当前会话
• 项目进入新的阶段

Notes

• 检查点文档保存在 .claude/checkpoints/ 目录
• 建议在 .gitignore 中添加此目录（避免提交临时文件）
• 定期清理旧的检查点文档
• 不要在检查点中保存敏感信息（密码、密钥等）