写 Continue Here
写结构化延续文件,使下次会话以完整上下文开始。
适用场景
- 结束仍有进行中工作的会话
- 在会话间交接复杂任务
- 保留 git 无法捕获的意图、失败方法和下一步
- 在任务中关闭 Claude Code 之前
输入
- 必需:带近期工作要汇总的活跃会话
- 可选:关于在交接中强调什么的具体指令
步骤
第 1 步:评估会话状态
收集关于近期工作的事实:
git log --oneline -5
git status
git diff --stat
审查对话上下文:目标是什么、已完成什么、什么部分完成、什么尝试且失败、做了哪些决策。
预期结果: 对当前任务状态的清晰理解 —— 完成项、进行中项和计划下一步。
失败处理: 若不在 git 仓库,跳过 git 命令。延续文件仍可捕获对话上下文和任务状态。
第 2 步:写 CONTINUE_HERE.md
将文件写到项目根,使用以下结构。每个部分必须包含可执行内容,非占位符。
# Continue Here
> Last updated: YYYY-MM-DDTHH:MM:SSZ | Branch: current-branch-name
## Objective
One-paragraph description of what we are trying to accomplish and why.
## Completed
- [x] Finished item with key file paths (e.g., `src/feature.R`)
- [x] Decisions made and their rationale
## In Progress
- [ ] Partially complete work — describe current state (branch, file:line)
- [ ] Known issues with partial work
## Next Steps
1. Immediate next action (most important)
2. Subsequent actions in priority order
3. **[USER]** Items needing user input or decision
## Context
- Failed approaches and why they did not work
- Key constraints or trade-offs discovered
- Relevant issue/PR links
指南:
- Objective:捕捉 WHY —— git log 显示什么变了,不是为什么
- Completed:清晰标记已完成项以防止重做
- In Progress:这是最高价值部分 —— 部分状态最难重建
- Next Steps:按优先级编号。用户依赖项前缀
**[USER]** - Context:记录否定空间 —— 什么被尝试和拒绝以及为什么
预期结果: 项目根的 CONTINUE_HERE.md 文件,所有 5 个部分都填充当前会话的真实内容。时间戳和分支准确。
失败处理: 若 Write 失败,检查文件权限。文件应在项目根创建(与 .git/ 同目录)。验证 .gitignore 包含 CONTINUE_HERE.md —— 若否,添加它。
第 3 步:验证文件
读回 CONTINUE_HERE.md 并确认:
- 时间戳是最近的(过去几分钟内)
- 分支名匹配
git branch --show-current - 所有 5 个部分包含真实内容(无模板占位符)
- Next Steps 按编号且可执行
- In Progress 项足够具体描述当前状态以恢复
预期结果: 文件读起来像清晰、可执行的交接,新会话可立即用它恢复工作。
失败处理: 编辑包含占位文本或太模糊的部分。每个部分应通过测试:"新会话能根据此行动而无需澄清问题吗?"
验证清单
- CONTINUE_HERE.md 在项目根存在
- 文件包含所有 5 个部分附真实内容(非占位符)
- 时间戳和分支准确
-
.gitignore包括CONTINUE_HERE.md - Next Steps 按编号且可执行
- In Progress 项指定足够细节以无问题恢复
常见问题
- 写占位符而非内容:"TODO: fill in later" 违背目的。每个部分必须包含当前会话的真实信息。
- 重复 git 状态:不要列出每个改变文件 —— git 已跟踪。专注意图、部分状态和下一步。
- 遗忘 Context 部分:失败方法是最有价值的记录。没有它们,下次会话会重试相同死路。
- 未读就覆写:若 CONTINUE_HERE.md 已存在自先前会话,先读它 —— 它可能包含早期交接的未完成工作。
- 留下陈旧文件:CONTINUE_HERE.md 短暂。下次会话消费后,删除它。陈旧文件导致混淆。
相关技能
read-continue-here—— 互补:在会话开始读取并根据延续文件行动bootstrap-agent-identity—— 冷启动身份重建,消费此技能产出的延续文件manage-memory—— 持久跨会话知识(补充此短暂交接)commit-changes—— 写延续文件前将工作保存到 gitwrite-claude-md—— 可选延续指南所在的项目指令