mcpField
H
handoff

handoff

github.com/ashexplainedAgent 工作流44103 次安装18 周前更新
代码仓库

关于 handoff

用于编写简洁交接文档的技能,让新的 Agent 无需重读整段对话即可继续工作。它将下一步目标、当前状态、未决问题、相关材料和结果回传说明保存到带日期的文件中。

主要功能

  1. 01明确下一会话的任务重点
  2. 02保存带日期的交接记录
  3. 03记录当前状态和未决问题
  4. 04引用相关项目材料
  5. 05避免重复记录长期决策

适用场景

  1. 01切换到其他技能或 Agent
  2. 02将支线任务交给另一会话
  3. 03结束较长的规划或实现讨论

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ashexplained/roblox-skills --skill handoff

安装后在 Claude Code 中输入/handoff确认已加载。

详细介绍

交接

编写一份简洁的交接文档,让新的 Agent 无需重读整个对话,也能从当前状态继续工作。

适用场景

  • 用户请求 /handoff、“交接这个”、“交接给 /prototype”、“交接回来”、“总结给下一次会话”,或“让另一个 Agent 继续”。
  • 一段较长的规划、原型设计、诊断或实现对话即将切换重点或结束。
  • 某项支线任务需要在另一个会话中执行,并返回简短结论。

流程

  1. 确定交接目标。如果用户提供了参数,将其视为下一次会话的重点,例如 /prototype、/tdd 或“返回游戏测试会话”。
  2. 如有需要,创建 .scratch/handoffs/。
  3. 将交接内容保存为 .scratch/handoffs/YYYY-MM-DD-<short-slug>.md。使用当前本地日期,并根据目标或主题设置 slug。如果文件已存在,则追加简短的数字后缀,而不要覆盖。
  4. 写入前,先读取该路径下的现有文件,以免覆盖已有记录。
  5. 只写下一位 Agent 实际需要的上下文。

内容

包括:

  • 目标:下一次会话应完成什么。
  • 当前状态:已做出的决定或已完成的工作。
  • 尚未解决的关键问题。
  • 相关资料:PRD、问题、ADR、设计文档、原型路径、提交、差异、URL。
  • 建议的下一项技能或命令。
  • 返回说明:应将什么结果交回当前对话或父级技能。

不要重复 PRD、计划、ADR、问题、提交、差异或原型记录中已有的内容。请通过路径或 URL 引用这些资料。

示例

  • “交接给 /prototype” -> 说明原型需要回答的问题、相关应用或模块背景,以及原型输出可随时丢弃。
  • “交接回来” -> 总结支线任务的发现、资料所在位置,以及现在可以做出的决定。
  • “交接给实现阶段” -> 指向已批准的 PRD、问题和设计资料,并注明剩余风险。

反面做法

  • 不要把交接写成完整的项目历史。
  • 不要写“继续工作”之类含糊的指令;应明确下一步要做什么。
  • 不要只把持久有效的项目决策写在 CONTEXT.md、ADR、问题或 PRD 中。应将决策记录在相应资料中,并在交接里附上链接。

下一步

使用你指定的交接目标技能开启下一次会话(例如 roblox-to-issues、roblox-debugging-bugfix 或 roblox-game-development-lifecycle)。支线任务返回后,再次使用 handoff 将结论交接回来。

评论

支持 Markdown