SuperAPI AI 工具集

session-handoff

办公与效率

查看项目

更新于 10-15 17:20

技能介绍

用途:会话结束时往往留下半成型的决策、半回答的问题和没人记录的发现,下一次会话只得从零重推,浪费 token 并迫使人类重建先前的推理。本技能把一次会话分解为带类型的交接单元并暂存,供后续召回。类型使召回可信:状态更新几天后即不再成立,而关于工具行为的发现可多年有效,两者不能共用同一保质期。

单元字段共七项:Thread(简短具体的标签)、Type(finding|decision|open-thread|state)、Date(YYYY-MM-DD)、State(会话结束时的落地内容,1-2 句)、Why(承载性推理,含被否决项)、Open(未决内容,无则省略)、Ref(来源会话)。四类的衰减期:finding 365 天、decision 90 天、state 7 天、open-thread 不衰减。写作者只选类型,不选保质期。

使用方式:先做两阶段提取。阶段一扫描记录,逐行列出涉及的所有不同线程,故意多包含;阶段二把这些清单归组为线程,每个线程每类型渲染一个单元。可选地通过 Skill(memory-palace:memory-clarity-probe) 检查单元清晰度。写入 data/state/handoff_units.json,顶层为 units 数组。Stop hook 会读取该文件并合并到会话记录中。召回时在提示末尾加 +recall 注入匹配单元,或加 +recall? 同时查看检索到的内容;召回为可选,因为每轮固定注入会消耗本应扩展的上下文窗口。作用于任何 state 单元前,先说明距其写入已过去多久。

适用场景:提示以先前会话自己的词汇指向那项工作时、上下文清空或压缩后恢复工作时、用户询问过去决策为何如此时、用户怀疑注入状态是否仍最新时,可建议使用 +recall(最后一种用 +recall?)。不建议的其他情况:答案已在当前上下文、提示与任何先前线程无实词重叠、本会话已召回过该线程。应作为答案旁边的提议,而非回答的前提条件。

不宜使用:从外部文章采集知识用 knowledge-intake;在单次长对话内构建临时结构用 session-palace-builder;判断摘要是否清晰到可交接用 memory-clarity-probe。

已知限制:暂存文件是进程全局的,同一检出中的两个并发会话可能出现其中一个读走另一个的单元;窗口为一个回合,且技能无法知道自己的会话 id,这正是采用暂存而非直接写记录的原因。模块文档包括 unit-schema.md、two-phase-extraction.md、temporal-awareness.md。