Handoff 是一个面向多智能体协作场景的技能,核心用途是把当前对话整理成一份可供另一个智能体接手的交接文档,使新智能体即使对本轮对话毫无了解也能继续推进工作。
主要能力
- 汇总任务上下文:用一到两段说明正在做什么、为什么做。
- 记录当前状态:已完成的工作、尚缺的部分、目前的痛点。
- 固化已做决策及其理由,避免后续智能体重复讨论。
- 列出有序的下一步计划。
- 包含“建议技能”(skills sugeridas)部分,指明接手智能体应调用哪些技能。
- 列出阻塞项与风险,提示可能阻碍后续进展的因素。
使用方式
该技能会生成交接文档,并保存到 ~/.hermes/handoffs/ 目录;若内容为一次性、可丢弃的,则保存到 /tmp,而不是项目的 workspace 目录。若用户传入参数,则将其视为下一次会话的关注点,据此调整文档内容。
编写规则
- 不重复已在其他产物(规格说明、计划、ADR、issue、commit、diff)中记录的内容,改为按路径或 URL 引用。
- 对敏感信息进行脱敏:API 密钥、密码、个人身份信息(PII)不得以原始形式写入,只指向其管理位置(如凭证存储,或注明文件名的 .env)。
- 文档须写成自包含形式,假定读者完全不了解本轮对话。
验证清单
技能附带一组核查项:文档是否对新智能体自包含;是否以路径引用产物而非复制内容;是否包含“建议技能”部分;是否不含秘密与 PII;是否保存于 ~/.hermes/handoffs/(一次性内容则为 /tmp)。
适用场景
适用于需要跨会话或跨智能体移交任务的场景,例如会话上下文即将耗尽、需要换用新的智能体继续、或需要在中断后保留清晰的工作状态与决策记录。
限制
资料未说明该技能的具体安装方式、支持的平台或模型范围;其运行依赖 ~/.hermes/ 相关目录约定(该工具出处资料中未进一步说明)。