context-handoff

用途

Context Handoff 用于解决在 Claude Code 中长对话上下文即将占满、需要切换任务或想要一个干净起点时，进度和决策信息丢失的问题。它把当前对话的全部上下文提炼为一份结构化的交接文档，使后续对话（或新的 Claude 实例）能够精确地从中断处继续，做到信息零丢失。

主要能力

该技能的核心是 /whats-next 命令。它分析当前对话并生成一份全面的交接文档，内容涵盖六个部分：

Original Task（原始任务）：最初被请求的任务，精确标注范围，不含新增范围或附带任务。
Work Completed（已完成工作）：详细记录所有已完成事项，包括创建、修改或分析的所有产物（文件、文档、研究发现等）、具体改动（带行号的代码、撰写的内容、分析的数据等）、执行的操作（运行的命令、调用的 API、执行的搜索、使用的工具等）、发现的结论（洞察、模式、答案、数据点等），以及做出的决策及其理由。
Work Remaining（剩余工作）：明确列出仍需完成的事项，拆解为具体可执行的步骤，包含精确的位置、引用或目标（文件路径、URL、数据源等），注明依赖、前置条件和顺序要求，以及所需的验证步骤。
Attempted Approaches（尝试过的方法）：记录所有尝试过的方案，包括失败的部分，如未成功的方法及原因、遇到的错误和阻塞、发现的限制、应避免重蹈的死路，以及考虑过但未采用的替代方案。
Critical Context（关键上下文）：保留所有必要知识，包括关键决策与权衡、约束、需求或边界，重要发现、坑点、边界情况或非显而易见的行为，相关的环境与配置细节，需要验证的假设，以及所查阅文档、来源或资源的引用。
Current State（当前状态）：记录交付物的精确状态（已完成、进行中、未开始），哪些已提交或定稿、哪些是临时或草稿，是否存在临时改动或变通方案、未决问题，以及当前处于工作流或流程中的哪个位置。

该技能优先级明确：全面细节与精确性高于简洁。细节程度会根据任务类型（编码、研究、分析、写作、配置等）自适应，但保持全面覆盖。

输出格式

文档写入当前工作目录下的 whats-next.md，采用 XML 标签结构组织六个部分：

<original_task>
[最初请求的具体任务 - 精确说明范围]
</original_task>

<work_completed>
[全面记录所有已完成事项]
</work_completed>

<work_remaining>
[详细拆解待完成事项]
</work_remaining>

<attempted_approaches>
[所有尝试，包括失败]
</attempted_approaches>

<critical_context>
[继续工作所需的全部必要知识]
</critical_context>

<current_state>
[工作的精确状态]
</current_state>

文档以具体内容片段为例，展示了各部分条目通常包含文件路径加行号（如 middleware/auth.ts:1-45）、命令与配置说明、以及决策理由等。

使用方式

安装（全局，安装后可在任意目录使用）：

cp whats-next.md ~/.claude/commands/

命令在任意位置可用，每个项目会在其工作目录中生成自己的 whats-next.md。

当前对话结束时：

You: /whats-next
Claude: [分析对话，写入 whats-next.md]
✓ Created whats-next.md - reference with @whats-next.md in a new chat to continue

新对话开始时：

You: @whats-next.md continue this work
Claude: [读取交接文档，理解上下文，继续工作]

适用场景

上下文即将占满或变得杂乱时
需要切换任务、或想以干净状态重新开始时
需要在同一天内稍后继续同一项工作（如午休后继续）
与 /add-to-todos 配合进行长期任务跟踪：whats-next.md 用于即时续接，TO-DOS.md 用于长期待办

限制与注意事项

该文件每次都会被覆盖，它是快照而非日志。
工作完成后应删除 whats-next.md。
命令由 /whats-next 触发，需在新对话中以 @whats-next.md 引用。
该技能依赖 Claude Code 的命令机制，安装路径为 ~/.claude/commands/。
未提供关于收费、价格、平台支持范围或性能效果的信息。

引用文档

以下为作者声明的引用来源，保留指定版本、署名和许可。

作者的来源声明

glittercowboy/taches-cc-resources/commands/whats-next.md — 署名：TÂCHES；许可：MIT；版本：0d915b80b95f9889673e1dc6a9059ed239764cde。
glittercowboy/taches-cc-resources/docs/context-handoff.md — 署名：TÂCHES；许可：MIT；版本：0d915b80b95f9889673e1dc6a9059ed239764cde。