---

name: write-continue-here description: > 写一个 CONTINUE_HERE.md 文件捕捉当前会话状态，使新的 Claude Code 会话 能从此次中断处接续。涵盖评估近期工作、用 objective、completed、in-progress、 next-steps 和 context 部分构造延续文件，并验证文件可执行。在结束有未完成 工作的会话、在会话间交接上下文，或保留 git 单独无法捕获的任务状态时使用。 license: MIT allowed-tools: Read Write Bash Grep Glob metadata: author: Philipp Thoss version: "1.0" domain: general complexity: basic language: multi tags: session, continuity, handoff, context, workflow, write locale: zh-CN source_locale: en source_commit: 025eea68 fence_basis_commit: 025eea68 translator: "Claude + human review" translation_date: "2026-05-03"

写 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 —— 写延续文件前将工作保存到 git
• write-claude-md —— 可选延续指南所在的项目指令