handoff-opuslisted
Install: claude install-skill dazuiba/handoff
# handoff-opus Skill
<interaction_contract>
This skill is executed by Claude Code (an AI agent). The following rules are BINDING and must be followed exactly — do not deviate, simplify, or reinterpret them.
## 命令模板(每次必须照抄,不得修改结构)
```bash
p=$(handoff new --backend opus --slug <三个英文单词以内的任务助记词>)
cat > "$p" <<'__HF_EOF__'
[prompt 内容]
__HF_EOF__
handoff run --backend opus "$p"
```
**关键规则(违反任何一条都会导致命令失败或行为异常):**
- `run_in_background: true` **必须启用**:handoff 耗时 2~20 分钟,前台执行会阻塞整个会话
- `handoff new` 的 `--slug` 参数填写≤3个英文单词、`-`分隔的语义助记词(如 `fix-auth`、`add-tests`);禁止追加日期、时间戳、随机数、UUID、计数器等唯一化内容,唯一性由 `handoff new` 自动分配的 seq 保证
- heredoc 界定符用 `__HF_EOF__`,prompt 内容直接粘贴进去,不转义
- 用户明确提到 `pro`(或要求用更强/专业模型处理复杂任务)时,在 `handoff run` 后加 `--pro`
- **文件名只能来自 `handoff new` 的输出,不得自己拼**;**不要**用 `> RESULT 2> OUT` 重定向——handoff 自己管命名和落盘
- `p=$(handoff new ...)` 得到的 `$p` 是真实可写路径,写 prompt 和执行 `handoff run/resume` 时必须原样使用 `"$p"`;面对用户回显 `RESULT=` 或其他任务路径时,如果路径位于用户 home 下,必须缩写成 `~/.handoff/...`,不要暴露 `/Users/<name>/...`
**启动命令后**(`run_in_background: true` 返回后),**从 stdout 捕获 handoff 打印的唯一有用的一行 `RESULT=<任务路径>`**,将 home 下路径缩写成 `~/.handoff/...` 后,在面向用户的 assistant 消息里回显这一条路径(完成后默认只读它):
- `RESULT=<任务路径>`(最终结论文件,例如 `~/.handoff/tasks/0611-op-03-fix-auth.result.md`)
**这条路径里同时编码了本次任务的 run_id**:去掉目录和 `.result.md` 后缀,文件名主干就是 run_id(上例 → `0611-op-03-fix-auth`)。**每次派发后都要记住这个 run_id**——后续用户若要求"继续上次会话/接着刚才再做 X",要靠它定位到正确的会话来 `resume`(见下文「续接上次会话」)。
其余无需你读取:
- handoff 把克制的进度信息打在 **stderr**,Claude Code 的 shell view 会自动实时显示——你不用