一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | handoff-mattpocock-skills | 合集仓库子目录名（见下方说明） |
| 项目自述名称 | handoff | SKILL.md frontmatter |
| 所属合集仓库 | mattpocock/skills（Matt Pocock 个人维护的 Agent Skills 公开仓库） | GitHub |
| 作者/维护者 | Matt Pocock（Total TypeScript 创始人，AI 工程教育者，个人 Newsletter 约 6 万订阅者） | 仓库 README |
| 来源链接 | https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff | — |
| 许可证 | MIT | GitHub API |
| 所属仓库整体 Stars/Forks | 174,200 / 14,945（注：该数字属整个合集仓库，不代表本技能自身热度，仅供了解仓库整体规模） | GitHub API |
| 该技能自身活跃度 | GitHub 全站代码搜索中，路径命中 “productivity/handoff”（限定本仓库上下文）共 850 处；≥5 篇独立第三方文章专门介绍本技能（Medium、AI Coding Daily、Agent Cookbooks、Modern Creator 等） | GitHub Code Search API + WebFetch |
| 最新版本 | v1.1.0（2026-07-08 全仓库统一发版）；该子目录最近一次提交 2026-07-13（新增 agents/openai.yaml 元数据，为 Codex 等兼容运行时提供技能声明） |
GitHub Commits API |
| 安装方式 | npx skills@latest add mattpocock/skills 或 Claude Code 插件市场一条命令安装（见第十章） |
官方 README |
二、功能介绍与亮点
handoff 把当前对话压缩成一份交接文档（handoff document），让另一个全新会话——甚至另一个 agent 工具——可以从中断处无缝接续工作。
核心能力：
- 只留活的信息，不复述死的信息：已经沉淀进 spec、plan、ADR、issue、commit、diff 里的内容一律只引用路径/链接，绝不重复誊抄；文档只保留“在做什么、为什么、下一步是什么”这条活线索
- 默认存到系统临时目录，不进工作区：交接文档不会变成又一份需要长期维护的工件
- 支持定向聚焦：可传入参数说明“下一个会话要做什么”，技能据此裁剪交接内容，并主动建议下一个会话应加载哪些技能
- 主动脱敏：生成前对 API key、密码、PII 等敏感信息做红线过滤
- 跨工具而非只跨会话：可以在 Claude Code 里规划、交接给 Codex 去实现，或把一个大任务拆给多个并行 worktree 分头处理
作者本人在 12 分钟教学视频中称其为“新晋最爱技能”，多篇独立技术博客将其列为“AI 编程会话中几乎每次都会用到”的核心工具。
三、适用场景
固定分类：元技能与 Agent 增强
适用于：单次会话即将触及上下文长度上限、需要把一个大任务拆分给多个并行 agent 会话分头处理、或需要把“规划”与“实现”分置于不同工具（如 Claude Code 规划、Codex 实现）的场景。受益人群：日常运行多个并行 AI 编程会话的工程师、习惯把大任务拆解成独立可交付子任务的团队、以及希望保持主会话“纯净”不被支线任务污染上下文的资深用户。若平时只做单一线性对话或刚接触 agent 工作流，价值相对有限。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 README 提供 Claude Code 插件市场安装路径，SKILL.md 按标准格式编写，可被模型据描述自动触发 |
| Codex | 原生支持 | 2026-07-13 提交为该技能新增 agents/openai.yaml 元数据文件，专为 Codex 等遵循该元数据规范的运行时提供技能声明；独立第三方评测（Modern Creator）亦证实其在 Codex 中可用 |
| OpenClaw | 未验证 | 已抓取材料未提及 OpenClaw 专门支持，未为此单独搜索 |
| Hermes Agent | 未验证 | 同上 |
五、推荐理由
多阶段任务一旦超出单次会话的上下文窗口，要么被迫在同一个对话里越堆越乱，要么手动写交接说明浪费时间还容易漏关键信息。handoff 把“压缩当前进度、只留活信息、主动脱敏”这套纪律封装成一条命令，让并行开展多条工作线、或换用另一个 agent 工具接力，成为可以随手做的动作而不是额外负担。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 单个子技能维度：GitHub 代码搜索命中 850 处，Medium、AI Coding Daily、Agent Cookbooks、Modern Creator 等 ≥5 个独立平台专门撰文介绍并给出真实使用案例，另被多个技能市场收录（合集仓库整体 stars 属整个仓库，不代表本技能自身热度，未计入本项） |
| 可用性 | 9 | 一条命令安装（skills.sh 或 Claude Code 插件），文档完整含具体交互示例，2026-07-13 仍有更新提交，无付费依赖，且不依赖仓库级 /setup-matt-pocock-skills 配置向导即可独立使用 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 9.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 极小——SKILL.md 主体为自然语言指令，核心动作是读取当前会话上下文并写入一个 markdown 文件到系统临时目录，未见执行外部脚本或系统命令 |
| ② 运行时联网外发数据 | 无——技能本身不发起任何网络请求，纯本地文件 I/O |
| ③ API Key/凭据要求及存储方式 | 无需任何凭据；且技能会在生成交接文档前主动检测并红线过滤 API key、密码、PII 等敏感信息 |
| ④ 可疑指令/Prompt Injection 迹象 | 未发现——SKILL.md 内容均经审阅，为正常工程指令，无越权操作或隐藏指令 |
| ⑤ 作者/组织信誉 | Matt Pocock，真实身份公开，Total TypeScript 创始人，长期从事 TypeScript/AI 工程教育，公开 Newsletter 约 6 万订阅者 |
| ⑥ License 是否明确 | MIT，明确 |
| ⑦ 最近维护时间 | 该子目录最近一次提交 2026-07-13（新增 Codex 元数据），仓库整体近一天内仍有提交，维护非常活跃 |
七、跟同类 Skills 相比的优势
| 维度 | handoff（本推荐） | claude-mem | planning-with-files |
|---|---|---|---|
| 核心机制 | 把当前会话压缩为一次性交接文档，供新会话/新 agent 接续 | 跨会话持久化记忆库，长期积累项目知识 | 把任务计划显式写入文件，供后续会话或协作者查阅 |
| 解决的问题 | 单次会话内的上下文耗尽与任务切换 | 长期、跨多次会话的知识遗忘 | 计划本身的可见性与可追溯性 |
| 产出物生命周期 | 一次性、默认存临时目录，不进工作区 | 持久化记忆库，长期保留 | 长期保留在项目文件中 |
| 跨工具能力 | 明确支持跨工具接力（如 Claude Code 规划、Codex 实现） | 未见跨工具设计，聚焦同一 agent 内的记忆 | 依赖文件本身的可移植性，未内置跨工具引导 |
| 定位 | 解决“这一次任务交接”的战术工具 | 解决“长期记住项目”的基础设施 | 解决“计划可见”的协作规范 |
三者并不互斥：claude-mem 负责长期记忆、planning-with-files 负责计划留痕，而 handoff 专门解决“这一次上下文快满了，怎么干净地换一个会话继续”这个高频战术问题，三者可以同时使用。
八、用户评价
- Nowshad Jawad（Medium 技术博客作者）：“it prevents tangents from ballooning into sprawling conversations and preserves the smart zone”，并分享真实案例：在功能讨论中用 handoff 把认证重构工作交给另一个会话处理，完成后把结论带回主会话，体验“像和同事协作一样”，文末评价该技能“reshaped how I plan, code and document”
- Modern Creator（编辑团队，技术内容评测平台）：评价其“compresses the relevant slice of a current Claude Code session into a disposable markdown document so a fresh parallel agent can continue scoped work”，指出其价值在于让会话保持在约 12 万 token 的“高质量区间”内，同时点明局限——只做单线性对话、或刚接触 agent 工作流的用户获益有限
九、其他补充
该技能与仓库内的 diagnosing-bugs、grill-with-docs 同属 Matt Pocock 个人技能集合，三者可以组合使用：先用 grill-with-docs 或 diagnosing-bugs 完成某个子任务的深入调查，再用 handoff 把结论交接出去，避免主会话被支线调查过程稀释。仓库通过作者约 6 万订阅的技术 Newsletter 持续同步更新动态。
十、安装使用方式
方式一：skills.sh 安装器（可编辑，推荐希望二次定制的用户）
npx skills@latest add mattpocock/skills安装时按提示勾选 handoff 及目标 agent 即可，无需先运行 /setup-matt-pocock-skills。
方式二：Claude Code 插件（只读、随作者更新自动同步）
/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocock触发方式：在会话中直接调用 /handoff，可选传入参数说明“下一个会话聚焦什么”；技能会读取当前上下文、脱敏后生成 markdown 交接文档并给出建议加载的技能清单。
十一、注意事项
- 目前由 Matt Pocock 个人维护，尚无多维护者的治理结构，需自行评估长期维护的连续性风险
- OpenClaw、Hermes Agent 的兼容性未在已抓取材料中得到证实，标记为“未验证”
- 交接文档默认写入系统临时目录而非工作区，如需长期保留需自行另存
- 面向“多线并行工作”场景设计；若日常只做单一线性会话，本技能带来的增量价值有限