К основному содержанию
скилл CX Codex

orchestrating-subagents — скилл для Claude Code: обзор и запуск

Скилл orchestrating-subagents для Claude Code задаёт правила декомпозиции задач: выбор моделей для ролей, параллельный запуск исследователей и независимую приёмку кода ревьюерами.

MIT ★ 539 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ZaxbyHub/opencode-swarm --skill orchestrating-subagents -a claude-code
Открыть на GitHub

Что делает orchestrating-subagents

Скилл задаёт регламент декомпозиции задач между субагентами в проекте. Для исследователей допускается запуск недорогих быстрых моделей с низкими вычислительными затратами, потому что их находки перепроверяются дальше. Для ревьюеров и критиков действует строгое правило: они работают исключительно на ведущей сессионной модели с максимальным усилием и всегда стартуют в изолированном контексте. Экономить вычислительные ресурсы на финальной верификации запрещено.

Параллельные субагенты запускаются единым сообщением только под непересекающиеся зоны ответственности. Каждый промпт делегирования обязан содержать чёткие границы анализа, ожидаемый формат компактного отчёта, подтверждение путей через связку file:line и стандартизированные статусы находок. Основной контекст сессии остаётся чистым, так как массивные выводы утилит и промежуточные рассуждения остаются внутри субагентов.

Если задача сводится к поиску одного символа через пару вызовов Grep или Read, агент решает её напрямую без порождения дочерних процессов.

Какие задачи решает

  • Распределять роли между агентами и подбирать уровни моделей под задачи поиска или ревизии
  • Изолировать контекст проверок через запуск свежих ревьюеров без истории диалога автора
  • Формировать компактные промпты субагентам с обязательными ссылками на строки в коде
  • Предотвращать засорение главного контекста длинными листингами и сырыми выводами утилит

Примеры запросов агенту

  • Запусти параллельных субагентов для поиска всех мест использования токена сессии в каталоге src/auth/ с отчётом по строкам
  • Создай отдельного свежего ревьюера для независимой проверки последнего дифа ветки перед слиянием
  • Сформируй задачу субагенту-исследователю на поиск реализаций кэша, ограничив вывод списком файлов и номерами строк

Как установить orchestrating-subagents

1Через Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill orchestrating-subagents -a claude-code

2Вручную: положить файлы

~/.claude/skills/orchestrating-subagents/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/orchestrating-subagents/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об orchestrating-subagents

Как установить orchestrating-subagents в Claude Code?

Выполните команду npx skills add ZaxbyHub/opencode-swarm --skill orchestrating-subagents -a claude-code.

На каких агентах можно экономить токены?

Снижать уровень модели и вычислительные усилия разрешено только для исследователей, собирающих кандидатов. Ревьюеры и критики должны работать на сильнейшей сессионной модели с высоким усилием в чистом контексте.

Что делать, если среда запуска не поддерживает вызов субагентов?

Если инструмент запуска субагентов недоступен, агент выполняет чек-лист проверки самостоятельно, но обязан явно пометить результат как резервное саморецензирование.

Исходный текст

SKILL.md · MIT
---
name: orchestrating-subagents
description: >
  Tiering and economics for delegating to subagents: which agent type, model,
  and effort to use per role (explorer, implementer, reviewer, critic), how many
  agents to launch in parallel, how to write scoped subagent prompts with
  bounded structured returns, and how to keep the main context clean. Use when
  launching subagents, parallel explorers, independent reviewers, or critic
  passes — especially for swarm-mode, qa-sweep, or issue-tracer work.
metadata:
  audience: swarm-plugin
---

# Orchestrating Subagents

Swarm-mode work in this repo delegates heavily (explorer → reviewer → critic).
This skill defines HOW to delegate so validation gates stay strong while
breadth stays fast and cheap. It complements — never replaces — the gates in
`.claude/session/swarm-mode.md`, qa-sweep, and swarm-implement.

## Role → tier mapping

