1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | handoff-openclaw-agent-skills |
| 作者/维护者 | OpenClaw 组织（该技能由创始人 Peter Steinberger 编写） |
| 来源链接 | https://github.com/openclaw/agent-skills/tree/main/skills/handoff |
| 许可证 | MIT |
| GitHub Stars | 1,033（GitHub API；为 agent-skills 合集仓库整体数字，不代表本技能自身热度） |
| Forks | 80（同上，合集仓库整体） |
| 最新版本 | 未发布正式 Release/Tag（GitHub API 查询为空） |
| 安装方式 | git clone 后运行仓库自带的 scripts/install-skills，或直接软链接单个技能目录 |
2. 功能介绍与亮点
Handoff 帮你把当前会话里没做完的任务，写成一份可以直接粘贴给另一个 agent 会话的交接 prompt，并自动复制到系统剪贴板。核心工作流分五步：识别任务、收集必要上下文（仓库/产品身份、相关 issue-PR-分支、约束与已知症状）、撰写一份独立可读的 prompt、复制到剪贴板、给出一句简短确认。
亮点在于对“交接质量”的把关：
- 强制接收方先独立审查——prompt 模板明确要求新 agent 在动手前做完整独立审查，自行判断这个任务是否还成立、方向是否合理、有没有更小的修法，而不是拿到指令就无脑执行；
- 禁止路径泄漏——不写绝对路径、家目录路径或仓库相对路径，改用仓库名、issue/PR 链接、分支名、符号名、报错原文等可移植锚点，换一台机器、换一个工作区依然有效；
- 明确越权边界——模板自带一条规则，告诉接收方在没有被明确要求时不得 push、merge、关闭 issue/PR 或发布公开评论；
- 质量红线——不允许编造未核实的事实，不做“一股脑倾倒上下文”，只给恰好够用的信息。
3. 适用场景
固定分类：元技能与 Agent 增强（该技能的主体是“agent 之间如何交接任务”这一协作原语本身，不服务于任何具体业务领域）。
典型场景：当前会话上下文快要用完、想换一个更擅长该领域的 agent 接手、需要把调查交给同事的 agent 继续、或者只是想在讨论到一半时把问题带到一个全新的会话里重新梳理。目标用户是日常用 Claude Code / Codex 等编码 agent 处理多步骤任务、经常需要跨会话或跨人交接调查进度的开发者。
4. 跨 Agent 兼容性
- Claude Code：原生支持——README 给出具体命令，将
skills/软链接进~/.claude/skills。 - Codex：原生支持——README 给出具体命令，将
skills/软链接进~/.codex/skills。 - OpenClaw：未验证具体挂载路径——本仓库由 OpenClaw 组织官方维护，但 README 只给出 Claude Code 与 Codex 的软链接示例，安装脚本默认目标路径是通用的
~/.agents/skills，未见 OpenClaw 专属路径的直接说明。 - Hermes Agent：未验证——现有材料未提及。
5. 推荐理由
这是 OpenClaw 官方团队自用并对外开源的多 agent 协作原语，由创始人亲自编写，解决的是一个具体又常见的问题：交接任务时，接收方常常是拿到指令就开始改代码，而不是先判断这活儿还该不该做。Handoff 把“先独立审查、再动手”写进了 prompt 模板本身，一步复制到剪贴板即可用，没有任何外部服务依赖或付费门槛。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 合集仓库 stars 不计入单个技能；该技能自身在 skills.sh 上有 56 次独立安装，由知名开发者 Peter Steinberger 本人编写并维护在其官方仓库中 |
| 可用性 | 9 | 单文件 SKILL.md，无需额外配置或付费依赖，文档含完整流程说明与 prompt 模板；所在仓库近日仍有提交，维护活跃 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
① 代码执行——仅调用本机剪贴板命令（pbcopy/wl-copy/xclip/clip.exe，按系统自动选择），范围明确、无破坏性操作；
② 联网外发——无，全程本地文本生成与剪贴板写入；
③ 凭据处理——不涉及任何 API key 或凭据；
④ 可疑指令——正文清晰，未发现隐蔽指令或混淆代码；
⑤ 作者信誉——OpenClaw 官方组织仓库，技能作者为该组织创始人；
⑥ License——MIT，明确；
⑦ 维护时间——该技能最近一次修改约 7 周前，所在仓库整体在近日仍有新提交。
7. 跟同类 Skills 相比的优势
| 对比对象 | 交接产出形式 | 设计侧重 |
|---|---|---|
| 本技能（handoff-openclaw-agent-skills） | 直接生成 prompt 并复制到剪贴板，即时粘贴进新会话 | 强调“先独立审查再动手”的显式行为约束，轻量、无持久化文件 |
| Handoff（mattpocock/skills，productivity 分类） | 通过 mktemp 生成一份持久化的 Markdown 交接文件，含目标、现状、待决策项、推荐后续技能、既有产出物引用五个结构化章节 |
强调把交接内容沉淀成文件供长期查阅，避免与 PRD/计划/ADR 等已有产出物重复 |
两者解决的是同一类“跨会话交接”问题，但取舍不同：mattpocock 版本产出的是一份可归档、结构固定的交接文档，适合需要留痕或多人协作查阅的场景；本技能产出的是一次性、即时可粘贴的对话式 prompt，流程更轻，且额外把“接收方必须先独立审查、不得越权操作”写成了强制规则，更适合快速换会话继续调查这种轻量场景。
8. 用户评价
目前未检索到关于本技能的独立第三方用户评价。第三方安装平台 skills.sh 记录其安装量为 56 次，可作为使用规模的旁证，但不构成评价内容。
9. 其他补充
该技能所在的 openclaw/agent-skills 仓库同时收录了 session-viewer（本地可搜索的会话 HTML 查看器）等多个会话相关技能，可与本技能配合使用——先用 handoff 交接任务，接手方再用 session-viewer 回看原会话细节。仓库以 MIT 协议开源，采用软链接为主的分发方式，也支持复制安装以适配锁定环境。
10. 安装使用方式
git clone https://github.com/openclaw/agent-skills.git
cd agent-skills
# 仅安装 handoff 一个技能（默认软链接进 ~/.agents/skills）
scripts/install-skills handoff
# 或手动软链接进 Claude Code
mkdir -p ~/.claude/skills
ln -sfn "$(pwd)/skills/handoff" ~/.claude/skills/handoff
# 或手动软链接进 Codex
mkdir -p ~/.codex/skills
ln -sfn "$(pwd)/skills/handoff" ~/.codex/skills/handoff安装后无需重启 agent；对话中说出 handoff <任务>、“write a handoff”、“delegate this” 等短语即可触发。默认行为是把生成的 prompt 复制到剪贴板并给出一句简短确认，不会主动粘贴完整内容，除非用户明确要求查看。
11. 注意事项
- 依赖本机剪贴板工具（
pbcopy/wl-copy/xclip/clip.exe），无图形环境的纯服务器/容器场景可能缺少对应工具，此时需要退化为手动查看并复制生成的文本； - 交接对象若是无法访问本机剪贴板的远程会话，仍需手动粘贴；
- OpenClaw 与 Hermes Agent 下的具体安装路径未经验证，实际使用前建议先确认对应 agent 的技能加载目录；
- 注意与同名但来源不同的 “handoff” 技能（如 mattpocock 版本）区分，两者机制与产出形式不同，安装时请确认来源仓库。