Baoyu Comic

Познавательные комиксы (知识漫画): обучение, биография, туториал.

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


Источник	Опциональный — установить командой `hermes skills install official/creative/baoyu-comic`
Путь	`optional-skills/creative/baoyu-comic`
Версия	`1.56.1`
Автор	宝玉 (JimLiu)
Лицензия	MIT
Платформы	linux, macos, windows
Теги	`comic`, `knowledge-comic`, `creative`, `image-generation`

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

инфо

Ниже приведено полное определение навыка, которое Hermes загружает при его срабатывании. Именно это агент видит как инструкции, когда навык активен.

Knowledge Comic Creator

Адаптировано из baoyu-comic под экосистему инструментов Hermes Agent.

Создаёт авторские познавательные комиксы с гибкими сочетаниями художественного стиля и настроения.

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

Запускайте навык, когда пользователь просит сделать познавательный/обучающий комикс, комикс-биографию, комикс-туториал или использует формулировки вроде «知识漫画», «教育漫画» или «в стиле Logicomix». Пользователь даёт материал (текст, путь к файлу, URL или тему) и при желании указывает художественный стиль, настроение, раскладку, соотношение сторон или язык.

Референсные изображения

Инструмент Hermes image_generate работает только по промпту — он принимает текстовый промпт и соотношение сторон, а возвращает URL изображения. Референсные изображения он НЕ принимает. Когда пользователь даёт референс, используйте его, чтобы извлечь признаки в виде текста и вставить их в промпт каждой страницы:

Приём: принимайте пути к файлам, если пользователь их даёт (или вставляет изображения прямо в диалог).

Путь(и) к файлу → скопируйте в refs/NN-ref-{slug}.{ext} рядом с результатом комикса для прослеживаемости
Вставленное изображение без пути → запросите путь у пользователя через clarify либо опишите признаки стиля словами как запасной вариант
Нет референса → пропустите этот раздел

Режимы использования (для каждого референса):

Режим	Эффект
`style`	Извлечь признаки стиля (характер линии, текстуру, настроение) и добавить в тело промпта каждой страницы
`palette`	Извлечь hex-цвета и добавить в тело промпта каждой страницы
`scene`	Извлечь композицию сцены или заметки об объекте съёмки и добавить к соответствующим страницам

Записывайте во frontmatter промпта каждой страницы, если референсы есть:

references:
  - ref_id: 01
    filename: 01-ref-scene.png
    usage: style
    traits: "muted earth tones, soft-edged ink wash, low-contrast backgrounds"

Единообразие персонажей задаётся текстовыми описаниями в characters/characters.md (пишутся на шаге 3), которые вставляются прямо в промпт каждой страницы (шаг 5). Опциональный PNG-лист персонажей, который генерируется на шаге 7.1, — это артефакт для просмотра человеком, а не вход для image_generate.

Параметры

Визуальные измерения

Параметр	Значения	Описание
Art	ligne-claire (по умолчанию), manga, realistic, ink-brush, chalk, minimalist	Художественный стиль / техника рендера
Tone	neutral (по умолчанию), warm, dramatic, romantic, energetic, vintage, action	Настроение / атмосфера
Layout	standard (по умолчанию), cinematic, dense, splash, mixed, webtoon, four-panel	Раскладка панелей
Aspect	3:4 (по умолчанию, портрет), 4:3 (альбом), 16:9 (широкий формат)	Соотношение сторон страницы
Language	auto (по умолчанию), zh, en, ja и т. д.	Язык вывода
Refs	Пути к файлам	Референсные изображения для извлечения признаков стиля / палитры (модели изображений не передаются). См. Референсные изображения выше.

Параметры частичного процесса

Параметр	Описание
Только раскадровка	Сгенерировать только раскадровку, пропустить промпты и изображения
Только промпты	Сгенерировать раскадровку + промпты, пропустить изображения
Только изображения	Сгенерировать изображения из существующего каталога промптов
Перегенерировать N	Перегенерировать только указанные страницы (например, `3` или `2,5,8`)

Подробнее: references/partial-workflows.md

Каталог стилей, настроений и пресетов

Художественные стили (6): ligne-claire, manga, realistic, ink-brush, chalk, minimalist. Полные определения в references/art-styles/<style>.md.
Настроения (7): neutral, warm, dramatic, romantic, energetic, vintage, action. Полные определения в references/tones/<tone>.md.

Пресеты (5) с особыми правилами поверх обычной пары стиль+настроение:

Пресет	Эквивалент	Фишка
`ohmsha`	manga + neutral	Визуальные метафоры, без говорящих голов, эффектные раскрытия гаджетов
`wuxia`	ink-brush + action	Эффекты ци, боевые сцены, атмосферность
`shoujo`	manga + romantic	Декоративные элементы, проработка глаз, романтические моменты
`concept-story`	manga + warm	Система визуальных символов, арка роста, баланс диалога и действия
`four-panel`	minimalist + neutral + раскладка four-panel	Структура 起承转合, ч/б + точечный цвет, персонажи-палочные человечки

Полные правила в references/presets/<preset>.md — загружайте файл, когда пресет выбран.

