mirror of
https://github.com/obra/superpowers.git
synced 2026-08-02 07:44:20 +08:00
Compare commits
1 Commits
fix/t2-cod
...
readme-dro
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
bf5530a937 |
@@ -197,17 +197,6 @@ Everything you paste into a dispatch prompt — and everything a subagent
|
|||||||
prints back — stays resident in your context for the rest of the session
|
prints back — stays resident in your context for the rest of the session
|
||||||
and is re-read on every later turn. Hand artifacts over as files.
|
and is re-read on every later turn. Hand artifacts over as files.
|
||||||
|
|
||||||
**Waiting on dispatched subagents:** never poll a wait interface with
|
|
||||||
short timeouts, and never sit in one silent, open-ended wait either.
|
|
||||||
While you have local work — ledger updates, packaging the next review,
|
|
||||||
reading reports — keep working; child results arrive on their own.
|
|
||||||
When you are genuinely idle, wait in bounded stretches (five to ten
|
|
||||||
minutes, where your platform allows), and between stretches post one
|
|
||||||
line of status and reconcile your live children: list them, and chase
|
|
||||||
any that finished without reporting. A bounded stretch keeps nearly
|
|
||||||
all of a long wait's efficiency while guaranteeing a stuck or lost
|
|
||||||
child is noticed within minutes, not at the end of the session.
|
|
||||||
|
|
||||||
### 1. Dispatch the implementer
|
### 1. Dispatch the implementer
|
||||||
|
|
||||||
Record BASE (`git rev-parse HEAD`) before dispatching — the review package
|
Record BASE (`git rev-parse HEAD`) before dispatching — the review package
|
||||||
|
|||||||
@@ -7,57 +7,7 @@ Add to your Codex config (`~/.codex/config.toml`):
|
|||||||
multi_agent = true
|
multi_agent = true
|
||||||
```
|
```
|
||||||
|
|
||||||
This enables the multi-agent tools that skills like
|
This enables `spawn_agent`, `wait_agent`, and `close_agent` for skills like `dispatching-parallel-agents` and `subagent-driven-development`. When using subagent-driven-development, close reviewer subagents when their review returns. Keep each implementer subagent open until its task's review passes — the fix loop resumes the implementer — then close it. If your harness cannot send another message to a spawned agent, dispatch each fix round as a fresh implementer carrying the brief, the report file, and the findings.
|
||||||
`dispatching-parallel-agents` and `subagent-driven-development` use.
|
|
||||||
Which tools you get depends on the multi-agent version your model
|
|
||||||
preset selects (current presets run V2; older ones run V1). Trust your
|
|
||||||
actual tool list over any table — including this one — when they
|
|
||||||
disagree.
|
|
||||||
|
|
||||||
- **Spawning:** give children a clean context with
|
|
||||||
`spawn_agent {fork_turns: "none"}`; the default `"all"` copies your
|
|
||||||
entire transcript into the child. On Codex 0.145+, role files under
|
|
||||||
`~/.codex/agents/` attach to isolated forks via `agent_type`.
|
|
||||||
Full-history forks accept `model` and `reasoning_effort` overrides
|
|
||||||
(only `agent_type` is refused there) — isolated forks are the SDD
|
|
||||||
default for context hygiene, not because overrides require them.
|
|
||||||
- **Fix rounds:** resume the implementer with `followup_task` — it
|
|
||||||
delivers your message, triggers a turn, and transparently reloads a
|
|
||||||
child the harness evicted. Never dispatch a fresh implementer on the
|
|
||||||
theory that a spawned agent cannot be messaged again; on V2 it
|
|
||||||
always can.
|
|
||||||
- **Lifecycle:** V2 has no `close_agent`. Finished children are
|
|
||||||
evicted automatically when slots are needed; leaving them unclosed
|
|
||||||
costs nothing. Only V1 sessions have `close_agent` — there, close
|
|
||||||
reviewers when their review returns, and close each implementer
|
|
||||||
after its task's review passes.
|
|
||||||
- **Model names:** never copy a model name from a skill, table, or old
|
|
||||||
session into `spawn_agent` without checking it against your current
|
|
||||||
spawn allowlist — V2 accepts only V2-capable presets and hard-errors
|
|
||||||
on the rest.
|
|
||||||
|
|
||||||
## Waiting on children
|
|
||||||
|
|
||||||
`wait_agent` is an event subscription, not a poll: a long wait wakes
|
|
||||||
the moment a child produces mailbox activity, with the same latency as
|
|
||||||
a short one. Short-timeout polling buys nothing and costs a tool call —
|
|
||||||
and a context rebill — per poll. In measured sessions, roughly
|
|
||||||
two-thirds of all wait calls were short polls that timed out.
|
|
||||||
|
|
||||||
- While you still have local work, do not wait at all. A completed
|
|
||||||
child's final answer is pushed into your mailbox and arrives with
|
|
||||||
your next turn.
|
|
||||||
- When you are genuinely idle with children outstanding, wait in
|
|
||||||
bounded stretches: `wait_agent` with `timeout_ms` 300000-600000
|
|
||||||
(5-10 minutes). After each stretch — wake or timeout — post one
|
|
||||||
status line, run `list_agents`, and chase any child that finished
|
|
||||||
without reporting. Never stack polls shorter than five minutes; the
|
|
||||||
event subscription wakes a bounded stretch just as fast as a short
|
|
||||||
one.
|
|
||||||
- Completion mail cannot wake an idle controller (it is delivered
|
|
||||||
without triggering a turn); covering that idle window is
|
|
||||||
`wait_agent`'s only job. A stretch that times out with no activity
|
|
||||||
is your cue to reconcile, not to shorten the next stretch.
|
|
||||||
|
|
||||||
## Environment Detection
|
## Environment Detection
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user