Moira / разработка

Изменение кода — с проверкой и ревью

Moira · Для разработчиков

Поручите агенту задачу в репозитории. Moira проведёт его через план, реализацию и независимое ревью. Команда получит изменение с проверками и отчётом.

Ваш привычный агент работает своими инструментами. Moira сохраняет шаги и возвраты после ревью.

Когда прошедшего теста недостаточно

В основе примера — реальная ошибка этого сайта: движок удерживал и переводил экран отдельно от положения скролла. Чтобы вернуть привычную прокрутку, нужно было проверить не только счётчик браузера, но и положение страницы.

Ниже — учебный разбор такого изменения. Ответы исполнителя и ревьюера выше показывают механизм проверки, а не воспроизводят журнал конкретного запуска.

  1. Задача. Страница следует за движением колеса, ссылки ведут к нужным разделам.
  2. Неполная проверка. scrollY изменился на 160 px. Это ещё не подтверждает перемещение видимого документа.
  3. Возврат после ревью. Добавить проверку геометрии страницы, повторить два движения и проверить якорную ссылку.
  4. Повторная проверка. Сравнить исправленный код и тест с исходным требованием.
От задачи до повторного ревьюУчебный маршрут на основе Software Development Flow.
От задачи до повторного ревьюУчебный маршрут на основе Software Development Flow. Узлов: 6, слоёв потока: 6. Слои по потоку: 1. Задача в репозитории. 2. Код и первая проверка. 3. Независимое ревью. 4. Исправление и тест. 5. Повторное ревью. 6. Патч, тест и отчёт. Связи по потоку: Задача в репозитории → Код и первая проверка; Код и первая проверка → Независимое ревью; Независимое ревью → Исправление и тест: неполное доказательство; Исправление и тест → Повторное ревью; Повторное ревью → Патч, тест и отчёт: нет блокирующих замечаний. Обратные связи: Повторное ревью → Исправление и тест: остались замечания.Задача в репозиторииКод и первая проверкаНезависимое ревьюИсправление и тестПовторное ревьюПатч, тест и отчётнеполноедоказательствоосталисьзамечаниянет блокирующихзамечаний
Схема словами

Узлов: 6, слоёв потока: 6.

Слои по потоку

  1. Задача в репозитории
  2. Код и первая проверка
  3. Независимое ревью
  4. Исправление и тест
  5. Повторное ревью
  6. Патч, тест и отчёт

Связи по потоку

  • Задача в репозитории → Код и первая проверка
  • Код и первая проверка → Независимое ревью
  • Независимое ревью → Исправление и тест: неполное доказательство
  • Исправление и тест → Повторное ревью
  • Повторное ревью → Патч, тест и отчёт: нет блокирующих замечаний

Обратные связи

  • Повторное ревью → Исправление и тест: остались замечания
Как регрессионный тест проверяет результат

Фрагмент действующего браузерного теста этого сайта. На каждое событие с deltaY: 160 он проверяет и scrollY, и положение страницы. После второго события суммарное перемещение составляет 320 px.

const initialTop = await wall.evaluate(el => el.getBoundingClientRect().top);
for (const expectedDistance of [160, 320]) {
  await page.mouse.wheel(0, 160);
  await expect.poll(() => page.evaluate(() => Math.round(window.scrollY)))
    .toBe(expectedDistance);
  await expect.poll(() => wall.evaluate(el => Math.round(el.getBoundingClientRect().top)))
    .toBe(Math.round(initialTop) - expectedDistance);
}

В том же тесте проверен переход к разделу подключения по якорной ссылке.

Software Development Flow связывает требования, независимо проверенный план, реализацию, нужные тесты, документацию и итоговое ревью. Если проблема в подходе, работа возвращается к плану. Интерактивный режим включает предусмотренные согласования, автономный работает в пределах выданных полномочий.

Изучить Software Development Flow

Те же правила ревью — в работе команды

Попросите агента проверить изменение по правилам проекта: совместимость, безопасность, тесты, документацию. Закрепите критерии в своём процессе, чтобы они были доступны следующему исполнителю.

В системе непрерывной интеграции (CI) ваше задание может запускать агента с подключённой Moira при создании или обновлении pull request. Передайте diff, контекст репозитория и процесс команды. Агент вернёт находки. Задание в CI приложит отчёт или опубликует результат проверки.

Вход Работа агента Результат для ревью
Diff и требования Проверить затронутые контракты и пограничные случаи Находки с местом, последствием и серьёзностью
Код и тесты Воспроизвести проблему, оценить проверки Подтверждение или конкретная причина возврата
Исправленная редакция Повторно проверить замечания Что исправлено и что осталось открытым