Матрица совместимости и таблица «сигнал контента → пресет» лежат в references/auto-selection.md. Прочитайте её перед тем, как рекомендовать сочетания на шаге 2.

Структура файлов

Каталог вывода: comic/{topic-slug}/

Slug: 2–4 слова в kebab-case из темы (например, alan-turing-bio)
Конфликт: добавьте временную метку (например, turing-story-20260118-143052)

Содержимое:

Файл	Описание
`source-{slug}.md`	Сохранённый исходный материал (slug в kebab-case совпадает с каталогом вывода)
`analysis.md`	Анализ контента
`storyboard.md`	Раскадровка с разбивкой по панелям
`characters/characters.md`	Описания персонажей
`characters/characters.png`	Референсный лист персонажей (скачан из `image_generate`)
`prompts/NN-{cover\|page}-[slug].md`	Промпты для генерации
`NN-{cover\|page}-[slug].png`	Сгенерированные изображения (скачаны из `image_generate`)
`refs/NN-ref-{slug}.{ext}`	Референсы от пользователя (опционально, для прослеживаемости)

Работа с языком

Приоритет определения:

Язык, заданный пользователем (явный параметр)
Язык диалога пользователя
Язык исходного материала

Правило: используйте язык ввода пользователя для ВСЕХ взаимодействий:

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

Технические термины остаются на английском.

Процесс

Чек-лист прогресса

Comic Progress:
- [ ] Step 1: Setup & Analyze
  - [ ] 1.1 Analyze content
  - [ ] 1.2 Check existing directory
- [ ] Step 2: Confirmation - Style & options ⚠️ REQUIRED
- [ ] Step 3: Generate storyboard + characters
- [ ] Step 4: Review outline (conditional)
- [ ] Step 5: Generate prompts
- [ ] Step 6: Review prompts (conditional)
- [ ] Step 7: Generate images
  - [ ] 7.1 Generate character sheet (if needed) → characters/characters.png
  - [ ] 7.2 Generate pages (with character descriptions embedded in prompt)
- [ ] Step 8: Completion report

Поток

Input → Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review?] → Prompts → [Review?] → Images → Complete

Краткая сводка по шагам

Шаг	Действие	Главный результат
1.1	Анализ контента	`analysis.md`, `source-{slug}.md`
1.2	Проверка существующего каталога	Обработка конфликтов
2	Подтвердить стиль, фокус, аудиторию, ревью	Предпочтения пользователя
3	Сгенерировать раскадровку + персонажей	`storyboard.md`, `characters/`
4	Ревью плана (если запрошено)	Одобрение пользователя
5	Сгенерировать промпты	`prompts/*.md`
6	Ревью промптов (если запрошено)	Одобрение пользователя
7.1	Сгенерировать лист персонажей (если нужно)	`characters/characters.png`
7.2	Сгенерировать страницы	файлы `*.png`
8	Отчёт о завершении	Итоговая сводка

Вопросы пользователю

Подтверждайте параметры инструментом clarify. Поскольку clarify задаёт по одному вопросу за раз, начинайте с самого важного и идите последовательно. Полный набор вопросов шага 2 см. в references/workflow.md.

Обработка таймаута (КРИТИЧНО): clarify может вернуть "The user did not provide a response within the time limit. Use your best judgement to make the choice and proceed." — это НЕ согласие пользователя оставить всё по умолчанию.

Считайте это значением по умолчанию только для этого одного вопроса. Продолжайте задавать остальные вопросы шага 2 по очереди; каждый вопрос — самостоятельная точка согласия.
Явно покажите дефолт пользователю в следующем сообщении, чтобы у него была возможность поправить: например, "Style: defaulted to ohmsha preset (clarify timed out). Say the word to switch." — необъявленный дефолт неотличим от ситуации, когда вопрос вообще не задавали.
НЕ сворачивайте шаг 2 в один проход «берём все дефолты» после первого таймаута. Если пользователь действительно отсутствует, он будет так же отсутствовать на всех пяти вопросах — но видимые дефолты он сможет поправить, когда вернётся, а невидимые — нет.

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

Для всего рендера изображений используйте встроенный инструмент Hermes image_generate. Его схема принимает только prompt и aspect_ratio (landscape | portrait | square); он возвращает URL, а не локальный файл. Поэтому каждую сгенерированную страницу или лист персонажей нужно скачивать в каталог вывода.

Требование к файлу промпта (жёсткое): записывайте полный финальный промпт каждого изображения в отдельный файл в prompts/ (имя: NN-{type}-[slug].md) ДО вызова image_generate. Файл промпта — это запись для воспроизводимости.

Сопоставление соотношений сторон — поле aspect_ratio из раскадровки переводится в формат image_generate так:

Соотношение в раскадровке	Формат `image_generate`
`3:4`, `9:16`, `2:3`	`portrait`
`4:3`, `16:9`, `3:2`	`landscape`
`1:1`	`square`

Шаг скачивания — после каждого вызова image_generate:

