SuperAPI AI 工具集

handoff

办公与效率

查看项目

更新于 10-16 07:24

技能介绍

用途:把当前对话压缩成一份自包含的交接文档,让一个全新上下文窗口、没有任何本次对话记忆的智能体接手继续工作。常见于跨仓库交接,例如一个仓库做后端、另一个智能体做前端。

主要能力与存放规则:交接文档必须让新上下文中的智能体容易找到,不能存到临时目录。始终写入当前 git 仓库根目录下的 .claude/handoffs/,并向用户告知精确绝对路径。目录不存在时创建:mkdir -p <repo-root>/.claude/handoffs。文件命名约定为 <from-repo>to<to-repo><short-slug>.md,例如 services__to__web__teammate-invite-api.md;同仓库仅换会话则用 <repo><short-slug>.md。同时维护最新交接的指针 <repo-root>/.claude/handoffs/LATEST.md,每次覆盖为最新文件的一行链接加一行摘要,新智能体可先读 LATEST.md。跨仓库时需给出文件绝对路径。

使用方式:写完后在回复末尾给出可直接复制的指令,例如在 web/ 启动下一个智能体并粘贴:Read /abs/path/to/services/.claude/handoffs/services__to__web__teammate-invite-api.md and continue from there.。接收方若被要求或怀疑存在交接,可读 <repo-root>/.claude/handoffs/LATEST.md,或列出目录挑选 to<你的仓库>__ 匹配的文件。

应包含内容:保持精简,是压缩而非逐字转录,优先用链接而非复制。包括目标(一两句)、目标仓库与工作位置(cd 到哪、分支/工作区、如何运行构建测试)、当前状态(已完成、进行中、已验证与假定,当前分支及未提交变更)、跨仓库契约(API 端点与形状、类型、事件名、功能开关、环境变量、生成的客户端、schema)、下一步有序任务清单、注意事项与决策(非显然约束、已试过的死路及原因)、建议使用的技能。引用而非复制大块产物,可链接 spec、issue/PR、commit SHA,使用 file_path:line_number 便于跳转。

安全与定制:写文件前脱敏所有密钥与个人身份信息,如 API key、token、密码、连接串、客户数据、个人邮箱姓名,替换为 <REDACTED: 描述>。若用户传入参数说明下次会话重点(如只交接前端或迁移),应据此裁剪交接范围。

限制:仓库未提供的具体安装命令、版本要求、收费方式等事实暂未提供。