Skill/项目规划/Handoff
项目规划 307.9k 仓库 Star

Handoff

让新的会话接着当前进度做

Handoff 是把当前工作压缩成简明交接文档的 Skill。它保留后续执行需要的目标、完成情况、决定和待处理事项,并用路径或链接指向已有规格、提交和代码差异。适合准备换会话、交给另一位 Agent,或让同事接手尚未结束的工作时使用。

你需要准备:当前工作会话,以及下一位 Agent 或同事要继续做的事情

一桉AI 整理 · 2026.10.31 更新 · 查看 GitHub 来源

粘贴到 Codex,它会先检查安装条件,再引导你使用。

Handoff 能帮你做什么?

  • 提炼继续工作所需背景

    围绕下一会话的任务筛选信息,写清已经完成了什么、当前卡在哪里和哪些决定不能遗漏。

  • 引用已有工作产物

    通过文档路径、任务链接、提交和差异定位细节,减少重复复制已经维护好的项目材料。

  • 标明继续执行入口

    整理下一步、相关 Skill 和需要查看的文件,并移除密钥等不应进入交接文档的内容。

什么时候适合用?

下面是用法示例,可换成你的材料和目标。

  • 长任务需要换会话

    例如功能做到一半时保存当前实现、失败测试与下一步,让新会话先读取交接再核对项目。

  • 转交给审查者

    例如围绕准备审查的代码整理需求入口、变更范围和未解决问题,减少无关聊天信息。

怎么开始使用?

从材料到结果流程示意,非实测结果

当前进度与后续目标

准备这些材料项目会话交接

当前工作会话,以及下一位 Agent 或同事要继续做的事情

会话交接流程

  1. 01

    提炼进度与关键决策

  2. 02

    链接现有文件和证据

  3. 03

    整理下一步交接文档

准备什么,会得到什么?

准备的材料
当前工作会话,以及下一位 Agent 或同事要继续做的事情
交付的结果
  • 一份针对接手目标整理的交接文档及保存路径。
  • 已有产物的引用、下一步工作和相关 Skill 建议。

使用前要知道

需要当前会话上下文和文件读写,按完整 Matt 插件方案使用。上游默认保存到系统临时目录;交接不能还原未记录的思考,也不能保证新 Agent 自动读取所有链接。

常见问题

它会保存完整聊天记录吗?

它主要保留继续工作所需的信息,并引用已有产物。完整聊天转存是另一件事,通常也会带来更多无关内容。

为什么文档放在临时目录?

上游将它当作会话交接材料,默认避免直接加入项目。若希望长期留档,应明确保存位置,并整理成适合项目维护的文档。

GitHub 与官方参考

依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。

  • handoff · SKILL.md ↗2026-10-31 核对
  • Skills For Real Engineers · Codex 安装与项目说明 ↗2026-10-31 核对
来源与使用条件
原始项目
mattpocock/skills ↗
Skill 名称
handoff
Skill 目录
skills/productivity/handoff
仓库 Star
307,914 · 2026-10-31 核对,仅代表仓库关注度。
许可说明
MIT
使用条件
上游 Codex 插件;需要当前会话上下文和本地文件读写。按上游约定保存到系统临时目录,关联 Skill 的调用方式需映射到当前宿主。
注意事项
原版建议在交接中列出下一会话可能需要的 Skill;已有规格、提交、diff 用路径或链接引用,避免重复。需整插件核对工具映射,本站未运行实测。
查看安装与使用提示词
请帮我准备并使用 Handoff Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。

【来源与目标】
原始仓库:https://github.com/mattpocock/skills
所选目录:skills/productivity/handoff
参考分支:main
原始目录 frontmatter name:handoff
安装后的目标调用名:handoff
来源页面:https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff
安装路线核对日期:2026-11-01
handoff:当前源 SKILL.md:https://github.com/mattpocock/skills/blob/main/skills/productivity/handoff/SKILL.md
mattpocock/skills:当前安装说明:https://github.com/mattpocock/skills/blob/main/README.md
Matt Pocock:项目初始化助手:https://github.com/mattpocock/skills/blob/main/skills/engineering/setup-matt-pocock-skills/SKILL.md
Codex 显式调用策略:https://github.com/mattpocock/skills/blob/main/skills/productivity/handoff/agents/openai.yaml

