{title="📊 页面导航"]
适用角色与上手难度
🎯 学习产出: 掌握上下文交接方法,能让新 agent 无缝接手工作
🚀 AI 能力提升: 上下文管理、跨会话协作
/handoff
预计阅读时间: 3 分钟交接文档。把当前对话压缩成交接文档,让全新 agent 能继续工作。保存到系统临时目录——不污染工作区。
概述
跨会话、跨目录、跨工具协作的桥梁。原型住在自己的目录里(这正是 /handoff 的用途);新 harness、新目录、同事、中途分叉的侧任务——都是它的用武之地。它买的是可移植性。
日常使用
实战
- 文档里包含 suggested skills 小节,指名下一个 agent 该为 Skill 工具调用哪些技能
- 不重复已在其它产物里捕获的内容(规格、计划、ADR、issue、commit、diff)——用路径或 URL 引用它们
- 脱敏敏感信息:API key、密码、个人身份信息
- 用户传了参数就把它当作下一会话焦点的描述,相应裁剪文档
与其它技能的关系
- 主流程位置:原型绕道
/handoff出去 →/prototype→/handoff带回来 - 阶段边界:在阶段边界五个选项之一(继续 /
/clear//handoff/ 子 agent //compact)——/handoff只在需要可移植性(新 harness、新目录、同事)时用 - Claude Code 变体:
claude-handoff(直接启动后台 agent 而不是存文档)

