| name | 507-handoff |
| description | 会话移交:中断、换会话、压缩上下文或转交给另一 Agent 时,在对话中生成脱敏的临时交接摘要,不写文件。Use when user says handoff, 交接, 交接一下, 移交, 换会话, 换个会话, 转交, 压缩上下文, 上下文太长了, 给下一个 agent 摘要. |
会话移交(handoff)
让新会话或新 agent 不必重读完整对话即可继续工作。它只携带尚未沉淀的运行状态;正式事实继续以 PRD(需求文档)、issue(问题单)、项目文档、测试证据和 commit(提交)为准。
产物边界
- 只在当前对话输出,不写仓库、临时目录或个人配置;
- 已有正式产物只引用路径、URL 或 commit,不复制全文;
- 不把临时交接摘要当长期事实源;
- 脱敏 API key(接口密钥)、密码、token(令牌)、Cookie(会话凭据)和个人/客户数据。
收集内容
按任务实际情况读取或确认:
- 当前目标和用户给出的下一段重点;
- 已完成事项及其正式产物;
- 已确认决策;
- 重要入口、文件和路径;
- Git(版本控制)状态及未提交改动;
- 已运行和未运行的验证;
- 未完成事项、阻塞和建议下一步;
- 下一会话适合使用的 skills(技能)。
不编造未发生的决定或验证;不确定就明确写“不确定”。
输出结构
# Handoff
## 当前目标
...
## 已完成
- ...
## 关键决策
- ...
## 重要文件 / 入口
- `<path>` — <作用>
## Git 状态 / 未提交改动
- 仓库:...
- 当前状态:...
- 相关文件:...
## 验证状态
- 已运行:...
- 未验证:...
## 未完成 / 下一步
1. ...
## 建议使用的 skills
- `<skill>` — <用途>
## 风险 / 注意事项
- ...
按复杂度删去空章节,但不能遗漏会让接手者重复劳动或误操作的状态。
红线
- 不写文件;
- 不复制大段代码或正式文档;
- 不泄露敏感信息;
- 不把建议写成已经完成;
- 不把会话交接当作默认结束动作,只有确实中断、转交或压缩上下文时使用。
完成与接力
- 完成信号:接手者无需重读完整对话即可识别目标、正式产物、当前 Git 状态、验证状态、未完成事项和风险。
- 产物:对话中的脱敏 handoff(交接摘要),不写第二份项目状态文件。
- 候选出口:下一会话按摘要中已说明的当前目标选择
507-explore、507-grill、实施、507-review 或其他对应 skill;本会话到此结束。
- 回退条件:状态无法核实时明确写“不确定”和复验命令,不用推测填满摘要。