Baoyu Comic

Knowledge comics (知识漫画): educational, biography, tutorial.

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

Источник	Опционально — установка через vibeos 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

к сведению

Ниже приведено полное определение навыка, которое VibeOS загружает при его активации. Агент видит эти инструкции, когда навык активен.

Knowledge Comic Creator

Адаптировано из baoyu-comic для экосистемы инструментов VibeOS.

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

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

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

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

Инструмент image_generate в VibeOS работает только с текстовым запросом — он принимает текстовый промпт и соотношение сторон, возвращая 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.

Опции

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

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

Опции частичного рабочего процесса

Опция	Описание
Только раскадровка	Создать только раскадровку, пропустить промпты и изображения
Только промпты	Создать раскадровку + промпты, пропустить изображения
Только изображения	Создать изображения из существующей директории промптов
Перегенерировать 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 layout	Структура 起承转合, ч/б + акцентный цвет, персонажи из палочек

  Полные правила в 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}	Референтные изображения от пользователя (опционально, для отслеживания происхождения)

Обработка языка

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

1. Язык, указанный пользователем (явная опция)
2. Язык диалога пользователя
3. Язык исходного контента

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

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

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

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

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

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 последовательно; каждый вопрос является независимой точкой согласия.
• Явно сообщите пользователю о значении по умолчанию в вашем следующем сообщении, чтобы у него была возможность его исправить: например, «Стиль: по умолчанию выбран пресет ohmsha (clarify превысил время ожидания). Скажите, если хотите изменить». — Несообщённое значение по умолчанию неотличимо от того, что вопрос никогда не задавался.
• НЕ сворачивайте шаг 2 в один проход «использовать всё по умолчанию» после одного тайм-аута. Если пользователь действительно отсутствует, он будет одинаково отсутствовать для всех пяти вопросов — но он сможет исправить видимые значения по умолчанию, когда вернётся, и не сможет исправить невидимые.

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

Используйте встроенный инструмент VibeOS 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:

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

Никогда не полагайтесь на сохранение CWD оболочки для путей -o. Текущая рабочая директория (CWD) постоянной оболочки терминального инструмента может меняться между пакетами (истечение сессии, TERMINAL_LIFETIME_SECONDS, неудачный cd, оставляющий вас в неправильной директории). curl -o relative/path.png — это тихая мина: если CWD сместилась, файл оказывается в другом месте без ошибки. Всегда передавайте полностью квалифицированный абсолютный путь в -o или передавайте workdir=<abs path> в терминальный инструмент. Инцидент, апрель 2026: страницы 06-09 10-страничного комика оказались в корне репозитория вместо 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, токенов или учётных данных перед записью любого выходного файла