Baoyu Article Illustrator

Иллюстрации к статьям: тип × стиль × согласованность палитры.

Метаданные навыка

Справочник: полный SKILL.md

Article Illustrator

Адаптировано из baoyu-article-illustrator для экосистемы инструментов Hermes Agent.

Анализирует статьи, определяет места для иллюстраций, генерирует изображения с согласованностью Тип × Стиль × Палитра.

Когда использовать

Активируйте навык, когда пользователь просит проиллюстрировать статью, добавить к ней изображения, сгенерировать иллюстрации для контента или использует фразы “为文章配图”, “illustrate article” или “add images”. Пользователь предоставляет статью (путь к файлу или вставленный текст) и при желании задаёт тип, стиль, палитру или плотность.

Три измерения

Комбинируйте свободно: type=infographic, style=vector-illustration, palette=macaron.

Либо используйте пресеты: edu-visual — тип + стиль + палитра одним выбором. См. style-presets.md.

Типы

Стили

Галерея основных стилей, полный каталог и таблица совместимости Тип × Стиль — в references/styles.md.

Структура вывода

{output-dir}/
├── source-{slug}.{ext}    # Only for pasted content
├── outline.md
├── prompts/
│   └── NN-{type}-{slug}.md
└── NN-{type}-{slug}.png

Директория вывода по умолчанию:

Если пользователь просит другое расположение (например, изображения рядом со статьёй или подпапку illustrations/), следуйте его пожеланию.

Slug: 2–4 слова, kebab-case. Конфликт имён: добавить суффикс -YYYYMMDD-HHMMSS.

Основные принципы

• Визуализировать концепцию, а не метафору — если в статье встречается метафора (например, “电锯切西瓜”), иллюстрируйте суть концепции, а не буквальный образ.
• Подписи берутся из данных статьи — реальные числа, термины и цитаты из текста, без шаблонных заглушек.
• Файлы промптов — это записи для воспроизводимости — каждая иллюстрация должна иметь сохранённый файл промпта в prompts/ до того, как сгенерировано изображение.
• Убирать секреты — перед записью чего-либо на диск проверяйте исходный контент на наличие API-ключей, токенов и учётных данных.

Рабочий процесс

- [ ] Step 1: Detect reference images (if provided)
- [ ] Step 2: Analyze content
- [ ] Step 3: Confirm settings (clarify tool)
- [ ] Step 4: Generate outline
- [ ] Step 5: Generate prompts
- [ ] Step 6: Generate images (image_generate)
- [ ] Step 7: Finalize

Шаг 1: Определение референсных изображений

Если пользователь прикладывает референсные изображения (пути в тексте, вложения или URL):

1. Для каждого референса вызовите vision_analyze, передав путь/URL и вопрос о стиле, палитре, композиции и сюжете. Запишите полученное описание в {output-dir}/references/NN-ref-{slug}.md через write_file.
2. Не пытайтесь копировать бинарный файл через write_file / read_file — они работают только с текстом. Если нужна локальная копия, используйте terminal (cp "$src" "{output-dir}/references/NN-ref-{slug}.{ext}"). Сам навык не читает бинарник — он работает с описанием от vision.
3. Поскольку image_generate не принимает изображения на вход, именно это описание встраивается в промпты на Шаге 5.

Подробные процедуры: references/workflow.md.

Шаг 2: Анализ

Прочитайте источник (путь к файлу → read_file, или вставленный текст) и сохраните анализ в {output-dir}/analysis.md через write_file.

Подробные процедуры: references/workflow.md.

Шаг 3: Подтверждение настроек

Используйте инструмент clarify. Независимые вопросы собирайте в один массив questions (до 5). Пропускайте вопросы, ответ на которые уже есть в запросе пользователя.

Не задавайте подряд более 2–3 вопросов clarify. Если пользователь уже указал эти параметры в запросе — пропустите шаг целиком.

Подробные процедуры: references/workflow.md.

Шаг 4: Генерация структуры → outline.md

Сохраните {output-dir}/outline.md через write_file — с frontmatter (type, density, style, palette, image_count) и одной записью на каждую иллюстрацию:

## Illustration 1
**Position**: [section/paragraph]
**Purpose**: [why]
**Visual Content**: [what to show]
**Filename**: 01-infographic-concept-name.png

Полный шаблон: references/workflow.md.

Шаг 5: Генерация промптов

БЛОКИРУЮЩИЙ ШАГ: у каждой иллюстрации должен быть сохранённый файл промпта до генерации изображения — этот файл обеспечивает воспроизводимость.

Для каждой иллюстрации:

1. Создайте файл промпта согласно references/prompt-construction.md.
2. Сохраните в {output-dir}/prompts/NN-{type}-{slug}.md через write_file с YAML frontmatter.
3. Промпты ОБЯЗАНЫ использовать шаблоны для конкретного типа со структурированными секциями (ZONES / LABELS / COLORS / STYLE / ASPECT).
4. LABELS ОБЯЗАНЫ содержать данные из статьи: реальные числа, термины, метрики, цитаты.
5. Обрабатывайте референсы (direct/style/palette) согласно frontmatter промпта — для direct-режима встраивайте текстовое описание референса в промпт (поскольку image_generate не принимает изображения на вход).

Шаг 6: Генерация изображений

Для каждого файла промпта:

1. Вызовите image_generate(prompt=..., aspect_ratio=...). image_generate возвращает JSON с URL изображения; на диск ничего не пишет и путь вывода не принимает.
2. Переведите ASPECT из промпта в enum image_generate: 16:9 → landscape, 9:16 → portrait, 1:1 → square. Нестандартные соотношения — к ближайшему именованному варианту.
3. Скачайте полученный URL в {output-dir}/NN-{type}-{slug}.png через terminal (например: curl -sSL -o "{output-dir}/NN-{type}-{slug}.png" "{url}").
4. При ошибке генерации — один автоматический повтор.

Примечание: бэкенд генерации изображений настраивается пользователем (по умолчанию: FAL FLUX 2 Klein 9B) и НЕ выбирается агентом через image_generate. Не вписывайте названия моделей в промпты в расчёте на маршрутизацию.

Шаг 7: Финализация

Вставьте ![description](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/creative/baoyu-article-illustrator/{relative-path}/NN-{type}-{slug}.png) после соответствующего абзаца. Alt-текст: краткое описание на языке статьи.

Отчёт:

Article Illustration Complete!
Article: [path] | Type: [type] | Density: [level] | Style: [style] | Palette: [palette or default]
Images: X/N generated

Изменение иллюстраций

Справочные файлы

Типичные ошибки

1. Целостность данных — прежде всего — никогда не сокращайте, не перефразируйте и не изменяйте статистику из источника. “73% increase” остаётся “73% increase”.
2. Убирать секреты — перед добавлением в любой выходной файл проверяйте исходный контент на API-ключи, токены и учётные данные.
3. Не иллюстрировать метафоры буквально — визуализируйте суть концепции.
4. Файлы промптов обязательны — генерация изображений без сохранённого файла промпта недопустима. Файл нужен для повторной генерации или смены бэкенда позже.
5. Соотношения сторон image_generate — инструмент поддерживает landscape, portrait и square. Нестандартные соотношения сопоставляются с ближайшим вариантом.
6. image_generate возвращает URL, а не локальный файл — всегда скачивайте через terminal (curl) перед тем, как вставлять локальные пути изображений в статью.
7. Выбор бэкенда агентом невозможен — image_generate использует ту модель, которую настроил пользователь (по умолчанию: FAL FLUX 2 Klein 9B). Не пишите "use <model> to generate this" в промптах в надежде на маршрутизацию.