44 lines
4.0 KiB
Markdown
44 lines
4.0 KiB
Markdown
# agent-swarm
|
|
|
|
Скилл для больших задач, которые делятся на 8+ независимых кусков: миграции, аудиты, research, документы. Лид (главный агент) планирует, пакует контекст, запускает волны через `workflow`, проверяет и интегрирует. Воркеры не пересекаются по файлам, каждый получает свой пакет и возвращает структурный отчёт.
|
|
|
|
## Вызов
|
|
|
|
```
|
|
/agent-swarm <задача>
|
|
```
|
|
|
|
или просто опишите задачу — скилл подключится по описанию.
|
|
|
|
## Что происходит
|
|
|
|
1. **Fit-check.** Если задача не делится на 8+ независимых юнитов, скилл скажет не использовать swarm.
|
|
2. **Recon.** 2–4 агента картографируют репозиторий; лид пишет `.swarm/brief.md`.
|
|
3. **План.** Задачи, владельцы файлов, контракты, критерии приёмки. Гейт: без этого волны не стартуют.
|
|
4. **Волны.** Воркеры идут батчами по 6–8 (реальный лимит активных детей узнаётся перед запуском и записывается в `state.json`; recon не должен занимать слоты). Затем 4–6 независимых верификаторов на «замороженном» дереве, затем интегратор.
|
|
5. **Аудит.** `scripts/audit-scope.mjs` сравнивает изменения с картой владения.
|
|
6. **Отчёт.** `.swarm/final-report.md`.
|
|
|
|
## Артефакты
|
|
|
|
Всё лежит в `.swarm/` в корне рабочей папки: бриф, план, карточки задач, отчёты, ревью, baseline, финальный отчёт. `.swarm/` можно удалить после задачи или добавить в `.gitignore`.
|
|
|
|
## Ограничения
|
|
|
|
- Это инструкция, а не плагин: запуск идёт через инструмент `workflow`.
|
|
- Одновременно выполняется столько агентов, сколько разрешает runtime (часто 8, не 14). Лимит проверяется preflight-ом; `wave.workflow.js` запускает задачи батчами, а не одним большим fan-out.
|
|
- Дети не общаются между собой и не делегируют дальше; координация — через файлы и лида.
|
|
- Верификаторы работают на замороженном дереве; полный разбор пишется в `.swarm/reviews/Vxx.md`, а workflow возвращает только `{task_id, verdict, summary, review_file}`.
|
|
- `blocked`-воркер не заменяется: лид правит контракт/shared-файл и продолжает того же агента через `send_message`.
|
|
- Визуальные агенты работают в отдельных Xvfb/display-окружениях, со своим HOME/config/копией проекта; общий рабочий стол для скриншотов не используется. Детали — в `references/visual-testing.md`.
|
|
- Стоимость: 30–40 агентов ≈ 0.5–1.5M токенов.
|
|
- Для задачи, которую один агент делает за 15 минут, swarm не нужен.
|
|
|
|
## Настройка
|
|
|
|
- Шаблоны: `assets/`.
|
|
- Подробный runbook: `references/playbook.md`.
|
|
- Оркестрация: `references/orchestration.md`.
|
|
- Проверка скоупа: `node scripts/audit-scope.mjs --init` перед стартом, затем `node scripts/audit-scope.mjs`.
|
|
- Для директорий в `plan.json` используйте glob `path/**`, особенно для ещё не созданных папок.
|