16. handoff 技能

将当前对话压缩成交接文档,供新智能体继续工作

快速开始

npx skills add mattpocock/skills --skill=handoff
npx skills update handoff

源代码

功能说明

handoff 将当前对话压缩成一份交接文档——一份单页的书面记录,供一个新的智能体阅读,以便从你停下的地方继续工作。

不会复述已经存在于其他地方的内容。任何已经记录在规格说明、计划、ADR、issue、提交或 diff 中的内容,都通过路径或 URL 引用,而不会被复制。文档只携带实时线程——你在做什么、为什么做、下一步是什么——并且它被保存到你的操作系统临时目录中,而不是保存到工作区内,因此它永远不会成为另一个需要维护的产物。

何时使用

你通过输入 /handoff 来调用它——智能体不会主动使用它。传入一条关于下一个会话用途的说明,文档就会据此进行定制。

当一段对话已经持续了足够长时间,其上下文面临丢失风险时使用它——你接近上下文限制、准备结束一天的工作、或有意将工作交给另一个智能体——并且你希望保留对话线索,而无需拖拽整个对话记录。

文档包含的内容

  • 实时线程——正在进行的工作及其原因,用对话自身的语言表述,减去任何已经在其他地方写下来的内容。
  • 建议的技能——指向下一个智能体应该用来继续工作的技能。
  • 引用,而非副本——指向存放已确定细节的规格说明、计划、ADR、issue 和 diff 的链接和路径。
  • 已删除的机密信息——API 密钥、密码和 PII 在文档写入之前已被移除。

需要记住的核心概念是压缩:交接文档是将对话压缩到仅剩其可恢复的核心,这样一个新的智能体继承的是工作势头,而不是噪音。

在整个流程中的位置

handoff 是一个随时可调用的独立技能——它位于两个会话之间的接缝处,而不是构建链内部。它与产生产物的技能自然配对,其输出会被它指向引用:to-spec,因为一份完成的规格说明正是交接文档所引用而非重复的那类已确定的细节。当你不确定哪个技能适合当前场景时,ask-matt 会帮你导航。

标签:LLMSkillsAI编程