mcpField
H
handoff-protocols

handoff-protocols

github.com/owl-listenerAgent 工作流191145 次安装20 周前更新
代码仓库

关于 handoff-protocols

handoff-protocols 是用于设计 Agent 间及 Agent 与人工之间交接的技能,涵盖交接流程、上下文传递、用户体验、失效模式和设计产物。

主要功能

  1. 01交接触发条件、来源、目标与确认
  2. 02顺序、并行、升级和备用交接
  3. 03上下文传递方式
  4. 04面向用户的交接体验模式
  5. 05失效模式与设计产物

适用场景

  1. 01规定 Agent 何时以及如何传递任务
  2. 02设计 Agent 转交时的上下文载荷
  3. 03规划用户可见的交接或升级
  4. 04检查交接中的上下文丢失或任务停滞

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/owl-listener/ai-design-skills --skill handoff-protocols

安装后在 Claude Code 中输入/handoff-protocols确认已加载。

详细介绍

交接协议

交接是指一个 Agent 将工作交给另一个 Agent 或人类的时刻。这是多 Agent 系统最常出现故障的环节。交接失败会导致上下文丢失、重复工作或任务被搁置。

交接的组成

每次交接都包括:

  • 触发条件:是什么引发了交接?(任务完成、范围边界、失败、用户请求)
  • 来源:由谁交接?
  • 接收方:由谁接收?
  • 载荷:传递哪些信息?(上下文、部分结果、用户状态、指令)
  • 确认:来源方如何知道接收方已收到交接内容?
  • 用户体验:交接期间用户会看到什么?

交接类型

  • 顺序交接:Agent A 完成工作后,将结果交给 Agent B 继续处理。就像接力赛。
  • 并行分发:一个 Agent 同时将子任务分配给多个 Agent。
  • 并行汇总:多个 Agent 的结果汇集到一个 Agent,由其整合。
  • 升级:Agent 无法处理任务,于是将其交给能力更强的 Agent 或人类。
  • 故障转移:主 Agent 失败后,由备用 Agent 接手。
  • 人工交接:AI 将工作交给人类进行审核、决策或完成。

上下文传递

交接中最常见的故障是上下文丢失。应设计传递的内容:

  • 完整上下文:来源 Agent 知道的所有信息。安全,但可能信息过载。
  • 摘要上下文:提炼关键信息。效率高,但可能丢失重要细节。
  • 结构化上下文:必须填写预定义字段。一致性好,但不够灵活。
  • 增量上下文:仅传递上次交接后新增的内容。适用于持续协作,效率较高。

以用户为中心的设计

用户对交接的体验很重要:

  • 无感交接:用户不知道 Agent 已更换,体验流畅连贯。
  • 透明交接:告知用户新的 Agent 将接手,并说明原因。
  • 参与式交接:由用户确认交接或提供更多上下文。
  • 用户发起的交接:用户明确要求更换 Agent 或转交给人类。

交接反模式

  • 黑洞:工作被交接出去,却始终无人接手
  • 回音室:Agent 之间来回交接工作,却没有任何进展
  • 上下文断层:交接过程中丢失关键信息
  • 突兀的切换:用户体验在交接时发生巨大变化
  • 无声转接:用户不知道自己已被转交,因变化而感到困惑

设计产物

  • 交接协议规范(触发条件、来源、接收方、载荷、确认)
  • 上下文传递模板
  • 交接时序图
  • 各类交接的用户体验规范
  • 交接故障模式分析

评论

支持 Markdown