handoff-coordinator

用途

Handoff Coordinator 用于管理智能体（Agent）与会话之间的干净过渡，通过状态序列化和上下文桥接，让工作在不同智能体或不同会话之间平滑传递。它适合在准备交接、序列化状态、在智能体之间桥接上下文，或协调多智能体协作时使用。

主要能力

准备交接：由源智能体完成当前工作、保存状态到文件、创建交接包并发出可交接信号。
协调交接：协调器验证状态一致性、序列化交接包、存入交接文件，并触发目标智能体。
执行交接：目标智能体加载交接包、恢复上下文、验证状态并继续工作。
交接包结构：包含 id、source_agent、target_agent、timestamp、state（当前特性、已完成特性、阻塞项、下一步）、context（最近文件、git 哈希、会话编号）和 summary。
交接类型：会话交接（同一智能体、新会话，用于上下文达到上限）、智能体交接（不同智能体，用于专门任务）、并行交接（多个目标，用于拆分工作）、恢复交接（失败后，用于错误恢复）。

使用方式

准备交接：

from scripts.handoff_coordinator import HandoffCoordinator

coordinator = HandoffCoordinator(project_dir)
package = await coordinator.prepare_handoff(
    source_agent="coding-agent",
    summary="Completed auth-001, starting auth-002"
)

执行交接：

await coordinator.execute_handoff(
    package=package,
    target_agent="coding-agent"
)

交接包示例：

{
  "id": "handoff-20250115-103000",
  "source_agent": "coding-agent",
  "target_agent": "coding-agent",
  "timestamp": "2025-01-15T10:30:00",
  "state": {
    "current_feature": "auth-002",
    "completed_features": ["auth-001"],
    "blockers": [],
    "next_steps": ["Implement logout endpoint"]
  },
  "context": {
    "recent_files": ["src/auth/login.ts"],
    "git_hash": "abc1234",
    "session_number": 5
  },
  "summary": "Completed auth-001, starting auth-002"
}

集成点

autonomous-session-manager：触发会话交接。
context-compactor：在交接前进行压缩。
memory-manager：存储交接摘要。

参考与脚本

参考文档：

references/HANDOFF-PROTOCOL.md - 协议细节
references/AGENT-TRANSITIONS.md - 过渡模式

脚本：

scripts/handoff_coordinator.py - 核心协调器
scripts/state_serializer.py - 状态序列化
scripts/context_bridge.py - 上下文桥接
scripts/handoff_protocol.py - 协议实现

适用场景

适用于多智能体协作、长任务跨会话延续、上下文达到上限时的会话切换、专门任务转交、并行拆分工作以及失败后的错误恢复。

限制

资料未提供关于收费、价格、平台支持、性能效果或具体使用步骤的更多信息。

技能介绍

用途

主要能力

使用方式

集成点

参考与脚本

适用场景

限制