handoff

来源

这是中文译文，方便对照阅读。本站不发行可安装的中文技能包。英文文件链接在文末，指向提交 d81f3a1。

译文

写一份交接文档，概括当前对话，让一个新的代理能接着做。文件存到用户操作系统的临时目录，不要存进当前工作区。

文档里要有一节 suggested skills，写明下一个代理该用 Skill 工具调用哪些 skill。

已经写在别的文件里的内容不要再抄一遍。规格、计划、架构决策记录（ADR）、issue、提交和 diff，用路径或 URL 指过去。

涂掉敏感信息，例如 API key、密码，以及能认出具体个人的信息。

如果读者传了参数，就把参数当成下一次会话要做什么的说明，并按这个说明来写文档。

大白话讲解

handoff 把你正在进行的对话收成一个 markdown 文件。文件放在操作系统的临时目录里，不放进当前仓库。新的代理读这个文件，就能接着做。

它要解决的是把工作搬走，不是把对话压得更短。说明页写了四种需要这份文件的情况。换成另一套 harness，例如从 Claude 换到 Codex，因为新的 harness 看不到原来的上下文。换一个目录或仓库，原型目录是常见的一种。把工作交给同事，对方需要一份能读的东西。做到一半发现一件旁边的事，你自己继续，另一个代理去处理那一支。

同一套 harness、同一个目录、这件事你还要继续盯着的时候，说明页写的是用 /compact，不用 handoff。/compact 保住意图。/clear 什么都不留。handoff 保住工作还能搬走。说明页还写，这三样都会把当时的对话变成一份摘要。只有继续留在原来的对话里，才不会变成摘要。

你要自己输入 /handoff。代理不会自己拿起它。可以附一句下一次会话要做什么，文档会按这句话来写。

文件里带着正在做的事、原因和下一步，以及 suggested skills。密钥会先涂掉。规格、计划、ADR、issue、提交和 diff 只留路径或 URL。

说明页写了临时目录的几个麻烦。路径长，各系统不一样。在 Windows 上，代理有时要找好几次才找到该写的位置。有的环境会在会话之间清掉临时目录，说明页点名的是 Codex。/private/tmp 在重启后也会没了。下一会话如果不是马上开始，或者换了 harness，写完就要自己把文件抄到一个会留下来的地方。文件里指向的其他临时文件也一样，下一任代理会找不到。

交给下一个代理时，让它读文件路径，再继续。不要把摘要贴进 claude "<summary>" 这种命令。摘要里的反引号或 $(...) 被塞进命令时可能被截断，而且常常不报错。

分出旁边那一支时，原来的会话还在。说明页用 prototype 举了这个来回。设计问到一个只有跑代码才能定的问题，就把这一支交给一个跑 prototype 的会话，拿回答案，再用路径指回原来的对话。

拿不准该继续、/clear、/handoff、delegate 还是 /compact 时，说明页指向 ask-matt。那一页把这五条路排好。

上手例子

说明页的表里有一行是分出一件旁边的事。你自己继续当前工作，另一个代理去处理那一支。下面只走这一行。

1. 输入 /handoff，并写上下一次会话要做什么。技能说明里的 argument-hint 是 What will the next session be used for?。按说明页里 prototype 那次来回，可以写成 /handoff 下一次会话用来跑 prototype，回答这个只有代码能定的问题。
2. 打开它写在临时目录里的 markdown。里面应有一节 suggested skills。规格、计划、ADR、issue、提交和 diff 只出现路径或 URL。里面没有 API key、token 或密码。
3. 向它要回文件路径，先自己留一份。说明页写，有的环境会在下次会话前清掉临时目录。
4. 新开一个会话，让它先读这个文件再继续。不要把摘要贴进 claude "<summary>"。
5. 回到原来的会话。说明页写，分出这一支时，原来的会话还在。

原文链接和 commit

读者要自己输入 /handoff 才会用到它。它在 Claude Code 插件里。

把当前对话收成一份交接文档，交给另一个代理接着做。文件写在系统临时目录，不写进当前工作区。

Compact the current conversation into a handoff document for another agent to pick up.

• 仓库 mattpocock/skills
• 文件 skills/productivity/handoff/SKILL.md
• 提交 d81f3a1
• 说明页 docs/productivity/handoff.md
• 同目录文件 skills/productivity/handoff/agents/openai.yaml

英文 SKILL.md

---
name: handoff
description: Compact the current conversation into a handoff document for another agent to pick up.
argument-hint: "What will the next session be used for?"
disable-model-invocation: true
---

Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS - not the current workspace.

Include a "suggested skills" section in the document, naming which skills the next agent should call the Skill tool for.

Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.

Redact any sensitive information, such as API keys, passwords, or personally identifiable information.

If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.