用途:session-handoff 用于在会话结束时生成一份交接文件,使接手的智能体、模型或运行环境仅凭文件路径就能识别任务并开始执行。若你收到的是交接文件,则你就是接手方:执行其中的任务,不要改动该文件。该请求仅授权读取交接所需内容并写入文件,用户为任务授予的权限只记录给接手方,不在本次使用。
主要能力与写法:文件写入项目根目录的 .handoff/<YYYY-MM-DD>-<HHMM>-<task-slug>.md,使用本地时间和简短的 ASCII kebab-case 标识。多仓库时使用共同根目录并分别标注。内容填充 assets/handoff.template.md,保留其加粗的开头指令词原样,删除无内容的行。意图与范围以用户当前明确表述为准,状态以实际文件、版本控制和最新工具输出为准;逐字引用用户决定性语句并附日期;指向路径、命令和提交而非粘贴内容,且不写入机密。子代理、后台任务、待处理工具调用和会话内授权随本次会话结束,需记录各自在磁盘上留下的内容;仅列出接手方可从外部检查的仍在运行的句柄及检查命令。记录来源运行环境和会话 id,以便在安装 read-agent-sessions 时恢复记录。只询问会改变工作且只有用户能决定的未知项,每项附后果、具体选项、推荐默认值及未答复时的处理方式;可通过检查或低成本验证确定的事实放入 Next Actions。若 .plans/ 或其他项目记录主导工作,按路径指向它,只补充其缺失内容,并在继续意味着执行时命名为 work-plan。文件就绪标准:读者无其他信息即可执行第一个动作,每项已完成声明都有证据,并知道该向用户询问什么。
历史交接:.handoff/ 中带该任务标识的最新文件为当前版本,保留其仍有效的决定,在新文件的 Supersedes 行注明,并在旧文件顶部加一行 Superseded by <新路径>。旧版根目录 handoff.md 同样处理。
交付:报告路径、记录的状态和第一个动作。仅在维护该技能时读取 references/source-notes.md。
限制:资料未提供具体安装命令、收费方式、支持平台或效果数据。