【先检查环境,再安装】
先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。
下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。
这是插件安装路线。按下列官方入口安装完整插件;仅复制某个 Skill 目录不能代替插件、连接器或 MCP 配置。若当前 Codex 必须由用户在界面完成插件安装或授权,请给出准确入口和最短步骤,完成后再检查所选 Skill。

所选 Skill 的具体安装步骤:
1. 先检查 Codex 已安装插件与项目已有同名目录;选整插件路线,不再同时用 skills CLI 或手工复制相同条目。
2. 按当前 README 运行 codex plugin marketplace add mattpocock/skills,再运行 codex plugin add mattpocock-skills@mattpocock;保留插件管理的整个包和更新机制,不只复制该 Skill 文件。
3. 在用户选定的项目中显式调用 $setup-matt-pocock-skills(或 Skill 选择器中的同名助手),一次性确认 issue tracker、标签词汇和文档路径;可选本地文件,不要求用户先开通在线项目管理服务。
4. 安装完成先检查可发现状态;Skill 目录变化自动检测,未出现再新聊天或重载。涉及插件配置时按宿主原生提示处理。

必须保留的资源:
- skills/productivity/handoff/(整目录,含 agents/openai.yaml)
- skills/engineering/setup-matt-pocock-skills/(含 domain.md、issue-tracker-github.md、issue-tracker-gitlab.md、issue-tracker-local.md、triage-labels.md)
- 完整插件中被该流程调用的其他 Skills 与项目配置;由插件管理,不散落复制

已知依赖:上游 Codex 插件;需要当前会话上下文和本地文件读写。按上游约定保存到系统临时目录,关联 Skill 的调用方式需映射到当前宿主。
原项目许可:MIT
特别条件:原版建议在交接中列出下一会话可能需要的 Skill;已有规格、提交、diff 用路径或链接引用,避免重复。需整插件核对工具映射,本站未运行实测。
需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。

【安装后验收】
读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。
1. 检查插件来源是 mattpocock/skills,相关 Skill 与 setup-matt-pocock-skills 可发现,初始化配置文件已指向该项目。
2. 检查该目录 agents/openai.yaml 的 policy.allow_implicit_invocation 为 false,并明确需要手动选择 Skill。
3. 确认系统临时目录可用、当前会话上下文和引用文件可读取;安装检查不写交接文件,也不收集无关历史会话。
Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。
分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。

【接着引导我使用】
请使用实际可用的 $handoff;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。
- 显式调用 $handoff,并说明下一次会话要做什么;从当前讨论、现有规格、提交与差异整理状态,避免把完整日志和密钥放进去。
- 实际任务中将交接文档写到系统临时目录,输出真实路径;新会话必须主动读取该文件后才算接到上下文,不承诺自动同步。

我想完成的任务:
为后续会话整理一份交接文档,说明目标、已完成内容、关键决策、未解决的问题和下一步。引用已有文档、代码和提交位置,标出适合继续工作的 Skill;不复制密钥、密码或无关个人信息,并告诉我文档保存位置。

需要我提供的材料:
当前工作会话,以及下一位 Agent 或同事要继续做的事情

期望得到:
一份可交给新会话继续工作的交接文档及其本地路径。

先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。

相关 Skill

  • Leader目标任务书
  • Planning with Files多步骤任务规划
  • To Spec需求规格整理

复制到 Codex

浏览器暂未允许直接复制。点击下方文字,按 Ctrl+C(Mac 按 ⌘C)复制,再粘贴到 Codex。

三步开始使用

  1. 找到想做的事,点击「复制提示词」。
  2. 打开 Codex,把提示词粘贴进去并发送。
  3. 按它的提示提供文件或材料,继续完成任务。

按需安装就好,不用一次装完。部分 Skill 需要软件、账号或付费服务,Codex 会先检查使用条件。