关于 handoff
用于编写简洁交接文档的技能,让新的 Agent 无需重读整段对话即可继续工作。它将下一步目标、当前状态、未决问题、相关材料和结果回传说明保存到带日期的文件中。
主要功能
- 01明确下一会话的任务重点
- 02保存带日期的交接记录
- 03记录当前状态和未决问题
- 04引用相关项目材料
- 05避免重复记录长期决策
适用场景
- 01切换到其他技能或 Agent
- 02将支线任务交给另一会话
- 03结束较长的规划或实现讨论
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ashexplained/ roblox-skills --skill handoff安装后在 Claude Code 中输入/handoff确认已加载。
详细介绍
交接
编写一份简洁的交接文档,让新的 Agent 无需重读整个对话,也能从当前状态继续工作。
适用场景
- 用户请求
/handoff、“交接这个”、“交接给 /prototype”、“交接回来”、“总结给下一次会话”,或“让另一个 Agent 继续”。 - 一段较长的规划、原型设计、诊断或实现对话即将切换重点或结束。
- 某项支线任务需要在另一个会话中执行,并返回简短结论。
流程
- 确定交接目标。如果用户提供了参数,将其视为下一次会话的重点,例如
/prototype、/tdd或“返回游戏测试会话”。 - 如有需要,创建
.scratch/handoffs/。 - 将交接内容保存为
.scratch/handoffs/YYYY-MM-DD-<short-slug>.md。使用当前本地日期,并根据目标或主题设置 slug。如果文件已存在,则追加简短的数字后缀,而不要覆盖。 - 写入前,先读取该路径下的现有文件,以免覆盖已有记录。
- 只写下一位 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