Это схема вашей интеграции: событие запуска, среду агента, критерии и передачу отчёта вы настраиваете в CI. Собственный процесс можно создать через Workflow Management Flow или доработать из шаблона. Для исполнителя без браузера предусмотрен вход по API-токену.

Создать процесс · Настроить авторизацию клиента

Три разных задачи для тестирования

Спланировать проверки

Test Planning: из требований и рисков получить тестовые случаи и критерии приёмки. Например, решить, как проверять колесо прокрутки, якорные ссылки и режим уменьшенного движения до реализации.

Открыть Test Planning

Написать и запустить тесты

Test Generation: добавить исполняемые тесты в стиле проекта, выполнить нужные проверки и передать изменения на ревью. Например, зафиксировать контракт 160/320 px.

Открыть Test Generation

Проверить существующий набор

Test Suite Audit: найти пробелы, слабые утверждения и дублирование. Например, заметить тест, который проверяет только scrollY и не замечает, что страница сместилась иначе.

Открыть Test Suite Audit

У шага есть инструкция и контракт ответа

Moira проверяет структуру ответа по JSON Schema и выбирает следующий переход. Исполнитель и ревьюер проверяют код, доказательства и смысл результата. Эти проверки дополняют друг друга.

Как Moira обработает ответ агента

Агент отправил {}.

Шаг остаётся открытым. В ответе отсутствует обязательное поле check. Агенту нужно описать, как он проверил работу, и повторно отправить ответ на тот же шаг.

Посмотреть реальный шаг в JSON

Фрагмент публичного учебного процесса Example 1: Simple Steps: агент сравнивает результат с запросом и сообщает, как его проверил.

{
  "id": "check-result",
  "type": "agent-directive",
  "directive": "Compare the result with the request. Fix anything that does not match before you go on.",
  "completionCondition": "The result matches the request.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "check": {
        "type": "string",
        "description": "How you checked the result",
        "minLength": 1,
        "maxLength": 1000
      }
    },
    "required": ["check"]
  },
  "connections": { "success": "report" }
}

directive задаёт работу, completionCondition — ожидаемый результат, inputSchema — обязательный ответ check. После успешного шага процесс переходит к report.

Открыть учебный пример

Читайте процесс. Меняйте правила. Добавляйте инструменты.

В редакторе есть Steps, Map и технический Graph. Возьмите публичный воркфлоу за основу, измените инструкции, условия и переходы в своей копии. Валидация и история версий для владельца помогают поддерживать определение.

Процесс хранится в JSON: его можно читать и рецензировать как код. Шаблонные переменные подставляют контекст в инструкции и условия. Playbooks содержат общие инструкции поведения, Notes — персональные значения между процессами, Artifacts — разрешённые к публикации HTML-отчёты.

SDK расширений и дополнительный runner позволяют добавить типы узлов и исходящие каналы. Схемы описывают настройки, вход и выход узла. Редактор получает их из каталога. Для своего канала уведомлений есть пример исходящего webhook.

Редактор процессов · Playbooks · Notes · Artifacts · SDK расширений · Примеры расширений

Видно, какой шаг идёт и почему работа вернулась

Страница запуска показывает записанный маршрут, переданные ответы и возвраты после ревью. При наличии истории можно открыть прежнее состояние. Ожидание вашего решения отличается от ожидания агента. Подключённый Telegram помогает узнать, когда нужно внимание.

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

Страница запуска · Руководство интеграции агента · Telegram

Ваш репозиторий. Подходящая среда выполнения.

Оставьте агенту привычные инструменты или настройте Local microVM либо GitHub Codespaces через сопряжённый контроллер. Рабочие среды поддерживают команды, постоянные сессии, файлы и разрешённые Git-операции.

Local microVM использует поддерживаемый macOS Apple Silicon runtime. Codespaces работает через подключённый личный аккаунт GitHub и его оплату.

Само приложение Moira можно установить через Docker Compose на своём компьютере или сервере. Это отдельная установка от дополнительного Moira Local для рабочих сред. Код открыт по Apache-2.0.

Настроить рабочую среду · Установить Moira · Исходный код

Начните со следующего изменения

Подключите своего агента и передайте ему задачу вместе с репозиторием.

Используй в Moira Software Development Flow для этой ошибки. Сначала воспроизведи её и зафиксируй проверяемый результат. Проверь план, внеси исправление, добавь регрессионный тест и передай изменение на независимое ревью.

Локальные коммиты выполняются с вашим разрешением. За push, pull request, выпуск и развёртывание отвечаете вы или процесс, который запустил работу.

Moira дополняет агентную среду клиента, или harness: клиент ведёт разговор и цикл обращений к модели и инструментам, Moira — процесс и состояние запуска. Подключение использует Model Context Protocol (MCP).