handoff

这是什么？适合谁？

handoff 是 Matt Pocock 的 Claude Code Skills 套件中的生产力技能，用于将当前 AI 会话内容压缩为一份”交接文档”，让另一个 Agent 可以无缝继续工作。它解决了多 Agent 协作中上下文丢失的核心痛点。

适合人群：

• AI 重度用户：需要多个 Agent 协作完成复杂任务
• 开发者：使用 Claude Code、Codex 等 AI 编程助手
• 团队协作者：需要将 AI 会话的上下文传递给同事
• 长时间任务执行者：需要跨会话保持工作连续性

核心价值：自动压缩会话上下文为结构化文档，避免重复描述，提升 Agent 协作效率。

准备工作

• Claude Code：安装 Claude Code 或 Codex 等支持 Skills 的 Agent
• 安装 Skills 套件：

  # Claude Code 插件方式
  claude plugins install mattpocock-skills
  
  # 或 skills.sh 方式（可编辑）
  npx skills@latest add mattpocock/skills
  

• 运行 setup：在项目中运行 /setup-matt-pocock-skills 配置
• 时间预算：安装 30 秒，首次使用 1 分钟

快速上手

第一步：安装 Skills

选择一种安装方式：

• Claude Code 插件（推荐）：claude plugins install mattpocock-skills，自动更新
• skills.sh：npx skills@latest add mattpocock/skills，可编辑和自定义

第二步：配置

在 Agent 会话中运行 /setup-matt-pocock-skills，配置文档存储位置。

第三步：使用 handoff

在完成一段工作后，输入 /handoff，Agent 会：

1. 分析当前会话的完整上下文
2. 提取关键决策、待办事项、已完成工作
3. 生成结构化的交接文档
4. 保存到指定位置

示例产出：

# Handoff: 用户认证模块开发
- 已完成：登录 API 实现、JWT 配置
- 进行中：密码重置流程（60%）
- 待决策：是否使用 OAuth 2.0
- 关键文件：src/auth/login.ts, src/auth/jwt.ts

预期产出：一份 200-500 字的交接文档，包含完整的上下文和决策记录。

常见踩坑

1. 会话过长导致压缩信息丢失：如果会话非常长（>100 轮对话），handoff 压缩时可能丢失一些细节。建议在关键决策点及时执行 handoff，而非等到会话结束。来源：Matt Pocock 文档。

2. 交接文档的位置需要提前配置：如果未运行 setup 配置文档存储位置，handoff 可能将文档保存在默认位置，后续 Agent 可能找不到。务必先运行 /setup-matt-pocock-skills。

3. 不同 Agent 的 Skill 格式兼容性：handoff 生成的文档依赖目标 Agent 能正确解析。如果切换 Agent 平台（如从 Claude Code 到 Codex），交接文档的格式可能需要适配。

4. 不要过度依赖 handoff：虽然 handoff 能压缩上下文，但复杂的架构决策和设计意图可能无法完全通过文档传递。对于关键决策，建议人类也在场确认。

5. 敏感信息可能被包含在交接文档中：handoff 会压缩会话中的所有内容，包括你可能不想保留的敏感信息。执行 handoff 前，确认会话中没有不应被记录的敏感数据。

常见问题 FAQ

Q1：handoff 和 /to-spec 有什么区别？

A：handoff 是会话压缩工具，用于 Agent 间交接；/to-spec 是将讨论转化为正式规格文档，发布到 issue tracker。handoff 更轻量、更快速。

Q2：生成的交接文档保存在哪里？

A：取决于 setup 时的配置。通常保存在项目文档目录（如 docs/ 或 .agents/），文件名包含时间戳和主题。

Q3：能否自定义交接文档的格式？

A：使用 skills.sh 安装方式可以编辑 Skill 文件，自定义 handoff 的输出格式。Claude Code 插件方式为只读。

Q4：需要什么 AI 模型支持？

A：handoff 使用 Agent 的默认模型，无需特殊配置。推荐使用 Claude 3.5 Sonnet 或更高版本以确保压缩质量。

Q5：Matt Pocock Skills 套件还有哪些其他技能？

A：包括 /grill-me（深度访谈）、/tdd（测试驱动开发）、/triage（工单分类）、/improve-codebase-architecture（代码架构优化）等 20+ 个技能。

初级用法

1. 基本交接：在会话中输入 /handoff，自动生成交接文档
2. 指定主题：/handoff 认证模块，聚焦特定主题生成交接文档
3. 交接给同事：生成文档后，将文件路径发送给同事，他们的 Agent 可以读取
4. 跨会话连续工作：每天开始时，让 Agent 读取昨天的 handoff 文档，快速恢复上下文
5. 会议记录：在讨论结束后使用 handoff 生成会议摘要和决策记录

高级玩法

1. 多 Agent 流水线：Agent A 完成需求分析 → handoff → Agent B 进行架构设计 → handoff → Agent C 实现代码
2. 定期快照：每完成一个里程碑就执行 handoff，形成项目进展的时间线
3. 结合 CONTEXT.md：将 handoff 文档的关键信息同步到项目 CONTEXT.md，构建项目知识库

小技巧

1. 在关键决策点（架构选择、API 变更）立即执行 handoff，而非等到会话结束
2. 给 handoff 文档命名时包含日期和主题，便于后续查找
3. 定期清理过期的 handoff 文档，避免知识库膨胀
4. 将 handoff 文档纳入版本控制，跟踪项目决策历史
5. 在团队中约定 handoff 的使用时机和格式标准

参考链接

• mattpocock/skills GitHub
• handoff Skill 源码
• skills.sh

基于公开资料整理，AI 辅助生成，采集日期：2026-08-12。具体功能以官方文档最新信息为准。