SuperAPI AI 工具集

session-handoff

办公与效率

查看项目

更新于 10-15 11:32

技能介绍

Session Handoff 用于把当前对话状态保存到磁盘,以便之后的会话能够带着完整上下文恢复。它把快照写入 .artifacts/.session-handoff.md,并提供三种操作:save、load、clear。

用途

当一次会话需要中断、切换任务或稍后继续时,使用该技能保存当前进展,避免上下文丢失。恢复时读取最新快照,即可知道此前在做什么、下一步该做什么、以及应该调用哪个技能。

主要能力

  • save:在 .artifacts/.session-handoff.md 顶部追加一条快照。
  • load:读取 .artifacts/.session-handoff.md,最新快照位于顶部。
  • clear:用空内容覆盖 .artifacts/.session-handoff.md。

触发方式

保存类触发词包括 “save context”“dump conversation”“checkpoint this”“session handoff”“save handoff”,对应 save.md。

加载类触发词包括 “resume session”“load handoff”“continue from last”,对应 load.md。

清除类触发词包括 “clear handoff”“reset handoff”。

Clear 的行为

向 .artifacts/.session-handoff.md 写入空内容。不要删除该文件——空文件在下次加载时会被视为不存在,而写入可以避免触发 Bash 权限提示。当文件本就不存在时,静默无操作。

使用准则

  • 快照追加到顶部,绝不追加到底部,保证最新内容始终在最前。
  • 每次保存只写一条快照,不要跨多次保存合并。
  • 文件不存在时静默跳过操作(load 和 clear 均为无操作)。
  • 只保存尚未进入已提交产物的内容:当前焦点、未解决的线索、下一步、值得保留的决策与发现。

反模式:重复已有产物

如果快照重复了磁盘产物、提交、PR、issue 或文档中已经记录的内容,就会浪费空间。交接应承载只存在于对话中的上下文:未解决的线索、临时做出的决策、从哪里继续、下一步调用哪个技能。任何已经持久化到别处的内容,应以路径或 URL 引用,而不是复制。

反模式:保存时覆盖

每次保存都会在顶部前置一个新的带日期区块。覆盖会破坏此前的快照,而那些快照可能仍对更早的线索有用。顶部追加既保留历史,又让最新内容最先可见。

适用场景

适合需要在多次会话之间延续工作上下文的场景,例如长任务中断后恢复、在多个技能之间切换、或需要记录临时决策与待办线索时。

限制

该技能依赖 .artifacts/.session-handoff.md 文件;文件不存在时 load 与 clear 静默无操作。快照内容应避免重复已持久化的产物。关于收费、价格、平台支持范围等信息,资料中暂未提供。