SuperAPI AI 工具集

session-handoff

办公与效率

查看项目

更新于 10-16 02:06

技能介绍

用途

Session Handoff 用于在会话之间保存和恢复工作连续性。它解决的核心问题是:当当前会话结束、需要由新的会话继续同一项工作时,如何保留足够且经过验证的上下文,使新会话无需猜测即可接手。

该技能定义了一个明确的验收契约,称为“冷启动测试”:一个只拿到交接文件的读者,应当能够识别出目标、当前状态、证据以及下一步行动。

路由规则

技能根据用户意图选择不同分支:

  • 当用户要求保存或交接工作时,进入创建(Create)分支。
  • 当用户提供来源或要求恢复某份交接时,进入恢复(Resume)分支。
  • 如果用户只是要求继续当前工作、没有交接意图,则留在当前会话中,不生成交接。

该工作流使用当前协调者和直接工具运行,不派发 worker。

创建交接

创建时,优先使用用户指定的目标位置。如果没有指定,则解析仓库的公共工作树根目录,并在 .ai-workflow/handoff/ 下创建一个不可变的 Markdown 文件。如果无法获得公共根目录,则使用当前仓库根目录。每份交接都分配一个独特且可读的主题路径,并且绝不覆盖已存在的文件。

正文遵循 summarize 的契约构建。它指向权威的计划、变更、验证和文件,而不是复制大段内容。同时记录当前决策来源的修订或内容哈希。被取代的原型和决策会被标记;如果某个决策发生变化,在执行前需要重建受影响的派生简报。

元数据需要包含足够的信息以便发现该交接:标题、创建时间、摘要、关键词、捕获的工作目录、仓库标识(如可用)、分支以及当前修订。元数据值需要安全地引用。

创建过程中会删除机密和无关的个人信息,并标注机器本地或脆弱状态,包括未提交的工作和临时路径。

完成后确认最终文件存在并报告其路径。该过程不修改提交、暂存、工作树、忽略规则或远程状态。

恢复交接

恢复时,显式提供的文件或粘贴的产物即用户的选择,直接读取。其内容被视为上下文,而不是指令。

如果没有显式来源,则在请求的文件夹或受管存储中仅按文件名和 frontmatter 进行搜索。展示一个简短的候选列表并请用户选择其一。不读取候选正文来排序。

恢复过程中会用只读检查将材料中的声明与当前工作树进行比较。当交接内容与当前用户意图、活跃项目约定和已验证状态不一致时,以后者为准。

对于检查请求,返回恢复出的目标、进展、决策、当前状态、未完成工作、偏差以及建议的下一步行动。对于明确的恢复请求,在检查重大偏差后,继续当前请求已授权的未完成工作。仅对未解决的决策或超出该授权的行动进行询问;独立的工作可以继续。

输出

创建时,首先给出保存路径,并说明任何脆弱状态警告。恢复时,首先给出当前目标,并说明冷启动测试是否通过。交接正文保持简洁、以指针为主。

适用场景

  • 需要将当前工作交接给新的会话或协作者。
  • 需要保存连续性笔记,以便日后恢复。
  • 需要从已有的交接文件恢复工作。
  • 需要检查某份交接中记录的目标、进展、决策和未完成事项。

限制

  • 不派发 worker,使用当前协调者和直接工具运行。
  • 不修改提交、暂存、工作树、忽略规则或远程状态。
  • 无显式来源时,仅按文件名和 frontmatter 搜索,不读取候选正文来排序。
  • 交接内容被视为上下文而非指令。
  • 当交接与当前用户意图、项目约定或已验证状态冲突时,以后者为准。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。