Одна команда, четыре роли

Навыки HERON

Навык — короткая инструкция, которую ИИ-агент загружает, когда она нужна для задачи. У HERON четыре навыка, по одному на каждую роль в работе над сайтом. Каждый объясняет агенту, как устроен сайт на HERON, что ему можно менять и что нужно оставить в покое.

Они работают в Claude Code, Codex и других агентах, которые читают навыки со skills.sh.

Установка

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

Все четыре навыка

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

npx skills add FMSTM/HERON

Куда ставятся: В папку навыков вашего агента, рядом с сайтом.
Обновление: Выполните ту же команду, когда выйдет новая версия HERON.
Что нужно: Node.js, он даёт команду npx. Проверка: node --version.
Проверка: Спросите агента «какие навыки HERON у тебя есть?» — он должен назвать четыре.

Только нужные

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

npx skills add FMSTM/HERON --skill heron-content

Совет: Несколько — через запятую: heron-content,heron-builder.
Для клиента или редактора: Дайте только heron-content: тексты менять можно, а тему сломать нельзя.

Без навыков

Агенты, которые не читают навыки, получают те же правила от самого HERON. В выгруженной папке гайды, роли и спецификации вашей версии HERON.

heron docs --export .heron-docs && ls .heron-docs

Потом: Скажите агенту: «Прочитай .heron-docs/AGENTS.md и работай в роли контента».
Подробнее: HERON для ИИ-агентов

Что может менять каждый навык

Навык	Пишет в	Не трогает никогда
heron-content	`content/`, `media/`, `data/`	`theme/`, `site.yaml`, `scripts/`, `.github/`
heron-designer	`theme/`	`content/`, `site.yaml`, `scripts/`, `.github/`
heron-architect	план структуры, `site.yaml`	тексты страниц, шаблоны в `theme/`
heron-builder	`dist/`, образ, отчёт, `.github/workflows/`	сам HERON; файлы других ролей — только в их границах

Четыре навыка

heron-content

Пишет и переводит страницы, заполняет настройки для поиска в начале каждого файла. Навык, который пригодится каждую неделю.

Когда: Новые страницы, переводы, тексты и настройки для поиска.
Передаёт: Файлы в content/, картинки в media/, список недостающих фактов.
Может писать: content/, media/, data/.
Не может: theme/, структуру site.yaml, скрипты, .github/.
Правила: Роль «Контент»

heron-designer

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

Когда: Новый вид, макет, который нужно превратить в тему, новый блок.
Передаёт: Папку theme/: шаблоны, модули, тексты интерфейса, стили.
Может писать: Только theme/.
Правило: Никаких текстов сайта в шаблонах; слова интерфейса — в языковых файлах темы.
Правила: Роль «Дизайнер»

heron-architect

Планирует сайт: страницы и адреса, типы страниц и их блоки, языки, переезд со старого сайта. Работает до того, как кто-то напишет первую страницу.

Когда: Вы начинаете новый сайт или переносите старый.
Передаёт: План структуры, черновик site.yaml, таблицу старых и новых адресов.
Спрашивает вас: Вопросы с вариантами и рекомендацией, когда решение за вами.
Правила: Роль «Архитектор»

heron-builder

Доводит строгую сборку, упаковывает образ, запускает проверку и публикует. Может вести остальные три роли, каждую в её границах. Дайте ему всю работу целиком и получите отчёт.

Когда: «Собери сайт», «опубликуй», «почему падает сборка».
Передаёт: dist/ или образ и отчёт.
Никогда: Не кладёт токены, Dockerfile и настройки сервера в папку сайта.
Правила: Роль «Сборщик»

Правила, которые держит каждый навык

Факты не выдумываются

Телефоны, цены, адреса и имена — только от вас. Если их нет, поле остаётся пустым, а агент вносит его в список.

Один файл настроек

Языки, домен, меню и счётчики живут в site.yaml и больше нигде.

Предупреждение — это работа

Строгая сборка превращает предупреждения в ошибки; агент их исправляет, а не прячет.

HERON не меняется из сайта

Если чего-то не хватает, агент записывает это задачей и делает на сайте самый простой честный вариант.

Вопросы

Почему навык контента не может менять тему?

Чтобы правка страницы никогда не ломала вид сайта. Тексты и дизайн — разные задачи, и когда менять дизайн, решаете вы.

Навыки работают без интернета?

Навыки — файлы в вашем проекте. Без интернета выгрузите документацию командой heron docs --export, и агент будет читать её из папки.

Можно поменять навык под свою команду?

Да, это обычные текстовые файлы. Сохраните ограничения на папки: именно они не дают правке текста задеть дизайн.