handoff
Installation
SKILL.md
Session Handoff
写一份交接物,让一个零上下文的新 agent 能接着干。交接是显式动作:用户没叫就不自作主张交接。
流程
- 用户传了参数就按它定制(下一会话的重点);没传就按当前工作的自然续点写。
- 落点分层:
- 完整交接文档一律写到操作系统临时目录(如 /tmp;不进仓库或项目目录,避免制造孤儿文件),把路径明确告诉用户。
- 项目有恢复面:续点优先写进本轨道 state 的 Next 行,关键状态与证据写 Evidence 行(持久、可恢复);完整交接文档仅在确需完整上下文时才生成。
- 无恢复面:临时目录里的交接文档就是唯一交接物。
- 内容纪律:
- 含「建议技能」一节:下一个 agent 应调用哪些 skill,直呼其名。
- 不复述已有产物(Spec/plan/ADR/issue/commit/diff)——引用路径即可。
- 脱敏:密钥、口令、个人身份信息一律不写。
- 交付:告诉用户交接物在哪、下一会话怎么用(有恢复面按会话入口读;无恢复面把文档喂给新会话开场)。