Прочитайте URL из результата инструмента
Скачайте байты изображения по абсолютному пути вывода, например curl -fsSL "<url>" -o /abs/path/to/comic/<slug>/NN-page-<slug>.png
Убедитесь, что файл существует и непустой именно по этому пути, прежде чем переходить к следующей странице

Никогда не полагайтесь на сохранение CWD оболочки для путей в -o. CWD постоянной оболочки терминала может смениться между батчами (истечение сессии, TERMINAL_LIFETIME_SECONDS, неудачный cd, оставивший вас не в том каталоге). curl -o relative/path.png — это тихая мина: если CWD сместился, файл уйдёт в другое место без всякой ошибки. Всегда передавайте в -o полностью квалифицированный абсолютный путь либо передавайте workdir=<abs path> инструменту терминала. Инцидент, апрель 2026: страницы 06–09 десятистраничного комикса осели в корне репозитория вместо comic/<slug>/, потому что батч 3 унаследовал устаревший CWD от батча 2, и curl -o 06-page-skills.png записал файл не туда. Агент потом несколько ходов утверждал, что файлы лежат там, где их не было.

7.1 Лист персонажей — генерируйте его (в characters/characters.png, формат landscape), когда комикс многостраничный и в нём есть повторяющиеся персонажи. Пропускайте для простых пресетов (например, four-panel minimalist) или одностраничных комиксов. Файл промпта characters/characters.md должен существовать до вызова image_generate. Готовый PNG — это артефакт для просмотра человеком (чтобы пользователь мог визуально проверить дизайн персонажей) и ориентир для последующих перегенераций или ручной правки промптов; он не управляет шагом 7.2. Промпты страниц уже написаны на шаге 5 из текстовых описаний в characters/characters.md; image_generate не принимает изображения как визуальный вход.

7.2 Страницы — промпт каждой страницы ОБЯЗАН уже лежать в prompts/NN-{cover|page}-[slug].md до вызова image_generate. Поскольку image_generate работает только по промпту, единообразие персонажей обеспечивается вставкой описаний персонажей (взятых из characters/characters.md) прямо в промпт каждой страницы на шаге 5. Вставка делается одинаково независимо от того, создавался ли PNG-лист на шаге 7.1; PNG — лишь подспорье для ревью/перегенерации.

Правило резервных копий: существующие файлы prompts/…md и …png → переименуйте с суффиксом -backup-YYYYMMDD-HHMMSS перед перегенерацией.

Полный пошаговый процесс (анализ, раскадровка, точки ревью, варианты перегенерации): references/workflow.md.

Справочные материалы

Основные шаблоны:

analysis-framework.md — Подробный анализ контента
character-template.md — Формат описания персонажа
storyboard-template.md — Структура раскадровки
ohmsha-guide.md — Особенности манги Ohmsha

Определения стилей:

references/art-styles/ — Художественные стили (ligne-claire, manga, realistic, ink-brush, chalk, minimalist)
references/tones/ — Настроения (neutral, warm, dramatic, romantic, energetic, vintage, action)
references/presets/ — Пресеты с особыми правилами (ohmsha, wuxia, shoujo, concept-story, four-panel)
references/layouts/ — Раскладки (standard, cinematic, dense, splash, mixed, webtoon, four-panel)

Процесс:

workflow.md — Полное описание процесса
auto-selection.md — Анализ сигналов контента
partial-workflows.md — Параметры частичного процесса

Изменение страниц

Действие	Шаги
Правка	Сначала обновите файл промпта → перегенерируйте изображение → скачайте новый PNG
Добавление	Создайте промпт на нужной позиции → сгенерируйте с вставленными описаниями персонажей → перенумеруйте последующие → обновите раскадровку
Удаление	Удалите файлы → перенумеруйте последующие → обновите раскадровку

ВАЖНО: при обновлении страниц ВСЕГДА сначала обновляйте файл промпта (prompts/NN-{cover|page}-[slug].md), а уже потом перегенерируйте. Так изменения задокументированы и воспроизводимы.

Подводные камни

Генерация изображения: 10–30 секунд на страницу; при сбое один автоматический повтор
Всегда скачивайте URL, возвращённый image_generate, в локальный PNG — последующие инструменты (и ревью пользователя) ждут файлы в каталоге вывода, а не временные URL
Используйте абсолютные пути для curl -o — никогда не полагайтесь на CWD постоянной оболочки между батчами. Тихая мина: файлы оседают не в том каталоге, и последующий ls по нужному пути ничего не показывает. См. «Шаг скачивания» в шаге 7.
Для чувствительных публичных персон используйте стилизованные альтернативы
Подтверждение на шаге 2 обязательно — не пропускать
Шаги 4/6 условные — только если пользователь запросил их на шаге 2
Лист персонажей на шаге 7.1 — рекомендуется для многостраничных комиксов, опционален для простых пресетов. PNG — подспорье для ревью/перегенерации; промпты страниц (написанные на шаге 5) опираются на текстовые описания в characters/characters.md, а не на PNG. image_generate не принимает изображения как визуальный вход
Вычищайте секреты — перед записью любого файла вывода просканируйте исходный материал на API-ключи, токены и учётные данные