用途:把当前会话的工作状态交接给继续该工作的下一个会话。交接是一份简报而非记录,尽可能直接送达下一个会话,且永不提交到仓库。
主要能力:收集下一会话所需的状态,包括已完成的任务或阶段、创建或修改的文件、已提交并推送的提交(分支与远程状态);未完成的任务、已遇到并修复的 bug、部分开始的工作;用户已批准且约束后续工作的决策、已建立的模式、尝试过但无效的方法;以及仓库路径、分支、远程、开发环境状态、测试凭据、关键文件路径(最多 2-4 个)。若下一任务不明确,会询问“下一会话应聚焦什么”。
使用方式:先收集状态,再撰写简报,控制在不到一分钟可读完,自包含,不写“见上文”。简报结构包含标题与日期、1-2 句现状摘要,以及 Done、Not Done、Decisions、Bugs Fixed(Don't Repeat)、Practical、Next、Read First 等小节。交付时按顺序尝试:若有另一个 Claude Code 会话在运行,用 ListAgents 找到并用 SendMessage 发送,发送前确认目标会话;若目标运行在 Herdr 或 tmux 中,用 herdr 技能(在 Herdr 内)或 tmux-orchestration 技能(普通 tmux)发送到目标窗格,发送前确认窗格;若无活动目标,将简报写入 ${TMPDIR:-/tmp}/handoff-YYYY-MM-DD-<topic>.md,把指向它的一行恢复提示复制到剪贴板(macOS 用 pbcopy,Linux 用 wl-copy 或 xclip -selection clipboard),并把路径告知用户。该文件是一次性的,重启丢失无妨。
限制:不要写入项目或提交;不要包含对话逐条记录、原始错误日志(应总结修复)、可从磁盘读取的文件内容或实现细节、以及可从 git log 或代码推导出的内容。