| Role | Agent type | Model / effort | Rationale |
|---|---|---|---|
| Explorer (mapping, candidate findings) | `Explore` when read-only suffices | Cheaper/faster tier acceptable; low–medium effort | Recall-bound, not reasoning-bound; the reviewer gate catches misses |
| Implementer (scoped edits) | general-purpose | Session model; medium–high effort | Edits need project conventions (CLAUDE.md context) |
| Reviewer (independent validation) | general-purpose, **fresh context** | Session (strongest) model; high effort | Precision-bound; false approvals are the expensive failure |
| Critic (final challenge) | general-purpose, **fresh context** | Session (strongest) model; high effort | Same — this is the last line of defense |

Hard rule: economize on explorers, never on reviewers or critics. If the
harness exposes model or effort overrides for subagents, tier explorers down;
do not tier the reviewer or critic below the session model or below high
effort. If no override is available, tier by agent type (`Explore` is
lightweight: read-only tools, skips CLAUDE.md) and by prompt scope.

## Fan-out discipline

- Launch parallel agents only for **disjoint scopes**. Before launching, write
  one line per agent stating its scope; if two overlap, merge them.
- 2–4 explorers per wave is a heuristic only when the active workflow does
  not define its own fan-out contract. A workflow-specific contract overrides
  this heuristic: PR review, for example, requires all six base dimensions and
  all eleven risk families to be covered on every PR — its capability profiles
  and depth tiers (see swarm-pr-review) govern how many lanes carry that
  coverage, and under the plugin's mechanical controller the tier is computed
  from the bound diff and the matching lane floors are enforced outright. No
  time, cost, repository-size, or simplicity
  rationale may reduce the coverage a workflow mandates.
  Outside fixed-fan-out workflows, more agents than distinct scopes adds token
  cost and synthesis burden without adding recall.
- Launch independent agents **in a single message** so they run concurrently.
- Do not re-run a search an agent is already doing; wait for its report.
- Scale waves, not width: if the first wave surfaces new territory, launch a
  second targeted wave rather than one giant speculative first wave.

## Subagent prompt contract

Every delegation prompt must state:

1. **Scope** — exact directories, files, or question. Name what is out of scope.
2. **Deliverable** — the structure of the report (per-item findings, then a
   ranked summary). The agent's final message is the only thing you receive.
3. **Evidence bar** — exact `file:line` references; no invented paths; verify a
   path exists before citing it.
4. **Status labels** — explorers return CANDIDATE findings only; reviewers
   classify CONFIRMED / DISPROVED / UNVERIFIED / PRE_EXISTING; reviewer and
   critic verdicts are APPROVE / NEEDS_REVISION / BLOCKED.
5. **Output bound** — compact structured returns; no full-file dumps.

For reviewers and critics additionally:
- Give the **claims and locations**, not the author's justification — the
  reviewer must re-derive, not confirm, the reasoning.
- State the adversarial default explicitly: "default to DISPROVED/UNVERIFIED
  unless the code evidence supports the finding."
- A reviewer or critic must be a **fresh agent**, never a continued
  conversation with the agent whose work it judges.

## Independence and staleness

- Reviewer and critic review the **latest diff**, not a description of it. Give
  them the branch state and the validation evidence, and require them to run
  `git diff`/`git log` themselves.
- Any edit after an approval invalidates it. Record what was approved (e.g.
  `git rev-parse HEAD`, `git diff --stat`) so staleness is checkable — see the
  durable-session-state skill.

## Nesting limitation

Whether a subagent can spawn further subagents depends on the harness and
agent type — check whether a subagent tool (`Agent` or `Task`) is actually
available in your context before assuming either way. If a skill mandating
fresh-subagent review (qa-sweep, swarm-implement) executes in a context
**without** a subagent tool:
- perform the same review checklist yourself as a clearly labeled
  **fallback self-review**, and
- disclose in your report that independent review was unavailable in this
  context, so the orchestrator can re-run the gate with a real fresh agent.
Never silently present self-review as independent review.

## Main-context hygiene

