用途:为 AI 智能体提供跨会话连续性。它把当前会话的目标、状态、完成与待办工作、重要文件、已运行命令、已知问题、决策、下一步动作和停止条件写入本地交接文件,供下一次会话读取和核对。
主要能力:提供 write、boot、install、status 四种模式。write 生成 handover.md、.handover/current.md 和 .handover/state.json,并归档旧版本;boot 读取并对照当前仓库状态校验分支、HEAD、重要文件是否存在,报告继承目标、可能过期的笔记与预期下一步;install 在 AGENTS.md/CLAUDE.md 插入带 sentinel 注释的启动片段,并可选用钩子安装器;status 检查交接文件、gitignore、Git 跟踪状态、sentinel 块与钩子配置的健康度。
使用方式:按需调用 handover write、boot、install、status,共享场景用 handover write --shared。可选钩子安装命令为 node skills/handover/scripts/install-handover-hooks.js,可加 --claude 或 --codex 只装其一;会话启动脚本为 node skills/handover/scripts/handover-session-start.js。语言按输入自动匹配,日语用 references/.ja.md,英语用 references/.md,显式覆盖优先。下游私有模式会检查并补充 .gitignore 中的 handover.md 与 .handover/ 条目。
适用场景:需要跨会话延续任务的编码或研究型智能体工作流,特别是希望本地保存进度而不提交到团队仓库时。
限制:默认私有模式要求交接文件被 Git 忽略;若文件已被跟踪,工具仅警告而不会自动执行 git rm --cached。Git 不可用时校验为部分校验;元数据与当前 Git 状态不符时标记为可能过期。boot 不会在未经验证的情况下信任交接内容,遇到破坏性、对外或含糊操作前须先询问。钩子适配器为可选,AGENTS.md/CLAUDE.md 引导是便携基线。安装命令是否已实际配置、具体钩子行为与版本兼容信息,资料未提供。