checkpoint

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Save Memory Checkpoint

保存内存检查点

Save current analysis, findings, and progress to an external memory file to prevent context loss during long-running tasks.

将当前分析结果、发现和进度保存到外部内存文件，防止长时间运行任务期间丢失上下文。

Summary

摘要

Goal: Persist current task context, findings, and progress to a checkpoint file for recovery after context compaction.

Step	Action	Key Notes
1	Determine location	Filename: `plans/reports/checkpoint-{YYMMDD-HHMM}-{slug}.md`
2	Gather context	Task, findings, files analyzed/modified, progress, decisions
3	Write checkpoint file	Structured markdown with recovery instructions
4	Update todo list	Mark checkpoint creation complete

Key Principles:

Save checkpoints every 30-60 minutes during complex tasks
Include file paths, line numbers, and exact findings -- be specific
Always include recovery instructions for easy task resumption

目标： 持久化保存当前任务上下文、发现和进度到检查点文件，以便在上下文压缩后恢复。

步骤	操作	关键说明
1	确定存储位置	文件名： `plans/reports/checkpoint-{YYMMDD-HHMM}-{slug}.md`
2	收集上下文	任务、发现、已分析/修改的文件、进度、决策
3	写入检查点文件	带有恢复说明的结构化markdown
4	更新待办列表	标记检查点创建完成

核心原则：

执行复杂任务时每30-60分钟保存一次检查点
包含文件路径、行号和确切发现——内容要具体
始终包含恢复说明，方便后续恢复任务

Usage

使用场景

Use this command when:

Working on complex multi-step tasks (investigation, planning, implementation)
Before expected context compaction
At key milestones during feature development
After completing significant analysis phases

在以下情况使用本命令：

处理复杂的多步骤任务时（调研、规划、实现）
预计会发生上下文压缩之前
功能开发的关键里程碑节点
完成重要的分析阶段之后

Checkpoint File Location

检查点文件存储位置

Files are saved to:

plans/reports/checkpoint-{timestamp}-{slug}.md

文件保存到：

plans/reports/checkpoint-{timestamp}-{slug}.md

Instructions

使用说明

Create a checkpoint file with the following structure:

按照以下结构创建检查点文件：

Step 1: Determine Checkpoint Location

步骤1：确定检查点存储位置

bash

undefined

bash

undefined

Get current date for filename

date +%y%m%d-%H%M

undefined

date +%y%m%d-%H%M

undefined

Step 2: Gather Context

步骤2：收集上下文

Collect and document:

Current Task - What are you working on?
Key Findings - What have you discovered?
Files Analyzed - Which files have been read/modified?
Progress Summary - What's completed vs remaining?
Important Context - Critical information to preserve
Next Steps - What should be done next?
Open Questions - Unresolved issues

收集并记录：

当前任务 - 你正在处理什么工作？
关键发现 - 你有什么新发现？
已分析文件 - 哪些文件已被读取/修改？
进度汇总 - 已完成和待完成的工作分别是什么？
重要上下文 - 需要留存的关键信息
后续步骤 - 接下来要做什么？
待解决问题 - 尚未解决的问题

Step 3: Write Checkpoint File

步骤3：写入检查点文件

Create a markdown file at

plans/reports/checkpoint-YYMMDD-HHMM-{task-slug}.md

with:

markdown

undefined

在

plans/reports/checkpoint-YYMMDD-HHMM-{task-slug}.md

路径下创建markdown文件，内容如下：

markdown

undefined

Memory Checkpoint: [Task Description]

Checkpoint created to preserve analysis context during [task type].

Session Info

Created: [timestamp]
Task: [description]
Branch: [git branch]
Phase: [current phase]

Created: [timestamp]
Task: [description]
Branch: [git branch]
Phase: [current phase]

Current Task Summary

