From 00949559a8a4757e1198e1ea582ebfcf7268fec4 Mon Sep 17 00:00:00 2001 From: main Date: Mon, 23 Mar 2026 19:16:10 -0400 Subject: Add blocking wait for background consult jobs --- assets/codex-skills/phone-opus/SKILL.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) (limited to 'assets/codex-skills/phone-opus/SKILL.md') diff --git a/assets/codex-skills/phone-opus/SKILL.md b/assets/codex-skills/phone-opus/SKILL.md index 6b1ae3d..d1b22bd 100644 --- a/assets/codex-skills/phone-opus/SKILL.md +++ b/assets/codex-skills/phone-opus/SKILL.md @@ -16,7 +16,7 @@ should be taken as authoritative or final. It is a pure consultant. - Ask for a second opinion on code, architecture, debugging, or design. - Point Claude at a specific repository with `cwd`. - Reuse `session_id` from an earlier call when you want Claude to continue the same conversation. -- Set `background: true` when you want to launch a consult, keep working, and poll for the answer later. +- Set `background: true` when you want to launch a consult, keep working, and join it later with `consult_wait` or inspect it with `consult_job`. ## Tool surface @@ -25,6 +25,9 @@ should be taken as authoritative or final. It is a pure consultant. - optional: `cwd`, `session_id`, `background`, `render`, `detail` - `consult_job` - required: `job_id` +- `consult_wait` + - required: `job_id` + - optional: `timeout_ms`, `poll_interval_ms`, `render`, `detail` - `consult_jobs` - optional: `limit`, `render`, `detail` - `health_snapshot` @@ -40,7 +43,7 @@ should be taken as authoritative or final. It is a pure consultant. - For related follow-ups, strongly prefer reusing `session_id`; cold-start Opus burns quota rereading files, while session reuse is much cheaper. - This surface is consultative only. Edit tools are unavailable. - The returned `session_id` is reusable: pass it back into a later `consult` call to continue that Claude conversation. -- Background consults return a `job_id`; use `consult_job` to poll one job or `consult_jobs` to rediscover recent ones. +- Background consults return a `job_id`; use `consult_wait` when you want a blocking join, `consult_job` to inspect one job directly, or `consult_jobs` to rediscover recent ones. ## Example -- cgit v1.2.3