Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал

Проверенные изменения несколькими моделями

Статус: действует Область: текущее состояние Последняя проверка: 2026-08-21 Владелец: среда выполнения AX Code

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

Справку по режиму — флаги, ключи конфигурации, входы ранжирования — см. в режимах выполнения. Эта страница — задача от начала до конца.

Когда это окупается

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

Это не стоит того для правки в одну строку, переименования или всего, что можно проверить чтением.

Два разных инструмента

Инструмент	Что производит	Пишет файлы?
`council`	независимые мнения рецензии, сведённые вместе	Нет
`arena`	реализации-кандидаты, ранжированные	Только в изолированных рабочих деревьях

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

Используйте arena, чтобы решить, какую реализацию оставить.

Рабочий процесс arena implement

1. Подготовка

Режим implement требует проект Git хотя бы с одним коммитом и чистое основное рабочее дерево. Рабочие деревья участников создаются от точного базового коммита и не могут унаследовать незафиксированные изменения, поэтому сначала зафиксируйте или спрячьте их в stash.

Также нужны хотя бы две различные выбираемые модели на подключённых провайдерах (общий шлюз поддерживается) и modes.arena.enabled: true.

2. Запуск

/arena <task description>

Каждый участник получает собственное рабочее дерево Git, созданное из записанного базового коммита, и в нём работает агент implement. Участники не меняют ваше основное рабочее дерево.

3. Что AX Code делает с каждым кандидатом

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

4. Решение

Отчёт даёт пути рабочих деревьев, имена ветвей и диапазоны коммитов.

AX Code не сливает победителя. Осмотрите, сливайте или делайте cherry-pick сами. Это намеренно: проверка значит «ваши настроенные проверки прошли на этой заплатке». Это настоящий сигнал, но не замена рецензии.

5. Рецензия и при необходимости откат

Когда кандидат уже в вашем дереве, команды свидетельств применяются как обычно:

ax-code graph <sessionID>       # what the winning run actually did
ax-code risk <sessionID>        # heuristic risk signals for the change
ax-code session rollback <sessionID> --dry-run

См. Свидетельства выполнения.

Что здесь точно значит «проверено»

Это значит: обнаруженные команды проверки типов, lint и тестов проекта выполнились на заплатке этого кандидата и прошли.

Это не значит, что изменение правильно, полно, безопасно или хорошо спроектировано. Если набор тестов не покрывает изменённое поведение, прошедший кандидат доказывает только то, что уже покрытое не сломалось. Проверка поднимает пол и не удостоверяет потолок.

Она также не распространяется на обычное интерактивное редактирование. Кандидаты Arena и применение рефакторинга за шлюзом запускают проверки. Обычные edit или write в регулярном сеансе этого не делают автоматически. Запустите verify_project, когда хотите, чтобы это свидетельство было записано для обычного прогона.

Стоимость и режимы отказа

Стоимость растёт с числом участников. Каждый запускает полного агента implement.
Грязное рабочее дерево останавливает прогон до всего остального, и это задумано.
Меньше двух различных моделей делает сравнение бессмысленным, и инструмент сообщает об этом, а не выдумывает ранжирование.
Все кандидаты могут не пройти проверку. Это полезный результат: обычно задача была задана слишком бедно или проверки репозитория строже, чем предполагали агенты.

Режимы выполнения — полная справка по council, arena и другим режимам
Свидетельства выполнения — рецензия и откат результата
Почему AX Code — почему ранжирование с проверкой сначала и есть отличие
Лучшие практики маршрутизации нескольких моделей — разделение дорогой и вспомогательной работы