Руководство

Подключить GitHub и создать первый draft PR

Подключите GitHub, чтобы превращать одобренные SEO-правки и статьи в проверяемые draft PR — с файлами, diff и отдельным подтверждением перед созданием.

На этой странице

Перед началом#

Нужен Платный тариф и право установить GitHub App для репозитория сайта. Заранее уточните базовую ветку и корневую папку проекта. Для статей также пригодятся папка контента и формат Markdown или MDX.

Система создаёт только draft PR. Проверка CI, ревью, merge и deploy остаются в обычном процессе вашей команды.

Подключите репозиторий#

  1. Откройте Интеграции.
  2. В разделе «Инструменты» найдите «GitHub репозиторий» и нажмите «Подключить».
  3. На стороне GitHub установите GitHub App и предоставьте доступ к нужному репозиторию.
  4. После возвращения выберите репозиторий и нажмите «Выбрать и проверить».

Подтвердите конфигурацию#

Проверьте поля «Базовая ветка», «Корневая папка сайта», «Папка статей» и «Формат статей». Если структура определена верно, нажмите «Подтвердить конфигурацию».

Успешное подключение подтверждается сообщением «Репозиторий подтверждён» и статусом «Подключено» в строке GitHub.

Подготовьте изменение#

Для SEO-правки откройте рекомендацию «SEO-агента» и нажмите «Подготовить исправление». Для статьи откройте готовый материал в «Агенте статей», выберите «Опубликовать», затем «Сайт» и «GitHub».

Когда изменение готово, нажмите «Создать draft PR».

Проверьте и создайте draft PR#

Система покажет репозиторий, базовую ветку, стоимость действия, риски, список файлов и diff. Просмотрите каждое изменение. Если всё верно, нажмите «Подтвердить и создать draft PR».

Во время выполнения появится «Создаём draft PR». Успешный результат — «Draft PR создан» и ссылка «Открыть draft PR».

Если не подключилось или PR не создан#

  • При статусе «Выберите репозиторий» завершите выбор и проверку.
  • Если видите «Доступ отозван» или «Нужно переподключить», снова настройте доступ GitHub App.
  • При «Репозиторий недоступен» проверьте, что GitHub App всё ещё имеет к нему доступ.
  • Если базовая ветка изменилась, нажмите «Проверить репозиторий заново» и подтвердите конфигурацию.
  • При сообщении «Не удалось создать PR» не повторяйте действие вслепую: сначала проверьте видимую причину и актуальность ветки.

Подробная диагностика есть в решении проблем.

Что дальше#

Откройте draft PR в GitHub, дождитесь проверок репозитория и передайте его на ревью. Система не объединяет и не публикует изменения самостоятельно.

На этой странице