SuperAPI AI 工具集

handoff

编程与开发

查看项目

更新于 10-16 05:58

技能介绍

用途

handoff 用于解决跨会话上下文丢失的问题。当用户在 Claude Code 会话中输入 /handoff 时,技能会重新阅读当前对话,提取关键信息,生成一条可粘贴到全新会话中的交接消息,使新会话能够准确接续之前的工作,无需反复确认"我们之前在做什么"。

主要能力

该技能会在内心将当前对话拆分为四个部分:

  • 目标(goal):用户在当前会话中最终想完成的事情
  • 状态(state):已经完成、决定或构建的内容
  • 下一步(next move):调用 /handoff 时即将执行的动作
  • 陷阱(traps):尝试过但未成功的方案、死路以及下一个会话需要知道的注意事项

随后按固定模板生成交接消息,并以单个围栏代码块输出,便于一键复制。

使用方式

输入 /handoff 后,技能按以下流程工作:

  1. 重新阅读当前对话上下文,分离目标、状态、下一步与陷阱。
  2. 按模板填写交接消息,以单个围栏代码块输出,保证可一键复制。
  3. 自动将交接文本复制到系统剪贴板,按平台选择命令:
    • macOS:pbcopy
    • Linux:xclip -selection clipboard 或 wl-copy(Wayland)
    • Windows(WSL 或 Git Bash):clip.exe
  4. 检测平台并使用对应命令;若都不可用则静默跳过,用户仍可从代码块手动复制。
  5. 最后以一行简短信息结尾:"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 构建。