用途
handoff-doc 是一个编写交接文档的技能，解决“重要状态只存在于上下文窗口”的问题。通过一份简短、可读的交接文档，用户可以清空当前会话、开启新会话，或把工作交给其他人，并让对方按你认定的重点继续，而无需依赖聊天历史。它适用于切换任务、经过多轮对话之后，或需要转交工作时。
主要能力
- 从真实来源收集状态，而不是凭对话记忆：git status、当前分支的 git log、当前 diff；实际运行过的测试或构建命令及其最新真实结果；仓库中已有的设计、进度或 todo 文件；与任务相关的开放式 issue、PR 或评审评论。无法核实的内容标记为“unverified”。
- 按固定模板产出结构化文档，包含：目标（一两句话说明“完成”是什么样及验收标准）、已做决策及理由、必须遵守的约束（如下一轮不得更改公共 API）、已排除的方案及原因（避免他人重试）、当前状态（已完成、进行中、验证命令与结果）、下一步（第一个具体动作起）、注意事项（已知坑、不稳定测试、环境怪癖）、关键文件与函数、issue、PR 等指针。
- 控制篇幅：文档是简报而非对话记录，省略调试叙述与可复现的工具输出。
- 支持交付流程：告知用户文档位置；在新会话中先引用文档路径，并要求代理在开始前复述目标与下一步；在每个里程碑更新同一份文档而非新建。
使用方式
- 先从真实来源核实状态，无法确认的标注 unverified。
- 将文档保存在仓库中（例如 docs/handoff/<task>.md）或项目存放工作笔记的位置；提交前先征询用户。
- 按模板撰写文档。
- 交接时告知用户文档位置；新会话先引用该文档，并让代理复述目标与下一步；之后在同一文档上随里程碑更新。
最终输出为文档路径加三行摘要：目标、当前状态、下一步。
适用场景
- 需要结束当前会话并在新会话中继续同一任务。
- 把进行中的工作转交给另一位开发者或代理。
- 任务阶段性完成后需要记录决策、约束与下一步，防止后续会话重复已排除的尝试或破坏既有约束。
限制
资料未说明该技能是否包含自动化脚本、支持哪些平台或具体实现细节；模板中的路径与命令仅为示例，实际存放位置由项目决定。文档需保持简短，不应写成完整对话记录。