关于 handoff
handoff 是为当前对话生成交接文档的技能,帮助新的 Agent 了解任务背景、进度和后续工作。文档按指定结构保存到临时目录,并排除敏感信息及其他产物中已有的内容。
主要功能
- 01总结背景、目标与已完成工作
- 02记录当前状态和待办事项
- 03推荐后续可用技能
- 04引用已有文档而不重复内容
- 05脱敏并保存到临时目录
适用场景
- 01在会话结束时整理任务交接
- 02让新的 Agent 接续未完成的工作
- 03记录分支、配置等必要上下文
- 04过滤交接文档中的敏感信息
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ feiskyer/ claude-code-settings --skill handoff安装后在 Claude Code 中输入/handoff确认已加载。
详细介绍
来自项目 README撰写一份交接文档,总结当前对话内容,使全新的 agent 能够无缝继续工作。
输出位置
保存到 $TMPDIR/handoff-YYYY-MM-DD-HHMM.md(用实际时间戳替换)。生成后告知用户完整路径。
文档结构
按以下结构组织交接文档:
- 背景与目标 — 一句话概述当前任务
- 已完成工作 — 带路径/URL 引用
- 当前状态 — 进展到哪一步、卡在哪里
- 待办事项 — 下一个 agent 需要做什么
- 推荐技能 — 建议调用的 skill 列表
- 关键上下文 — 环境、分支、配置等必要信息
规则
- 不要重复已存在于其他产物(规格文档、计划、ADR、issue、commit、diff)中的内容,改为通过路径或 URL 引用。
- 脱敏处理:删除 API key、密码、个人身份信息等敏感内容。
- 如果用户传入了参数,将其视为下一次会话的重点方向,据此调整文档内容。
- 如果当前对话极短(少于 3 轮实质交流),直接告知用户无需生成交接文档,除非用户坚持。
评论
支持 Markdown