SuperAPI AI 工具集

handoff

智能体与模型

查看项目

更新于 10-16 00:24

技能介绍

用途:把一次长会话或卡住的会话整理成交接文档 HANDOFF.md,供全新 Claude 会话接续工作。适用于会话过长、Claude 反复尝试同一失败方案、用户想暂时离开后恢复、/compact 后仍缺乏清晰方向,或用户说要 handoff、开始新会话时。

主要能力:要求在写之前先梳理整段对话的脉络,面向从未见过该对话的 Claude 编写。必含章节:目标(一段话说清最终状态)、当前状态(可用与损坏之处、问题确切症状、原样错误信息)、涉及文件(本会话读过/改过/创建的相关文件及其重要性)、已尝试方案及失败原因(最重要,需说明为何失败)、当前最佳思路(含依据)、后续步骤(具体有序,含路径、函数名、命令)、关键约束与上下文(环境、用户偏好、明确禁止项、外部依赖、性能要求)、记忆指针(若 claude-mem 搜索工具可用,搜索关键术语并列出关键 observation ID,供 get_observations 拉取详情,并列出值得重跑的查询;工具不可用则跳过)。

使用方式:生成后写入当前工作目录(项目根)的 HANDOFF.md,使用指定标题结构(Handoff、Generated 时间戳、项目、会话摘要,以及 Goal、Current State、Files in Play、What Has Been Tried、Current Best Theory、Next Steps、Key Constraints、Memory Pointers 等章节)。写完后告知用户:已写 HANDOFF.md,运行 /clear 或开新 Claude Code 会话,在新会话中说“Read HANDOFF.md and continue from where we left off.”,claude-mem 会自动提供近期时间线,HANDOFF.md 是其之上的精确简报。HANDOFF.md 属临时文件,不要提交,新会话接手后删除或加入 .gitignore。

写作规则:面向新 Claude 而非用户;极度具体,避免“修复认证”这类模糊步骤;包含确切错误信息、堆栈或测试输出;不写填充内容;不用用户视角。

限制:资料未提供安装方式、收费、价格、平台或效果信息;Memory Pointers 章节依赖 claude-mem 搜索工具是否可用。