Handoff opus

Skill dazuiba/handoff/cli/skills/handoff-opus

Delegate tasks to DeepSeek right inside your Claude Code / Codex sessions.

Install

npx -y skills add dazuiba/handoff --skill handoff-opus

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

What its author says it does

Copied from the file, not written here

把关键决策/验收类任务交给 Claude Opus 执行。后台运行，完成后自动通知。支持并行多任务，支持续接（resume）上次会话继续派发后续任务。

SKILL.md

4.1 KB, as published. Nobody here has run it

handoff-opus Skill

<interaction_contract> This skill is executed by Claude Code (an AI agent). The rules below are BINDING — follow them exactly; do not simplify or reinterpret.

派发一个任务 = 两条命令 + 等通知。照抄模板，不要改结构。

第 1 步：建任务文件（前台，秒回）

handoff new --backend opus --slug <≤3个英文单词的任务助记词> --write <<'__HF_EOF__'
[prompt 内容]
__HF_EOF__

它只打印一行绝对路径，例如：

/Users/x/.handoff/tasks/0720-op-06-fix-auth.prompt.md

去掉目录和 .prompt.md 后缀，剩下的 0720-op-06-fix-auth 就是本次任务的 RUN_ID。记住它。三个文件路径由它直接推出，不需要再从任何输出里捕获：

路径	用途
`~/.handoff/tasks/<RUN_ID>.prompt.md`	你刚写的 prompt
`~/.handoff/tasks/<RUN_ID>.result.md`	结果，任务完成后读这个
`~/.handoff/tasks/<RUN_ID>.out.txt`	进度日志，仅诊断时才读

第 2 步：执行（必须 `run_in_background: true`）

handoff run --backend opus ~/.handoff/tasks/<RUN_ID>.prompt.md

必须后台启动——handoff 耗时 2~20 分钟，前台会阻塞整个会话。用户提到 pro（或要求更强/专业模型处理复杂任务）时，在 handoff run 后加 --pro。

第 3 步：等通知，然后读结果

等 Claude Code 的后台任务完成通知。收到后用 Read 读 ~/.handoff/tasks/<RUN_ID>.result.md 汇报。

通知一定会到。在它到达之前，禁止用任何手段去"看看好了没"——禁止 BashOutput、TaskGet、TaskOutput、Monitor、sleep、tail、cat，禁止提前 Read 结果文件，也不要去搜索这类等待/轮询工具。命令输出里的 RUN_ID= 和 RESULT= 都不需要读——第 1 步已经知道全部路径了。

只有 .result.md 为空或内容异常时，才读同名 .out.txt 诊断。

其它硬规则

--slug 只写≤3个英文单词、- 分隔的语义助记词（如 fix-auth）；禁止日期/时间戳/随机数/UUID/计数器，唯一性由 handoff new 自动分配的 seq 保证。
heredoc 界定符固定用 __HF_EOF__，prompt 原样粘贴、不转义。
不要自己拼任务文件名，不要用 > RESULT 2> OUT 重定向——handoff 自己管命名和落盘。
回显任何 home 下的任务路径时，缩写成 ~/.handoff/...，不要暴露 /Users/<name>/...。 </interaction_contract>

多任务

并行：先在同一条消息里发出多个第 1 步（前台 handoff new，各自不同 slug），拿到各自 RUN_ID；再在同一条消息里发出多个第 2 步（run_in_background: true 的 handoff run）。之后分别等通知、分别读各自的 .result.md 汇报。
串行：等上一个的完成通知到达、读并汇报后，再开始下一个的第 1 步。

续接上次会话（resume 续派）

要保留某次任务的上下文继续，而非开新会话：第 1 步照旧建新的 prompt 文件，第 2 步把 run 换成 resume <首次RUN_ID>：

# 第 1 步：同上，拿到新的 <RUN_ID>
handoff new --backend opus --slug <任务助记词> --write <<'__HF_EOF__'
[后续任务内容]
__HF_EOF__

# 第 2 步：run_in_background: true
handoff resume <首次RUN_ID> --backend opus ~/.handoff/tasks/<新RUN_ID>.prompt.md

<首次RUN_ID> 是该会话首次任务的 RUN_ID；它是稳定句柄，每轮续接都用它，不要追每轮新生成的 RUN_ID。
本轮结果落在新 RUN_ID 的 .result.md，读这个。
必须带 prompt 文件：不带输入文件的 resume <RUN_ID> 是交互式重开，后台会卡死。
续接默认只继承 backend；原会话用过 --pro 的，续接要再次带上才沿用 pro_model。
不确定用户指哪次任务时，报候选 RUN_ID + 摘要让其确认，别猜。