Рой на нескольких моделях
Механику 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.
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 — если надо измерить, стало ли лучше.