Handoff 用于智能体之间的跨会话交接,核心原则是“传指针而非正文”:只传路径、URL、SHA,不粘贴计划、PRD 或 diff。适用前提是确实要开新会话,同会话内延续不在范围内。
主要能力:提供两种通道。channel:prompt 由用户通过 /handoff 触发,输出一段接收用提示词,不写磁盘;channel:artifact 由模型在上下文压力下调用,必须由子智能体写入 <workspace>/_agent/handoffs/<filename>.md,协调者直接写属违规,之后只输出读取用的 stub。
使用方式:先选通道、pack 和 goal,再从对话中收集最小要点,省略空类别。prompt 通道按 output.md 输出围栏提示词;artifact 通道走 handoff-subagent-dispatch.md,只粘贴 stub。跨客户端默认行为:Codex、Cursor、Claude Code、Claude API、ChatGPT UI、GitHub Copilot Chat、通用 MCP 等,多数以 channel:prompt 为主;若接口不提供 artifact API,一律回退到 prompt。Codex API 分支可用 create_thread 新建任务,再用 send_message_to_thread 发送提示词块。
限制与要求:写入或粘贴前必须脱敏密钥、令牌和 PII;状态要诚实,区分已完成、进行中、已损坏,声称进展需引用提交或测试;不得把 channel 和 pack 写进接收内容;不得硬编码某一聊天栈的控制 API 为唯一路径;若下一会话只需评审状态,应使用消费者叠加块而非完整 Pack。资料未提供具体安装命令、收费与平台支持细节。