关于 handoff-protocols
handoff-protocols 是用于设计 Agent 间及 Agent 与人工之间交接的技能,涵盖交接流程、上下文传递、用户体验、失效模式和设计产物。
主要功能
- 01交接触发条件、来源、目标与确认
- 02顺序、并行、升级和备用交接
- 03上下文传递方式
- 04面向用户的交接体验模式
- 05失效模式与设计产物
适用场景
- 01规定 Agent 何时以及如何传递任务
- 02设计 Agent 转交时的上下文载荷
- 03规划用户可见的交接或升级
- 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