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 静默无操作。快照内容应避免重复已持久化的产物。关于收费、价格、平台支持范围等信息,资料中暂未提供。