用途:把当前对话总结成 handoff 文档,让新智能体能够接续未完成的工作。
主要能力:保存位置为操作系统临时目录,而非当前工作区,并需显式解析路径——Windows 使用 $env:TEMP,Linux / WSL / macOS 使用 $TMPDIR,否则用 /tmp。文档开头写给下一位智能体的交接前言,要求其先完整阅读文档及其引用的所有产物,再复述对目标、当前状态、下一步和风险的理解,并等待用户确认后才开始工作。文档中应包含“建议技能”一节,列出下一位智能体应按顺序加载的技能。
用法:文档保存后用 pi @ 提及形式回报路径:一个 @,加正斜杠的绝对路径,外加双引号,且该行只放这一项,例如 @"C:/path/to/handoff-xyz.md" 或 @"/tmp/handoff-xyz.md"。引号是必需的,因为 pi 的提示编辑器中 @ 会打开模糊文件补全弹窗,未加引号或使用反斜杠的 Windows 路径会变成一个长补全标记,被弹窗覆盖。同时提供不带引号的正斜杠路径,供命令行启动使用,例如 pi @C:/path/to/handoff-xyz.md。
限制:不要重复其他产物(规格、计划、ADR、issue、提交、diff)中已有的内容,改为按路径或 URL 引用。必须遮蔽 API 密钥、密码、个人身份信息等敏感信息。若用户传入了参数,应将其视为下一会话的焦点并据此调整文档。分类暂未提供。