用途:在 worker 接近回合上限时生成上下文交接,使替补 worker 能像原 worker 一样理解工作并继续,避免丢失上下文。核心原则是替补 worker 应达到与原 worker 同等理解程度,开始时需声明“I'm approaching my turn limit. Creating handover for replacement worker.”。
主要能力与状态管理:交接上下文存储在 GitHub issue 评论中,不使用本地交接文件。交接上下文与测试状态放 issue 评论,Git 变更放分支提交。因存放于 GitHub,交接可抵御崩溃。回合节点:85+ 评估是否需交接,90+ 开始准备,95+ 完成交接并准备退出,100 自动退出。
使用方式:交接采用结构化标记 <!-- HANDOVER:START --> 与 <!-- HANDOVER:END -->,内容含元数据、问题摘要、当前状态、已完成/进行中/剩余任务、关键决策与尝试、技术注意事项、阻塞项、建议下一步、优先审阅文件与可运行命令。创建步骤:评估状态(git status、git log --oneline -10、pnpm test 2>&1 | tail -20、git diff --name-only HEAD~[N]);用 gh issue comment "$ISSUE" --body 发布交接;提交未提交工作(git add -A、git commit);优雅退出,由 orchestrator 生成替补。接收方从 issue 评论读取交接(gh api "/repos/$OWNER/$REPO/issues/$ISSUE/comments" --jq '[.[] | select(.body | contains("<!-- HANDOVER:START -->"))] | last | .body'),核对分支与测试状态,发布确认,再按建议下一步继续。
适用场景:多 worker 编排中需要跨回合或跨实例传递任务上下文时。集成:被 worker-protocol 触发,为 worker-dispatch 提供交接。限制:依赖 GitHub issue 评论与 Git 状态核对;需保证本地更改已提交、交接准确、下一步具体可执行。质量标准含提交全部本地更改、记录关键决策与坑、按优先级列出待审文件、验证命令正确并发布到 issue 评论。资料未提供安装方式、收费与平台细节。