Разделы документации

Документация

Фабрика: конвейер тикетов

Доска тикетов проекта, которую агенты ведут сами: разбор, работа в копии, тесты, проверка приложения и ревью. Останавливается на «Готово к PR» — наружу только вашей кнопкой.

«Фабрика» — раздел в пульте под «Обзором». Это не режим, а конвейер поверх режимов: у проекта своя доска тикетов, и каждый тикет сам проходит путь от «Входящих» до «Готово к PR». Что не прошло проверки, уходит на круг починки и возвращается в работу; что требует человека, встаёт в «Ждёт вас». Как это выглядит за ночь — на главной.

Входящие → Разбор → В работе → Тесты → Проверка → Ревью → Готово к PR → Готово
                         ▲                                │
                         └──── круг починки (до N раз) ───┘
Доска конвейера ночью: тикеты стоят на станциях «Работа», «Тесты» и «Проверка», один уходит по нижней дорожке на круг починки, снизу журнал событий
Схема конвейера с главной страницы: станции, через которые проходит тикет, и круг починки. На доске в приложении стадии «Тесты», «Проверка» и «Ревью» собраны в одну колонку «Проверки».

Стадии

СтадияЧто происходит
РазборОдин вызов модели без правок: спецификация с критериями приёмки, маршрут (соло, рой, фьюжн или оркестратор) и, если что-то неясно, вопросы вам анкетой.
РаботаОбычная сессия в своей копии проекта по правилам автоочереди. Если маршрут — оркестратор, его план утверждаете вы на карточке тикета (или ваш агент по MCP).
ТестыКоманда тестов конвейера, иначе команда проверки сессии, иначе автоопределение по проекту. Галочка «Дописывать тесты» добавляет ход исполнителя, если правки не тронули ни одного теста.
ПроверкаСначала повтор записанных сценариев (ноль токенов), потом проход тестера по приложению. Пропуск показан с причиной: нет превью, нет Playwright, тикет не про интерфейс.
РевьюРежим «Ревью» ровно по диффу тикета с вердиктом. Блокер, важная находка или невыполненный критерий — круг починки; мелочи уходят в тело PR.
ПочинкаФабрика сама исправляет замечания проверок, пока не кончатся круги; потом зовёт вас.

Как включить

  1. 1Откройте «Фабрика», выберите проект и зайдите в «Настройки» доски.
  2. 2Нажмите «Проверить»: готовность — git с первым коммитом, движки с входом, команда тестов, превью, Playwright. Пока есть блокирующие проблемы, включить нельзя.
  3. 3Выберите шаблон конвейера: «Обычный» (тесты, проверка приложения и ревью, до двух кругов), «Быстрый» (без проверки приложения, один круг — для мелких тикетов) или «Строгий» (два ревьюера на разных движках, до трёх кругов).
  4. 4Задайте модели на роли (пусто — «Авто» подберёт лучший доступный движок) и потолок расхода: разрешённые маршруты, воркеров на тикет, тикетов одновременно и в сутки, можно ли движок «API» и почти исчерпанные подписки.
  5. 5Поставьте галочку «Фабрика включена» и сохраните. Дальше новые тикеты уходят в работу сами.

Откуда берутся тикеты

  • Поле «Входящих»: заголовок и текст; файлы и скриншоты — скрепкой или вставкой из буфера. Их получают разбор, исполнитель и проверки.
  • «Из GitHub issue» под полем: открытые issue репозитория проекта или ссылка вида «#12». Заголовок, текст и ссылка берутся из issue, один issue дважды не заводится, а PR такого тикета закрывает issue при слиянии.
  • Приём по метке из GitHub, GitLab, Jira или Linear в разделе «Приём тикетов»: трекер опрашивается раз в пять минут, итог уходит комментарием в задачу, если это включено.
  • От вашего агента по MCP с токеном «Чтение + тикеты фабрики» — см. MCP.

Где нужны вы

Колонка «Ждёт вас» собирает пять ситуаций: вопросы разбора (ответ кнопкой или своей строкой), план оркестратора, кончились круги починки («Ещё круг», «Принять как есть», «Отложить»), работа прервалась или запускать не на чем. Поправили текст ждущего тикета — после «Вернуть фабрике» он заново проходит разбор.

В «Готово к PR» панель тикета показывает спецификацию с отметками критериев, маршрут с заметками об урезании, ход по стадиям с находками. Кнопки: «Pull Request» (тело собрано из тикета, критериев, проверок и допущений), «Влить», «Вернуть с комментарием». Сама фабрика ничего не отправляет наружу и не вливает.

«Открыть сессию» показывает обычную ленту тикета. Напишете туда или нажмёте «Стоп» — тикет «взят вручную» и снимается с конвейера; вернуть — «Вернуть фабрике». «Пауза» на доске не даёт брать новые тикеты, начатые доводятся. Фабрика может только удешевлять запуск (фьюжн → рой → соло), и каждое урезание оставляет заметку на карточке.

На своём сервере

Фабрика живёт там же, где бэкенд: в режиме «Мой сервер» доска, тикеты и сессии исполнителей идут на сервере при закрытом ноутбуке. Серверу нужна версия с «Фабрикой», подписка (она переносится сама) и, для GitHub, вход в GitHub на сервере. Сессии тикетов в списке слева стоят своей группой «Фабрика · проект». Доступно в подписке.