会话交接

工程开发 社区

技能解读

设计思路

handoff 是 mattpocock 的「session 交接」skill——给当前对话写一份新 agent 能直接续接的交接文档。设计极简但有几条硬纪律:用 mktemp -t handoff-XXXXXX.md 拿到唯一路径,写之前先 read(避免覆盖既有内容),不和 PRD / plan / ADR / issue / commit / diff 等已有载体重复——后者用路径或 URL 引用即可。

工作流(按作者原文凝练)

  1. 用 mktemp -t handoff-XXXXXX.md 生成临时路径
  2. 先 read 这个文件(极简但重要的安全习惯,避免某些情况下文件已存在)
  3. 写一份摘要:当前对话进展到哪、未决问题、阻塞点、下一步
  4. 在文档里建议下一 session 该用的 skill(比如「先跑 writing-plans,因为 design 已经定了」)
  5. 已经在别处沉淀的内容——PRD、plan、ADR、issue、commit、diff——只引用路径或 URL,不复制粘贴
  6. 如果用户传了参数,把参数视作下一 session 的聚焦方向,按这个方向裁剪文档

适合谁

  • 长任务做到一半要交给同事 / 另一台机器继续的人
  • 即将上下文耗尽前想留 handover 给新 session 的工程师
  • 多人协作 pair-agent 模式中转切换

不适合

  • 任务一两小时就能做完——直接告诉对方就行
  • 已经有完整 context-save 文件——本 skill 是更轻量的姊妹,重复

配套

context-save(gstack 等价的更结构化版本)、landing-report(事件级总结报告)、pair-agent(同时协作的另一个 agent)。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@hta218 · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步:收集背景信息

并行运行这些命令以了解当前状态: `git status` — 查看所有跟踪/未跟踪文件和暂存状态 `git diff` — 查看未暂存的更改 `git log --oneline -10` — 最近提交以了解工作轨迹 `git branch --show-current` — 当前分支名称

02
第2步:确认保存位置

列出 `.specs/` 中的所有文件夹 将当前分支名称、修改的文件或最近提交消息与规范文件夹名称相匹配 使用 `AskUserQuestion` 与用户确认保存位置:如果找到可能的匹配项,建议将其作为推荐选项 始终包含其他规范文件夹作为替代方案

03
第三步:分析工作状态

已完成的工作 — 分析最近的 git 提交、审查已完成的待办事项、识别所做更改的模式 正在进行的工作 — 活动的待办事项、未提交的更改、当前正在修改的文件 剩余工作 — 待处理的待办事项、阻碍因素、依赖项、优先级 上下文 — 分支策略、重要决策、已知问题、带有行号的相关文件路径

04
第四步:编写交接文件

在确认的位置将文件另存为`handoff--{YYYY-MM-DD-HH-mm}--{brief-work-summary}.md`。使用 `date +"%Y-%m-%d-%H-%M"` 获取正确的本地时间戳 `{brief-work-summary}` 是对作品的简短描述(例如,`add-cart-api`、`fix-auth-redirect`、`refactor-review-section`) 使用以下结构:

05
第五步:报告

保存后,显示: 保存切换的完整文件路径 当前状态的简要摘要

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。