can1357
9ccd83a13d
- Updated task tool schemas to default the `agent` parameter to `'task'`. - Normalized missing or empty `agent` values to `'task'` during execution handling to support direct programmatic callers. - Replaced references to the old `quick_task` worker type with `sonic`. - Simplified prompt instructions by removing deprecated single-spawn context constraints and status polling notes.
65 lines
4.3 KiB
Markdown
65 lines
4.3 KiB
Markdown
{{#if asyncEnabled}}{{#if batchEnabled}}Delegate work to background subagents by passing multiple items in a single `tasks[]` batch.{{else}}Delegate work to ONE background subagent per call.{{/if}}
|
|
Execution does not block your turn: you receive agent and job IDs immediately, and the final results deliver themselves when the subagents finish.{{else}}{{#if batchEnabled}}Run subagents synchronously by passing items in a `tasks[]` batch.{{else}}Run ONE subagent synchronously per call.{{/if}}
|
|
Execution blocks your turn: the call only returns once the work is completely finished.{{/if}}
|
|
|
|
# Delegation Strategy
|
|
- **Maximize parallelism:** Break work into the widest possible {{#if batchEnabled}}array of `tasks[]`{{else}}set of parallel `task` calls{{/if}}. NEVER serialize work that can run concurrently. Tasks touching different files or independent refactors should run in parallel; agents resolve their own file collisions live.
|
|
- **Sequence only when necessary:** The only reason to run A before B is if B strictly requires A's output to function (e.g., a core API contract or schema migration). {{#if ircEnabled}}If the missing piece is small, run them in parallel and have B ask A via `irc`!{{/if}}
|
|
- **Role matching:** Assign each subagent a specific `role` (e.g. "Security Reviewer", "DB Migrator"). Do not spawn generic workers.
|
|
- **No overhead:** Each assignment MUST instruct its agent to skip formatters, linters, and project-wide test suites. You will run those once at the end.
|
|
- **One-pass agents:** Prefer agents that investigate **and** edit in a single pass; only spin a read-only discovery step (e.g. `explore`) when the affected files are genuinely unknown.
|
|
|
|
# Inputs
|
|
- `agent` (optional): The base agent type to use (e.g., `explore`, `reviewer`). Defaults to `task` (the general-purpose worker) — omit it for the default worker instead of passing `agent: "task"`.
|
|
{{#if batchEnabled}}
|
|
- `context`: Shared project state, constraints, and contracts. Applies to the entire batch; do not duplicate this background into individual tasks.
|
|
- `tasks[]`: Array of subagents to spawn.
|
|
- `assignment`: Complete, self-contained instructions. One-liners or missing acceptance criteria are PROHIBITED.
|
|
- `id`: A stable CamelCase identifier (≤32 chars). Generated automatically if omitted.
|
|
- `description`: A UI label only; the subagent NEVER sees it.
|
|
- `role`: The specialist this subagent embodies. Tailor per spawn; do not clone a generic worker.
|
|
{{#if isolationEnabled}}
|
|
- `isolated`: Run in a dedicated worktree and return patches. Isolated agents are destroyed upon completion and cannot be addressed afterward.
|
|
{{/if}}
|
|
{{else}}
|
|
- `assignment`: Complete, self-contained instructions. One-liners or missing acceptance criteria are PROHIBITED.
|
|
- `id`: A stable CamelCase identifier (≤32 chars). Generated automatically if omitted.
|
|
- `description`: A UI label only; the subagent NEVER sees it.
|
|
- `role`: The specialist this subagent embodies. Tailor per spawn; do not clone a generic worker.
|
|
{{#if isolationEnabled}}
|
|
- `isolated`: Run in a dedicated worktree and return patches. Isolated agents are destroyed upon completion and cannot be addressed afterward.
|
|
{{/if}}
|
|
{{/if}}
|
|
|
|
# Context and Communication
|
|
Subagents start blank. They have no access to your conversation history.
|
|
{{#if batchEnabled}}
|
|
- Pass large payloads using `local://<path>` URIs, never inline text.
|
|
{{else}}
|
|
- Write shared project state ONCE to a `local://` file (e.g., `local://ctx.md`) and reference that URL in your assignments.
|
|
{{/if}}
|
|
|
|
# Format Contracts
|
|
{{#if batchEnabled}}
|
|
The `context` field MUST follow this format:
|
|
# Goal ← what the batch accomplishes
|
|
# Constraints ← rules and session decisions
|
|
# Contract ← shared interfaces
|
|
{{/if}}
|
|
|
|
The `assignment` field MUST follow this format:
|
|
# Target ← exact files and symbols; explicit non-goals
|
|
# Change ← step-by-step add/remove/rename; APIs and patterns
|
|
# Acceptance ← observable result; no project-wide commands
|
|
|
|
# Available Agents
|
|
{{#if spawningDisabled}}
|
|
Agent spawning is currently disabled.
|
|
{{else}}
|
|
{{#list agents join="\n"}}
|
|
### {{name}}{{#if readOnly}} (READ-ONLY: no edit/write/command tools){{/if}}
|
|
{{description}}
|
|
{{#if readOnly}}Use ONLY for investigation and reporting; do the edits yourself or assign them to a writing agent.{{/if}}
|
|
{{/list}}
|
|
{{/if}}
|