# Context Checkpoint

> 在长对话中创建检查点，保存任务状态和关键信息，帮助在新对话中快速恢复工作进度。触发场景：用户说「创建检查点」「保存进度」「对话太长了」「上下文快满了」，或长时间对话后需要开始新会话。

- Skill: `wang-q-l/context-checkpoint` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add wang-q-l/context-checkpoint`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wang-q-l/context-checkpoint/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wang-q-l (https://skillmd.com/u/wang-q-l)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wang-q-l/context-checkpoint

---


# Context Checkpoint - 上下文检查点管理器

## Overview

在长对话中创建"检查点"，智能总结当前任务状态、已完成工作和待办事项，生成可在新对话中快速恢复的文档和指令。

## Core Workflow

### 1. 分析当前状态

- 回顾对话历史，识别关键决策和成果
- 列出已完成的任务和待办事项
- 整理重要的技术细节和约束条件
- 记录项目当前阶段和目标

### 2. 生成检查点文档

- 创建结构化的状态文档
- 保存到 `.claude/checkpoints/checkpoint-[时间戳].md`
- 包含项目概况、已完成工作、待办事项、关键决策

### 3. 输出恢复指令

- 生成简洁的恢复提示词
- 提供文件路径引用
- 包含快速启动指令

## Checkpoint Document Structure

检查点文档包含以下核心部分：

```markdown
# 检查点 - [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` 中添加此目录（避免提交临时文件）
- 定期清理旧的检查点文档
- 不要在检查点中保存敏感信息（密码、密钥等）