handoff-codexlisted
Install: claude install-skill dazuiba/handoff
# handoff-codex 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 步:建任务文件(前台,秒回)
```bash
handoff new --backend codex --slug <≤3个英文单词的任务助记词> --write <<'__HF_EOF__'
[prompt 内容]
__HF_EOF__
```
它只打印一行绝对路径,例如:
```
/Users/x/.handoff/tasks/0720-cx-06-fix-auth.prompt.md
```
去掉目录和 `.prompt.md` 后缀,剩下的 `0720-cx-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`)
根据用户本轮要求,只能选择下表对应的一行,不得自行增删 `--pro` / `--fast`:
| 用户本轮要求 | 新会话:`run` | 续接:`resume` | 后续行为 |
| --- | --- | --- | --- |
| 未提 Pro,也未提 Fast | `handoff run --backend codex ~/.handoff/tasks/<RUN_ID>.prompt.md` | `handoff resume <首次RUN_ID> --backend codex ~/.handoff/tasks/<新RUN_ID>.prompt.md` | resume 自动继承会话上一轮的 Pro 状态;Fast 关闭 |
| Pro(或要求更强/专业模型) | `handoff run --backend codex --pro ~/.handoff/tasks/<RUN_ID>.prompt.md` | `handoff resume <首次RUN_ID> --backend codex --pro ~/.handoff/tasks/<新RUN_ID>.prompt.md` | Pro 状态持久化,后续 resume 自动继承 |
| Fast / Fast Mode / 明确要求加速 | `handoff run --backend codex --fast ~/.handoff/tasks/<RUN_ID>.prompt.md` | `handoff resume <首次RUN_ID> --backend codex --fast ~/.handoff/tasks/<新RUN_ID>.prompt.