Ветка, pull request, проверенный образ

Сайт с Codex

Codex берёт задачу, делает её в отдельной ветке и открывает pull request. С HERON у него две работы: писать содержимое страниц или собирать сайт и следить, чтобы он проходил все проверки. Вы смотрите pull request, и на сайт ничего не попадает, пока вы его не примете.

GitHub ещё раз собирает сайт на своей стороне и проверяет, что он открывается, поэтому вы принимаете уже проверенную правку.

Настройка

1
Положите сайт в репозиторий GitHub

Подойдёт любая папка, созданная heron new.
Публикация через git push
2
Подключите репозиторий к Codex

Codex читает навыки HERON как обычные инструкции проекта.
3
Добавьте навыки HERON

npx skills add FMSTM/HERON в репозитории, затем закоммитьте результат.
О навыках
4
Проверьте файл сборки

.github/workflows/image.yml собирает и проверяет сайт при каждом push. Его пишет конфигуратор, если выбрать GitHub и включить автоматическую сборку.
Конфигуратор

Скопируйте задание

Контент

Новые страницы, переводы, тексты.

Это сайт на HERON. Используй навык heron-content.
Задача: [добавь страницу цен на русском и английском].
Работай только в content/, media/ и data/. Для новой страницы скопируй страницу того же вида, заполни title, h1 и description.
Добейся, чтобы heron build . --env prod --strict проходил, и открой pull request: что изменилось, какие факты нужны от меня.

Вы получаете: Pull request с новыми файлами и список недостающих фактов.
Просмотр: На GitHub вкладка Files changed показывает каждую строку, которую изменил агент, красным и зелёным.
Принять: Когда проверка зелёная и текст верный, нажмите Merge — сайт обновится.
Поправить: Оставьте комментарий в pull request; Codex учтёт его в следующем круге.

Сборщик

Когда сборка падает или сайту нужен выпуск.

Это сайт на HERON. Используй навык heron-builder.
Задача: [добейся прохождения строгой сборки после последних правок].
Исправляй ошибки в файлах той роли, к которой они относятся, и в её границах. HERON не меняй.
Открой pull request с отчётом: что было не так, что изменено, какие предупреждения остались.

Вы получаете: Зелёную отметку на GitHub и отчёт.
Отчёт: Что сделано, какие предупреждения остались и почему, какого контента ещё не хватает.
Когда пригодится: Перед запуском, после обновления HERON или когда сборка падает и непонятно почему.

Что происходит после pull request

1
GitHub собирает сайт

Workflow запускает строгую сборку стабильным образом HERON.
2
GitHub упаковывает образ

Папка dist/ уходит в маленький образ с nginx по рецепту той же версии HERON.
3
GitHub проверяет образ

Запускает его и проверяет ответы: главная открывается, несуществующая страница отдаёт 404, каждая переадресация — 301 или 410.
4
Вы принимаете

Новый образ публикуется в ghcr.io/you/my-site, и сервер может его забрать.
Как обновление доходит до сервера

Файл сборки

Вся сборка и проверка — один короткий файл в репозитории сайта. Длинную часть HERON держит у себя, вам её поддерживать не нужно.

name: image
on:
  push:
    branches: [main]
jobs:
  image:
    uses: FMSTM/HERON/.github/workflows/site-image.yml@prod
    permissions:
      contents: read
      packages: write
    with:
      env: prod
      engine: prod

env

dev собирает закрытый просмотр, prod открывает сайт поисковикам.

engine

Версия HERON: prod — стабильная.

Вопросы

Нужен ли Codex доступ к моему серверу?

Нет. Codex работает с репозиторием. Сервер получает новый образ из реестра.

Может Codex поменять дизайн?

Не в этих ролях. Тема — отдельная задача для роли дизайнера: Тема с Claude Design.

Что, если проверка на GitHub не прошла?

В pull request появится красная отметка, а в журнале будут страница и ошибка. Попросите Codex исправить в той же ветке.

Сайт с Codex

Настройка

Положите сайт в репозиторий GitHub

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

Добавьте навыки HERON

Проверьте файл сборки