用途
handoff 用于解决跨会话上下文丢失的问题。当用户在 Claude Code 会话中输入 /handoff 时,技能会重新阅读当前对话,提取关键信息,生成一条可粘贴到全新会话中的交接消息,使新会话能够准确接续之前的工作,无需反复确认"我们之前在做什么"。
主要能力
该技能会在内心将当前对话拆分为四个部分:
- 目标(goal):用户在当前会话中最终想完成的事情
- 状态(state):已经完成、决定或构建的内容
- 下一步(next move):调用 /handoff 时即将执行的动作
- 陷阱(traps):尝试过但未成功的方案、死路以及下一个会话需要知道的注意事项
随后按固定模板生成交接消息,并以单个围栏代码块输出,便于一键复制。
使用方式
输入 /handoff 后,技能按以下流程工作:
- 重新阅读当前对话上下文,分离目标、状态、下一步与陷阱。
- 按模板填写交接消息,以单个围栏代码块输出,保证可一键复制。
- 自动将交接文本复制到系统剪贴板,按平台选择命令:
- macOS:pbcopy
- Linux:xclip -selection clipboard 或 wl-copy(Wayland)
- Windows(WSL 或 Git Bash):clip.exe
- 检测平台并使用对应命令;若都不可用则静默跳过,用户仍可从代码块手动复制。
- 最后以一行简短信息结尾:"Copied. Paste this into a fresh session."(若剪贴板工具不可用则输出 "Ready to copy from the block above.")。
响应结构被限定为:一个包含已填写交接模板的围栏代码块、一条平台感知的剪贴板复制命令、一行确认剪贴板复制的结束语,除此之外不加任何前言或后记。
交接模板结构
模板要求填写每个部分,保持精炼,确实不适用时写 n/a 而非删除该部分:
- What I'm trying to do:1-3 句话说明总体目标
- Where we left off:当前状态的要点列表(创建/修改的文件、已做出的决定、可用部分、半成品)
- Key files & paths:下一个会话需要读取或编辑的文件的绝对路径,每项附一行说明
- What was just about to happen:调用 /handoff 时排队的下一步
- Things that already failed / dead ends:已尝试但无效的方法、遇到的错误或注意事项,避免下一个会话重复;若无则写 n/a
- Important context the next Claude needs:本次会话浮现的用户偏好、外部 ID、账号 ID、URL、凭据位置、尚未保存的进行中决策
- Pick up by:下一个会话的具体第一步动作
规则
- 要具体:例如"在 src/app/page.tsx 编辑 hero 文案以测试新标题变体,当前草稿在第 42 行",而非"我们在做落地页"。
- 包含绝对文件路径,方便下一个会话直接读取。
- 对 ID、URL、错误消息和凭据位置引用精确字符串,避免转述造成信息丢失。
- 不重述 CLAUDE.md 或持久记忆文件内容;下一个会话会自动加载它们。只有当这些内容在本次会话被覆盖或矛盾时才提及。
- 控制在约 400 字以内,详尽而不臃肿;接近 500 字通常说明包含了下个 Claude 可自行推导的内容。
- 不包含本次会话的工具调用噪音;总结结果而非到达结果的过程。
适用场景
适用于需要长时间、多轮推进的 Claude Code 编程或自动化任务,在会话即将结束或需要换新会话继续时使用,尤其适合需要保留文件路径、决定、错误信息和下一步动作的复杂工作。
限制
- 输入长度限制为约 400 字,内容过多时需取舍。
- 剪贴板复制依赖平台命令,若均不可用则需手动复制。
- 模板包含若干未提供示例或补充说明的字段,具体实现细节暂未提供。
其他
由 @tenfoldmarc 构建。