用途:handoff 技能用于在会话即将结束、长时间空闲、切换任务或用户要求时,写出一份供新会话接手使用的交接文档。目标读者完全没有参与过当前对话,因此文档需要自包含。
主要能力:该技能通常无人值守运行——不提问、不等待确认,直接基于已知信息写文件,以保证在没有人在键盘前时也能完成交接。它规定只执行一条预先批准的命令:date +%Y-%m-%d-%H%M; git status --short --branch;在非 git 仓库中后半段失败也可接受。技能明确要求不进行其他调查,因为额外工具调用会重复读取整个对话。
使用方式:用 Write 工具把文件写到项目根目录下的 docs/handoffs/<timestamp>-<slug>.md,slug 为两到五个小写单词、以连字符连接;Write 会自动创建缺失目录,无需 mkdir。写完后回复文件路径和一句内容概述,文件保持未提交。若对话中没有值得继续的工作,只用一句话说明并不写任何文件。
文档内容:按顺序使用以下标题,空标题可省略:Goal(用当事人的说法描述要完成的事)、Status(已完成、半完成、未开始)、Decisions(每个选择及理由,包括被排除的选项)、Dead ends(试过并失败的做法,避免下次重复)、Files(重要路径及原因)、Verification(验证工作是否正常的命令及最近结果)、Next steps(有序列表,第一项要具体到可立即开始)、Open questions(只有当事人能回答的问题)。要求使用精确路径、命令行、标识符和错误文本,并记录当事人关于工作方式的长期指示。
适用场景:会话收尾或转冷前的交接、任务切换、多人或多会话接力同一项工作。
限制:仅凭当前对话已知信息写作,不额外调查;权限不明确的命令或写文件操作可能触发无人应答的权限提示,因此需严格限定在既定步骤内;该技能不负责提交代码,也不处理对话中无实质工作的情况。