# Agent Swarm

> Рой из разных моделей на одну задачу: линзы, опровержение находок, Codex воркером. Триггеры: «запусти рой», «несколькими моделями», «аудит роем». НЕ стратегия→ceo-council

- Skill: `jhamidun/agent-swarm` (Agent Skill)
- Install (CLI): `npx get-skill add jhamidun/agent-swarm`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jhamidun/agent-swarm/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: JHamidun (https://skillmd.com/u/jhamidun)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/jhamidun/agent-swarm

---


# Рой на нескольких моделях

Механику `Workflow` (примитивы `agent`/`parallel`/`pipeline`, потолки, схемы) не
повторяю — она в описании самого инструмента и читается вместе с ним. Здесь
только то, чего там нет: **как собрать рой так, чтобы его выводу можно было
верить**, и как подключить чужие модели.

## Когда рой оправдан

Когда задача **шире одной точки зрения**: аудит, поиск утечек, ревью, разбор
незнакомой системы. Один агент видит то, что умеет искать; десять с разными
линзами закрывают друг друга.

Когда НЕ оправдан: работа, где ответ проверяется однозначно (сборка, тест,
переименование). Там рой добавляет накладные расходы и разнобой.

## Три вещи, без которых рой врёт

### 1. Калибровка каждой линзы

**Пустой результат проверки говорит о ПРОВЕРКЕ, а не о предмете.** Требуй от
каждого агента: до охоты подсади себе заведомую находку своего класса и убедись,
что твой способ её ловит; в отчёте укажи, чем калибровался.

Без этого «ноль находок» неотличим от «искал не тем». Прецеденты: канарейка
сканера провалила 18 правил из 153 — они не ловили собственные эталоны, и отчёт
по ним выглядел бы зелёным; семь отказов подряд читались как «модель не умеет
tool calling», а положительный контроль показал лежащий эндпоинт.

### 2. Опровержение, а не подтверждение

Находки одной модели убивает другая, и промпт формулируется **на опровержение**:
«твоя задача — опровергнуть». Порог смещай в сторону «опровергнута»: ложная
находка дороже пропущенной, потому что по ней пойдут чинить работающее.

Линзы опровержения делай **разными**, а не тремя одинаковыми: существует ли
цитата дословно · не заглушка ли это · меняется ли что-нибудь от неё вообще.
Однородная тройка ловит один класс ошибки трижды.

Выживает то, что пережило большинство. Считай голоса кодом, а не глазами.

### 3. Отчёт пишется ПО ХОДУ

Агент дописывает файл после каждой закрытой единицы, правки применяет сразу, а в
финальном ответе называет пути записанных файлов, что легло, что НЕ сделано и что
требует проверки. Сессия обрывается по лимиту или падению, и всё, что не на диске,
пропадает — за один день это случилось трижды, включая 19 230 строк разведки,
погибших до вердикта.

Одной фразы «пиши по ходу» **недостаточно** — она не говорит агенту, КУДА писать,
что писать и как вести себя при возобновлении. Поэтому в промпт каждого воркера и
в COMMON волны вставляется блок целиком и **дословно**:

```
~/.claude/workflows/CRASH-SAFE-PROTOCOL.md
```

Цена ≈200 токенов на агента, окупается первым же обрывом. Что он даёт сверх
общего пожелания:

* **стабильный путь** прогресс-файла (`workflows-progress/<волна>/<агент>.progress.md`),
  а не session-scratchpad — иначе возобновление из НОВОЙ сессии файлов не найдёт;
* **первое действие при старте** — прочитать свой прогресс-файл: если он есть,
  это возобновление, и разведку заново гонять не надо;
* **строку RECON сразу после разведки** — самый дорогой и самый теряемый кусок;
* правило для длинных циклов: чекпоинт **в целевое хранилище** (UPSERT,
  skip-if-done), а не в память.

Проверено 31.08: рой из 46 агентов умер разом на лимите подписки, и уцелело
ровно то, что успело лечь на диск — 123 прогресс-файла. Восстановление —
`Workflow({scriptPath, resumeFromRunId})`, готовые агенты вернулись из кэша.

## Раздача моделей

Не «какая лучше», а **какой тип мышления нужен линзе**:

| Что за линза | Кому |
|---|---|
| Связать разрозненное, взвесить, решить неоднозначное | `opus` |
| Сплошной проход, механическая сверка, обычный воркер | `fable` |
| Массовая простая классификация от десяти параллельных | `haiku` |
| Синтез в конце | `opus` |

Канон ролей и идентификаторов — `config/models.md`, не выписывай версии в скрипт.

## Чужие модели тем же роем

Claude-агент вызывает чужой CLI из Bash и приносит результат обратно.

> ⚠️ **NO-KEY GUARD (обязательно):** этот функционал требует ОПЦИОНАЛЬНОГО стороннего API-ключа. Перед вызовом проверь ключ в `.credentials.master.env`. Если ключ отсутствует, пустой или placeholder (`your_*_api_key`) — **НЕ проси пользователя оплатить счёт, включить биллинг или купить API**. Скажи одной строкой: «Эта функция опциональна и требует свой API-ключ (например, бесплатный ключ на aistudio.google.com); из коробки всё остальное работает по подписке Claude» — и предложи альтернативу или продолжай без неё.

Это касается только данного раздела: рой из одних Claude-агентов (всё выше) ничего
стороннего не требует.

**Codex** (OpenAI; вход по подписке OpenAI или ключом `OPENAI_API_KEY`) — сильная
сторона: находит то, что пропустили проходы Claude. За один день дал личные
данные, спрятанные в параметрах URL, которых не видели тринадцать проходов, и
четыре дефекта в проверялках. Модель и уровень рассуждения бери из
`config/models.md` (раздел OpenAI), остальные флаги и грабли — в skill
`multi-model-gateway`.

```bash
codex exec --model <модель из config/models.md> -c model_reasoning_effort=xhigh \
  --sandbox workspace-write --skip-git-repo-check - < задача.txt > лог.txt 2>&1
```

⚠️ **Один writable-каталог.** С двумя песочница Windows отказывается стартовать
(«cannot enforce split writable root sets») и не читает вообще ничего. Запускай
`cd` в тот каталог, куда он будет писать отчёт.

⚠️ Плагин-обёртка виснет на таймауте 180 с — зови CLI напрямую.

**Любая другая модель** с CLI или HTTP-API (в том числе бесплатная) подключается
так же: воркер вызывает её из Bash, пишет ответ в файл и возвращает путь. Заверни
вызов в скрипт, который сам повторяет при ответе «занято» и отличает «занято» от
«отказ по существу»: иначе рой прочтёт временную ошибку как вердикт. Прежде чем
слать модели закрытые материалы, выясни, хранит ли провайдер переписку, и маршрут
через посредника, который её хранит, держи выключенным по умолчанию.

## Ход и возобновление

Рой уходит в фон, живой ход — `/workflows`. Если он встал (журнал не пополняется),
возобновляй по `runId`: завершённые агенты вернутся из кэша мгновенно, доработает
только недоделанное. Перед разбором «почему пусто» открой `journal.jsonl` — там
настоящие возвраты агентов, а не догадки о них.

## Ловушка отчётов

Старый отчёт по тому же пути читается как свежий. Перед запуском отложи прежний
файл в сторону — иначе при падении роя разберёшь вчерашний результат и не
заметишь. Проверено: файл отчёта аудита утечек лежал суточной давности.

## Соседнее

`rules/delegation.md` — уровни сложности и когда рой вообще не нужен ·
`superpowers:dispatching-parallel-agents` — параллельные задачи без Workflow ·
`multi-model-gateway` — флаги и грабли Codex CLI, вторые мнения от GPT и Gemini ·
`llm-evals` — если надо измерить, стало ли лучше.

