Fable Handoff 是一个面向 AI 智能体的跨会话交接技能,核心定位是「续接契约」而非普通摘要。它的目标是让另一个智能体或会话在不重放整个对话、不重新探索仓库的前提下,准确恢复正在进行的工作。
适用场景
- 暂停长时间运行的任务;
- 把工作转交给另一个智能体、其他会话或人类;
- 上下文变得过大,需要持久化压缩;
- 发布或 PR 尚未完成但执行必须停止;
- 自动化/协作循环需要持久检查点。
不适用场景
- 除一个简单已完成的回合外没有任何可持久保留的内容;
- 下一步行动本身尚不明确,因为规划或诊断尚未完成;
- 试图用交接来掩盖缺失的验证或未解决的失败。
工作流程 技能按八个阶段执行:重构持久任务目标(与实现手段分开);快照精确的仓库/工作状态(分支、工作区、候选提交 SHA、活动阶段、有意变更的文件、需保留的无关改动、未提交的生成产物、PR/issue/发布标识);将测得的证事、决策、推断、被否定的假设和未解决问题分桶;为每条重要断言记录证据及其新鲜度(新鲜/陈旧/未检查);记录有教学价值的失败与修复尝试;精确陈述阻塞点(缺失的外部事实、权限或环境,以及解除后的可能);给出一个由当前证据支撑、可执行的首个安全下一步动作;最后做脱敏处理,不复制密钥、令牌、私钥、原始凭证、不必要个人数据或超大日志。
关键规则
- 优先使用精确标识符(分支、SHA、PR、文件路径、命令)而非叙述性描述;
- 保留「否定性知识」,避免接收方重复已证伪的思路;
- 证据新鲜度必须在压缩后仍然保留,旧的通过测试不能表述为当前通过;
- 工作区不干净时,区分本任务改动与无关/用户所有改动;
- 若下一步依赖未决决策,应先转回规划或恢复流程,不要臆造交接动作;
- 对话历史只是可选上下文,交接本身必须可独立成立;
- 错误签名加命令和关键行足够时,不要复制完整日志。
交接包结构 包含目标、当前分支/工作区/SHA、活动阶段、有意变更、受保护的无关改动、测得事实、决策及理由、被否定的假设/失败尝试、证据(断言→命令/来源→结果→新鲜度)、未决发现与阻塞、外部状态(PR/CI/发布/注册表)、首个安全下一步、次要独立动作、勿重复/勿更改事项。
完成标准 当零上下文的接收智能体能够识别确切任务与仓库状态、区分事实/决策/推断、知道哪些证据是新鲜的、避免重复已证伪的尝试、安全保留无关工作与凭证,并在不追问基本上下文的情况下执行下一步时,交接即告完成。
技能还提供了进阶资源入口:深度指南 references/resumability-and-context-compaction.md、现有模式 references/continuity-schema.md、模板 templates/handoff-state.template.md、示例 examples/cross-session-handoff.md。具体安装方式与调用命令暂未提供。