SuperAPI AI 工具集

session-handoff

办公与效率

查看项目

更新于 10-23 12:29

技能介绍

用途

Session Handoff 用于在结束一段 AI 编程代理会话前,生成一份可重复、可交接的收尾摘要。目标是让用户放心执行 /clear 并开启新会话,而新的代理只需阅读这份摘要即可无缝接续工作。它明确定位为“上下文交接产物”而非状态汇报,受众是未来的代理实例,不是利益相关方。

主要能力

  • 识别触发语句,如 session handoff、wrap up session、hand off、handoff summary、let's wrap up、summarize before I clear 等近似表达;若用户表示即将 /clear 却尚未运行,也会主动调用。
  • 通读完整对话,而非只总结最近几轮,避免遗漏早期上下文。
  • 按顺序从以下来源提取状态:本次会话引用的计划文件(若提到计划,会检查 ~/.claude/plans/)、任务列表(含进行中与待办任务,包括目标计量计划)、通过 run_in_background 启动的后台进程(Shell ID 对下一个代理至关重要)、本次创建或修改的文件、写入或更新的记忆文件(~/.claude/projects/<project>/memory/)、未解决的问题(问用户但未获明确答复的问题,或被回避的用户提问)。
  • 不做文件系统审计:不运行 git log、不做大范围 Glob 扫描,只综合本次会话实际发生的事。

使用方式

调用后直接在聊天中输出摘要,不写文件、不更新记忆。输出严格使用固定模板,各节不可省略,无内容时写“none”:

  • 标题:Session Handoff: <本次会话一句话标题>
  • Where it started:2-3 句说明用户请求及关键约束。
  • Decisions locked + what shipped:决策或变更、原因及其位置(文件给绝对路径)。
  • Key files for next session:绝对路径及为何优先阅读;若由计划驱动,计划文件列首位;列出涉及的记忆文件。
  • Running state:后台进程(Shell ID、用途、终止命令)、开发服务器与端口、打开的工作树/分支,无则写 none。
  • Verification:验证命令及预期结果。
  • Deferred + open questions:延后事项及原因、待用户输入的问题及背景。
  • Pick up here:1-2 句指出新代理最可能的下一步动作。

适用场景

适用于使用 Claude Code 等 AI 编程代理进行较长或较复杂开发会话后,需要清空上下文、切换到新会话、交接给另一实例或结束当班工作的情形。适合涉及计划文件、后台进程、多文件改动的会话。

限制与规则

  • 仅聊天输出,禁止写入文件(包括 ~/.claude/handoffs/ 等),禁止借该技能更新记忆。
  • 不得虚构状态;无内容的分节写 none 而非删除,结构稳定是核心。
  • 始终使用绝对路径,因下一个代理的工作目录可能不同。
  • 如果有计划文件驱动会话,必须在 Key files 中首先列出。
  • 不使用表情符号、不写夸张褒扬,语气简洁具体,如资深工程师交接班。
  • 后台进程 ID 必须出现在 Running state 并附终止命令。
  • 反模式:只总结最近 3 轮、使用相对路径、因“没有进程在跑”而跳过 Running state、把摘要写入文件、添加“做得好/做得差”复盘、在 Pick up here 之外推荐下一步。

补充说明

资料提到 Cache Keeper 的交接按钮与 /handoff 命令会运行此技能,随后提供清空聊天并将交接内容作为新聊天首条提示的选项。安装命令、价格与平台支持等信息暂未提供。