使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/owl-listener/ai-design-skills --skill handoff-protocols开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Handoff Protocols
A handoff is the moment one agent passes work to another — or to a human. It's where multi-agent systems most commonly fail. A dropped handoff means lost context, repeated work, or abandoned tasks.
Anatomy of a Handoff
Every handoff has:
- Trigger: What causes the handoff? (task completion, scope boundary, failure, user request)
- Source: Who is handing off?
- Destination: Who is receiving?
- Payload: What information transfers? (context, partial results, user state, instructions)
- Acknowledgment: How does the source know the destination received the handoff?
- User experience: What does the user see during the handoff?
Handoff Types
- Sequential: Agent A finishes, passes results to Agent B who continues. Like a relay race.
- Parallel fan-out: One agent distributes subtasks to multiple agents simultaneously.
- Parallel fan-in: Multiple agents' results converge back to one agent for synthesis.
- Escalation: An agent can't handle the task and passes up to a more capable agent or human.
- Fallback: The primary agent fails and a backup takes over.
- Human handoff: AI passes work to a human for review, decision, or completion.
Context Transfer
The most common handoff failure is context loss. Design what transfers:
- Full context: Everything the source agent knew. Safe but potentially overwhelming.
- Summarised context: Key information distilled. Efficient but risks losing important nuance.
- Structured context: Predefined fields that must be populated. Consistent but rigid.
- Incremental context: Only what's new since the last handoff. Efficient for ongoing collaborations.
Designing for the User
The user's experience of handoffs matters:
- Invisible handoff: The user doesn't know agents changed. The experience feels seamless.
- Transparent handoff: The user is told a new agent is taking over and why.
- Participatory handoff: The user confirms the handoff or provides additional context.
- User-initiated handoff: The user explicitly requests a different agent or a human.
Handoff Anti-Patterns
- The black hole: Work is handed off but never picked up
- The echo chamber: Agents hand work back and forth without progress
- The context cliff: Critical information is lost in the handoff
- The jarring transition: The user's experience changes dramatically at the handoff point
- The silent redirect: The user doesn't know they've been handed off and gets confused by changes
Design Artefacts
- Handoff protocol specifications (trigger, source, destination, payload, acknowledgment)
- Context transfer templates
- Handoff sequence diagrams
- User experience specifications for each handoff type
- Handoff failure mode analysis