Agent Skills
返回列表
🤖

代理工作交接

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sammcj-agentic-coding-handoff。

技能介绍

长会话被截断时,上下文怎么交给下一个 Agent

在 IDE 或 CLI 里用 Agent 改代码,常会遇到一次对话装不下完整上下文、要换新会话或换模型继续的情况。若只靠复制粘贴聊天记录,下一位 Agent 既容易重复读 spec/plan/ADR,也可能撞上已写入 workspace 的草稿里残留的 API Key。Handoff 针对的是:把「当前这条对话里还剩什么活、该信哪些外部产物」整理成一份独立交接文档,而不是再生成一份项目说明书。

技能实际做了什么

触发后,技能会基于当前会话写 handoff 文档,并按要求保存到操作系统临时目录(刻意不落在当前 workspace,避免和仓库内既有文档搅在一起)。文档里通常包含:

  • 会话摘要:目标、已做决策、未完成项与阻塞点
  • suggested skills 段:建议下一会话应调用的技能名称或用途
  • 外部引用:对 spec、plan、ADR、issue、commit、diff 等只给路径或 URL,不重复正文
  • 脱敏:API keys、密码、PII 等敏感内容在交接稿中剔除或打码

若调用时带了参数,技能会把参数当作「下一跳会话的重点」,据此收窄摘要与建议技能列表。

边界与注意点

Handoff 不负责替代版本库里的正式设计文档,也不保证下一位 Agent 会自动执行 suggested skills——它只是把续作所需的最小上下文结构化写出来。临时目录路径因 OS 与用户而异,交接后需要你自己把文件路径告知新会话,或按你们团队的交接流程归档。

使用场景

  • 长 refactor 触及上下文上限,需在换会话前把未完成子任务与相关 PR diff 路径交给下一位 Agent
  • 多人轮流在同一仓库用 Agent 排障,要统一引用 issue 编号与 ADR 路径而不重复粘贴全文
  • 会话里出现过测试用 API Key,交接文档需脱敏后再交给外包协作者开启的新 Agent 会话
  • 用户传入「下一跳只做集成测试」等参数,希望交接稿只围绕该范围列出建议技能与阻塞项

适合人员

  • 在 Cursor/CLI 里日均可跑多轮 Agent 会话的全栈工程师,需要在换模型时保留决策与待办
  • 维护多份 spec 与 ADR 的 Tech Lead,希望续作会话只跟链接走、不在交接里复制设计正文
  • 带外部协作者做 Agentic 试点项目的 EM,要求交接文件落在临时目录且默认脱敏密钥
  • 编写自定义 Agent 工作流的平台同学,想在会话切换点自动生成 `suggested skills` 提示下一跳能力