用途:在连续会话中接续项目工作时,生成会话交接文档,记录本次会话完成的内容、进行中的工作、关键决策及理由、修改文件状态、阻塞与问题、具体下一步,以及不写下来就会丢失的上下文。
主要能力:识别当前计划与阶段(查看 plans/ 目录、plan.md、todo.md);汇总进展(已完成/进行中/未开始)、决策(含备选方案与取舍)、实现状态(用 git diff --stat 或 git status 查看修改文件、未提交变更、待跑测试)、问题与阻塞;按模板写入 plans/<name>/handovers/session-<YYYY-MM-DD>.md,同日多份追加序号如 session-2025-02-14-2.md;随后更新 todo.md 反映真实状态;最后用提问工具向用户确认是否有遗漏、下一步优先级是否正确。
使用方式:由用户手动触发,例如要求“create a handover”或“save session state”。推荐由主智能体执行并撰写,因为交接是提炼后的会话叙述;可将 git 状态/差异解读或批量文件列举委托给 doc-explorer,但叙述与决策保留在主智能体。无正式计划时,改为创建 docs/handovers/session-<date>.md,省略计划/阶段引用,聚焦通用会话上下文、决策与下一步。
适用场景:多阶段计划会话结束时;工作中断需稍后继续时;团队成员或智能体之间交接时。
限制与规则:不要自动生成交接,必须手动调用;只记录真实发生的事,不臆造进展;下一步要具体可执行;记录决策理由而非仅结论;上下文写入文件而非聊天消息;不重复 todo 列表,任务状态引用 todo.md;文件状态以 git 为准而非记忆;多份交接是叠加而非替换;保持可快速浏览;todo 更新只做简单状态变更,复杂计划重构应使用 update-plan 技能。模板为随附文件 tpl-session-handover.md,输出须遵循其标题与 frontmatter 键。