- Push reading-heavy work into subagents; keep the main thread for scoping,
  synthesis, and decisions.
- Do not paste subagent transcripts or large tool outputs back into the main
  thread; carry forward only validated findings and verdicts.
- When a subagent report arrives, extract the load-bearing facts into your
  durable task artifacts (see durable-session-state) before moving on.

## When not to delegate

Answer directly, without a subagent, when the task is a single-fact lookup you
can resolve with one or two targeted Grep/Read calls, or when you already know
the file and symbol. Delegation overhead should buy breadth, isolation, or
independence — if it buys none of those, skip it.

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
implement-with-subagents chrisbanes Скилл implement-with-subagents координирует выполнение графа задач соло-агентом или пулом субагентов с изолированными коммитами и обязательным независимым ревью. CX Codex +1 807установок nested-subagents ruvnet Скилл nested-subagents для Claude Code строит дерево субагентов, где каждый ребёнок может породить своих детей. Разносит промежуточное состояние, не помещающееся в контекст одного агента. CX Codex +1 317установок subagents-orchestration-guide shinpr Скилл subagents-orchestration-guide для Claude Code координирует работу специализированных субагентов на всех фазах рабочего процесса. Управляет маршрутизацией задач, проверкой требований и выбором масштаба реализации. CX Codex +1 ★ 720звёзд репо claude-delegate amElnagdy Скилл claude-delegate для Claude Code передаёт задачу отдельной сессии Claude Code, а затем помогает проверить её изменения. Включается, когда пользователь явно просит делегировать реализацию. CX Codex +1 6 700установок agy-delegate amElnagdy Скилл agy-delegate для Claude Code и других агентов, который передаёт задачу на реализацию в Google Antigravity CLI (agy), а вы остаётесь ревьюером. Сами пишете бриф, проверяете diff и коммитите. CX Codex +1 6 500установок paseo-advisor getpaseo Скилл paseo-advisor поднимает отдельного агента-советника: тот смотрит на текущую задачу со стороны и выдаёт рекомендацию. Саму работу он не делает, решение остаётся за вами. CX Codex +1 4 400установок

Из того же набора121

Весь набор →
test-file-split Скилл test-file-split разбивает разросшийся тест-файл на части по блокам describe(), когда тот подходит к лимиту в 500 строк или уже перевалил его. CX Codex +1 ★ 539звёзд репо fork-pr-operations Скилл fork-pr-operations инструктирует агента по работе с пулл-реквестами из форков: одобрение воркфлоу в GitHub Actions, безопасный rebase и сверка актуальности проверок CI. CX Codex +1 ★ 539звёзд репо parallel-work-check Скилл parallel-work-check для Claude Code сравнивает локальное состояние существующей ветки с удалённым и проверяет новые коммиты. Помогает заметить параллельные изменения до начала правок. CX Codex +1 ★ 539звёзд репо design-docs Ведёт design-доки проекта: домен, техспеку, behavior-спеку, реестр section-ID и changelog. Запускается по заголовку [MODE: DESIGN_DOCS ...]. CX Codex +1 ★ 539звёзд репо commit-pr Скилл commit-pr ведёт работу с коммитами и pull request: от подготовки публикации до проверки CI и завершения PR. Он пригодится при выпуске изменений по GitHub issue. CX Codex +1 ★ 539звёзд репо contributing Скилл contributing проводит агента по всему циклу пул-реквеста в репозитории opencode-swarm: ветка, формат коммитов, фрагмент release notes, локальные проверки и шаблон описания. CX Codex +1 ★ 539звёзд репо clarify-spec Скилл clarify-spec устраняет маркеры неопределённости в спецификациях Swarm, опрашивая разработчика по одному вопросу за раз. CX Codex +1 ★ 539звёзд репо pre-phase-briefing Скилл pre-phase-briefing собирает контекст перед фазой проекта, проверяет прошлые ретроспективы и сверяет план с реальным состоянием кодовой базы. CX Codex +1 ★ 539звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой