用途:当用户输入 /handover、要求创建交接文档,或需要把当前会话上下文交给下一个 Claude 或开发者时,生成项目根目录下的 HANDOVER.md,记录本次会话的完整上下文,方便他人接着做。
主要能力与流程:
- 分析对话,梳理尝试过的任务及其结果(已完成、进行中、受阻)、遇到的 bug 及解决方式、关键技术决策及理由、异常问题、变通方案与坑点,以及新建、修改或删除的文件。
- 确定后续步骤,包括未完成任务的明确续接点、待处理已知问题和讨论过但尚未开始的工作。
- 汇总重要文件,如本次修改的文件、相关配置文件和测试文件。
- 按模板在项目根目录写出 HANDOVER.md。
- 告知用户文件已创建并概括要点。
输出模板结构(无内容的分节可省略):标题 Handover,注明会话日期 YYYY-MM-DD 与当前分支;Summary 用 1-3 句概述本次成果;What Was Done 列出已完成任务;What Worked / What Didn't 分列成功做法与失败做法、bug 及修复方式;Key Decisions 用表格记录决策与理由;Lessons Learned & Gotchas 记录非显而易见发现与重要背景;Next Steps 用复选框列出可执行任务;File Map 用表格记录文件路径与作用。
规则:简洁,每条一句话;具体,引用真实文件路径、函数名、报错信息和提交哈希;可执行,下一步要具体到能立即开工;保留“为什么”,无理由的决策无用;记录失败上下文,往往比成功更有价值;日期与分支取自系统而非记忆。
限制:资料未说明安装方式、收费情况与支持的平台,暂未提供。