Agent Handoff 是一个面向本地编码智能体交接流程的技能。其核心用途是:当当前宿主机上的智能体需要接手“对侧”智能体最近未完成的编码任务时,依据原生会话历史与确定性 Git 快照恢复上下文并继续执行。
主要能力:
- 会话发现:从技能目录运行 bundled 脚本 discover,输出当前宿主机身份、源智能体身份、精确的当前目录匹配、原生会话位置,以及从新到旧的候选排序。
- 宿主机规则固定:Claude Code 宿主 → 源为 Codex;其他宿主(含 Codex)→ 源为 Claude Code。
- 候选选择:按 discover 返回顺序严格检查,优先 status_hint 为 interrupted 的候选;否则从新到旧查看 tail_preview,仅在预览清晰表明任务已完成时跳过;模糊的最新候选按未完成处理;若全部已完成且 has_more_candidates 为 true,则以更大的 --max-candidates 重新运行。
- 完整读取原生转录:通过 bundled 脚本 read 从第 1 行开始分块读取(每块 200 行),每块之后传入返回的 SHA-256,直到 next_start_line 为 NONE;按时间顺序读完再做操作。若读取期间转录变化导致哈希校验失败,则停止并报告源会话在交接期间发生变化。
- 确定性 Git 工作区快照:通过 bundled 脚本 workspace 读取当前仓库的精确工作目录、仓库根、当前分支或 detached-HEAD 状态、当前 HEAD 提交、完整 git status --porcelain=v1 --branch --untracked-files=all 输出、完整未暂存与已暂存 diff。分块读取并传递 SHA-256;若分块之间工作区变化则停止并报告。目录不在 Git 仓库内时接受 git_repo=false 并继续使用实时文件。
- 继续执行:读完全部转录与快照后检查实际文件,以当前文件与 Git 快照为准;保留所有已有暂存、未暂存与未跟踪改动;停留在当前目录与当前分支,不新建或切换分支/工作树,不 reset、stash、clean、revert、丢弃或覆盖已有工作,除非用户原始任务明确要求;不重复已完成的调查,除非实时工作区与源转录矛盾。用一两行说明源智能体在做什么、停在哪里、接下来做什么,然后立即继续未完成任务。
使用方式(按资料中的命令):
- python3 "<skill-directory>/scripts/session_handoff.py" discover --cwd "$PWD"
- python3 "<skill-directory>/scripts/session_handoff.py" read --cwd "$PWD" --session "<session_id>" --start-line 1 --max-lines 200,随后按 next_start_line 与 --expect-sha256 继续读取。
- python3 "<skill-directory>/scripts/session_handoff.py" workspace --cwd "$PWD" --start-line 1 --max-lines 300,随后按 next_start_line 与 --expect-sha256 继续读取。
适用场景:在 Claude Code 与 Codex 之间接续最近未完成的编码任务;需要以确定方式获取原生会话历史与 Git 状态;希望避免手工猜测会话路径或从对话历史推断 Git 状态。
限制与约束:必须严格按工作流执行,不自行发明会话路径、不手工搜索会话存储、不从对话历史推断 Git 状态、不以自建启发式替代 bundled 发现/工作区逻辑;辅助脚本失败时应停止并报告错误,不退回手工发现;不向用户索要会话 ID;不写入交接报告,不创建 CLAUDE.md、AGENTS.md、.handoff.md 等交接元数据;不请求开始许可,不索要新任务描述。资料中未提供该技能的收费、价格、平台或效果数据。维护方面,仅在诊断辅助脚本失败或更新技能时阅读 references/session-storage.md。