[Brief description of what you're working on]

Key Findings

Analysis Results

[Finding 1]
[Finding 2]
[Finding N]

[Finding 1]
[Finding 2]
[Finding N]

Patterns Discovered

[Pattern 1]
[Pattern 2]

[Pattern 1]
[Pattern 2]

Dependencies Identified

[Dependency 1]
[Dependency 2]

[Dependency 1]
[Dependency 2]

Files Context

Analyzed Files

File	Purpose	Relevance
path/to/file.cs	[purpose]	High/Medium/Low

File	Purpose	Relevance
path/to/file.cs	[purpose]	High/Medium/Low

Modified Files

```
path/to/modified.ts
```
- [change description]

```
path/to/modified.ts
```
- [change description]

Pending Files

```
path/to/pending.cs
```
- [why pending]

```
path/to/pending.cs
```
- [why pending]

Progress Summary

Completed

[Completed item 1]
[Completed item 2]

[Completed item 1]
[Completed item 2]

In Progress

[Current item]

[Current item]

Remaining

[Remaining item 1]
[Remaining item 2]

[Remaining item 1]
[Remaining item 2]

Important Context

Critical Information

[Information that must not be lost]

Assumptions Made

[Assumption 1]
[Assumption 2]

[Assumption 1]
[Assumption 2]

Decisions Made

[Decision 1] - [rationale]
[Decision 2] - [rationale]

[Decision 1] - [rationale]
[Decision 2] - [rationale]

Next Steps

[Immediate next action]
[Following action]
[Subsequent action]

[Immediate next action]
[Following action]
[Subsequent action]

Open Questions

[Question 1]
[Question 2]

[Question 1]
[Question 2]

Recovery Instructions

To resume this task after context reset:

Read this checkpoint file
Review [specific files] for context
Continue from [specific point]

Checkpoint saved by Claude Code at [timestamp]

undefined

To resume this task after context reset:

Read this checkpoint file
Review [specific files] for context
Continue from [specific point]

Checkpoint saved by Claude Code at [timestamp]

undefined

Step 4: Update Todo List

步骤4：更新待办列表

Update your todo list to reflect checkpoint was created:

- [x] Create memory checkpoint at [timestamp]

更新你的待办列表，标记检查点已创建：

- [x] Create memory checkpoint at [timestamp]

Best Practices

最佳实践

Save checkpoints frequently - Every 30-60 minutes during complex tasks
Be specific - Include file paths, line numbers, exact findings
Document decisions - Record why choices were made
Link related files - Reference other analysis documents
Include recovery steps - Make resumption easy

频繁保存检查点 - 处理复杂任务时每30-60分钟保存一次
内容具体 - 包含文件路径、行号、确切的发现结果
记录决策 - 记录做出各项选择的原因
关联相关文件 - 引用其他分析文档
包含恢复步骤 - 方便后续恢复任务

Related Commands

IMPORTANT Task Planning Notes

重要任务规划说明

Always plan and break many small todo tasks
Always add a final review todo task to review the works done at the end to find any fix or enhancement needed

始终将任务拆解为多个小型待办事项
始终添加最终复盘待办项，在任务末尾回顾已完成工作，查找需要修复或优化的内容

checkpoint

Original

Translation

Save Memory Checkpoint

保存内存检查点

Summary

摘要

Usage

使用场景

Checkpoint File Location

检查点文件存储位置

Instructions

使用说明

Step 1: Determine Checkpoint Location

步骤1：确定检查点存储位置

Get current date for filename

Get current date for filename

Step 2: Gather Context

步骤2：收集上下文

Step 3: Write Checkpoint File

步骤3：写入检查点文件

Memory Checkpoint: [Task Description]

Memory Checkpoint: [Task Description]

Session Info

Session Info

Current Task Summary

Current Task Summary

Key Findings

Key Findings

Analysis Results

Analysis Results

Patterns Discovered

Patterns Discovered

Dependencies Identified

Dependencies Identified

Files Context

Files Context

Analyzed Files

Analyzed Files

Modified Files

Modified Files

Pending Files

Pending Files

Progress Summary

Progress Summary

Completed

Completed

In Progress

In Progress

Remaining

Remaining

Important Context

Important Context

Critical Information

Critical Information

Assumptions Made

Assumptions Made

Decisions Made

Decisions Made

Next Steps

Next Steps

Open Questions

Open Questions

Recovery Instructions

Recovery Instructions

Step 4: Update Todo List

步骤4：更新待办列表

Best Practices

最佳实践

Related Commands

相关命令

IMPORTANT Task Planning Notes

重要任务规划说明