用途:把当前对话整理成一份交接文档,让新会话或另一个智能体接手继续工作。适用于需要跨会话传递上下文、或把任务交给新智能体的场景。
主要能力:汇总用户目标、已做决策、遇到的阻塞、尝试过与已排除的方案、涉及的文件与命令、未提交状态;记录本次产生的 PRD、计划、ADR、issue、commit、PR、diff、日志等产物,并以绝对路径或 URL 引用而非粘贴内容;根据用户传入的参数(描述下一会话重点)裁剪文档;推荐下一会话可用的技能。
使用方式:运行 mktemp -t handoff-XXXXXX.md 获取绝对路径,先读取该空文件再写入。文档结构包含标题、下一会话重点、创建时间、工作目录、分支/工作树、目标、当前状态、已做决策、已排除方案、未决问题与阻塞、产物清单、下一步动作、建议技能、环境说明;不适用的段落可跳过。保存后单独一行打印路径供复制。
限制:不要提交该文件,mktemp 会将其放在系统临时目录,用户如需保留需自行移动。不要重复已有产物内容,应引用路径或 SHA。不适用于对话很短、已有计划/PRD/issue 已记录状态、或单个 bug 调试中交接成本高于直接完成的情况。建议技能时只推荐用户环境中确实存在的技能。文档要求具体、记录失败尝试、使用绝对路径,不含表情、填充语或道歉。