用途：将当前会话中真正发生的工作（编辑过的文件、执行过的命令及其结果、已作出的决定）提炼为一份自包含的 Markdown 交接文档，供一个没有任何对话历史的智能体或 LLM 冷启动接手。读者无本会话记录、无工具结果、无草稿推理，因此需前置目标、显式写出每个文件与命令、消除所有代词歧义。
主要能力与结构：文档分五节——Goal（一行目标与完成标准）、Current state（已完成并验证、进行中、受阻，区分已验证与假定）、Plan / next steps（按序、可执行的剩余工作）、Key files（涉及的每个文件及作用与变更，用仓库相对路径）、Decisions & gotchas（决定及理由、被否决的替代方案、约束、隐含依赖与陷阱）。
用法：调用可带自由文本焦点短语（如 /handoff the auth refactor）将范围限定到某一条工作线；--brief 生成精简版，仅含 Goal + Next steps + 前 3 个文件，默认输出完整文档。写入前先用一行说明所选范围。输出路径通过 git rev-parse --abbrev-ref HEAD 取得分支，写入 .agent/{branch}/handoff.md（需创建目录）；非 git 仓库时退回 .agent/handoff.md，.agent/ 不可写时退回暂存目录，并报告所用路径。按 templates/handoff.template.md 模板填写各节，确实为空则整节省略，不留占位符或 TODO。随后用 pbcopy < <path> 复制到剪贴板；缺少 pbcopy 时跳过并说明。最后只报告路径、剪贴板是否成功与节数，输出一行指引而非整篇文档。
取舍原则：纳入目标与验收标准、决定及理由、文件与确切命令、如何构建/测试/运行、约束与陷阱；排除闲聊与重复需求、冗长推理链、完整工具调用记录与原始命令转储、无关的废弃尝试（除非有教训）、仓库中可轻易发现的内容。绝不写入密钥、令牌或凭据。
限制：文档仅基于本会话实际发生之事，不基于仅讨论过的内容；路径与剪贴板行为依赖运行环境；官方文档未提供其他功能、收费或平台信息。