Kanban Video Orchestrator

Планирование, настройка и мониторинг мультиагентного конвейера видеопроизводства на базе Hermes Kanban. Используйте, когда пользователю нужно сделать ЛЮБОЕ видео — нарративный фильм, продуктовый/маркетинговый ролик, музыкальный клип, объясняющий ролик, ASCII/терминальный арт, абстрактный/генеративный луп, комикс, 3D, видео реального времени/инсталляцию — и работа достаточно крупная, чтобы разбить её на специализированные профили (сценарист, дизайнер, аниматор, рендерер, голос, монтажёр и т. д.), скоординированные через kanban-доску. Навык ведёт адаптивный опрос, чтобы очертить бриф, проектирует подходящую команду под запрошенный стиль, генерирует setup-скрипт, создающий профили Hermes и начальную kanban-задачу, а затем помогает следить за исполнением и вмешиваться, когда задачи застревают или падают. Сцены маршрутизируются на тот навык рендеринга / аудио / дизайна Hermes, что подходит каждому биту (ascii-video, manim-video, p5js, comfyui, touchdesigner-mcp, pixel-art, baoyu-comic, claude-design, excalidraw, songsee, heartmula, …), плюс при необходимости внешние API для TTS, генерации изображений и image-to-video.

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

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

Kanban Video Orchestrator

Любой запрос на видео — от 15-секундного продуктового тизера до 5-минутной нарративной короткометражки, музыкального клипа или ASCII-лупа — оборачивайте в конвейер Hermes Kanban, который раскладывает работу по специализированным профилям агентов.

Сам навык ничего не рендерит. Это мета-конвейер, который:

1. Очерчивает запрос через целевой опрос
2. Проектирует подходящую команду (какие роли, какие инструменты у каждой роли) исходя из стиля
3. Генерирует setup-скрипт, создающий профили Hermes, рабочее пространство проекта и начальную kanban-задачу
4. Передаёт управление профилю-режиссёру, который раскладывает работу через kanban
5. Следит за исполнением и помогает вмешаться, когда задачи застревают или падают

Рендеринг происходит внутри kanban после её запуска — через те навыки и инструменты, что подходят под сцены: ascii-video, manim-video, p5js, comfyui, touchdesigner-mcp, songwriting-and-ai-music, heartmula, внешние API или обычный Python с PIL + ffmpeg.

Когда НЕ использовать этот навык

• Видео — один непрерывный процедурный проект, которому не нужны специалисты. Просто пишите код напрямую.
• Пользователю нужна быстрая разовая конвертация (например, «преврати этот mp4 в GIF») — берите ffmpeg напрямую.
• Результат — статичное изображение, GIF или только аудио — используйте соответствующий навык (ascii-art, gifs, meme-generation, songwriting-and-ai-music).
• Работа аккуратно укладывается в один существующий навык (например, чистое ASCII-видео — просто используйте ascii-video).

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

DISCOVER  →  BRIEF  →  TEAM DESIGN  →  SETUP  →  EXECUTE  →  MONITOR

Шаг 1 — Опрос (задайте правильные вопросы)

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

• Что это за видео? (бриф в одно предложение)
• Какой длины? (тизер 5–30 с / короткометражка 30–90 с / объясняющий ролик 90 с — 3 мин / фильм 3–10 мин / длиннее)
• Какое соотношение сторон + целевая платформа? (1:1 / 9:16 / 16:9; X, IG, YouTube, внутренний показ и т. д.)

По ответу определите категорию стиля. Стиль задаёт, какие уточняющие вопросы задавать дальше. Не задавайте все вопросы сразу. Спрашивайте по 2–4 за раз, слушайте, потом двигайтесь дальше. Делайте разумные допущения везде, где ответ вытекает из слов пользователя.

Полные шаблоны опроса и наборы вопросов по каждому стилю см. в references/intake.md.

Шаг 2 — Бриф

Когда известно достаточно, составьте структурированный brief.md по шаблону из assets/brief.md.tmpl. Этапы:

1. Концепция — питч в одно предложение + эмоциональный ориентир
2. Объём — длительность, соотношение сторон, платформа, дедлайн
3. Стиль — визуальные референсы, бренд-ограничения, тон
4. Сцены — разбивка по битам (длительности, содержание, целевой инструмент)
5. Аудио — закадровый текст / музыка / SFX / тишина (по сценам, если нужно)
6. Результаты — формат файла, разрешение, опциональные альтернативы (вертикальная нарезка, GIF и т. д.)

Покажите бриф пользователю на подтверждение перед тем, как проектировать команду. Бриф — это контракт: на него ссылается каждая последующая задача.

Шаг 3 — Проектирование команды

Подберите архетипы ролей из библиотеки под это видео. Собирайте, а не клонируйте. Большинству видео нужно 4–7 профилей. Режиссёр есть всегда; остальных выбирают по тому, что реально требует бриф.

Библиотеку ролей и составы команд по стилям см. в references/role-archetypes.md.

Сопоставление роль → навыки Hermes + наборы инструментов, которые она загружает, — в references/tool-matrix.md.

Шаг 4 — Настройка

Сгенерируйте setup-скрипт (setup.sh) и запустите его. Скрипт:

1. Создаёт рабочее пространство проекта (~/projects/video-pipeline/<slug>/)
2. Копирует предоставленные ассеты в taste/, audio/, assets/
3. Создаёт каждый профиль Hermes через hermes profile create --clone
4. Пишет для каждого профиля SOUL.md (личность + описание роли)
5. Настраивает YAML профиля (наборы инструментов, навыки always_load, cwd)
6. Пишет brief.md, TEAM.md и содержимое taste/
7. Запускает начальную задачу hermes kanban create, назначенную режиссёру

Используйте scripts/bootstrap_pipeline.py, чтобы сгенерировать setup.sh из брифа + JSON-описания команды. Структуру setup-скрипта, паттерны конфигурации профилей и важнейшее правило «общего рабочего пространства» см. в references/kanban-setup.md.

Шаг 5 — Исполнение

Запустите setup.sh. Затем дайте пользователю команды для мониторинга:

hermes kanban watch --tenant <project-tenant>     # поток событий в реальном времени
hermes kanban list  --tenant <project-tenant>     # снимок доски
hermes dashboard                                   # визуальный интерфейс доски

Дальше управление берёт профиль-режиссёр: он раскладывает работу и маршрутизирует задачи на профили-специалисты через набор инструментов kanban.

Шаг 6 — Мониторинг и вмешательство

Не отключайтесь — kanban работает автономно, но застрявшей задаче или плохому результату нужно человеческое (или ИИ) суждение.

Паттерны мониторинга: периодически опрашивайте kanban list, проверяйте любую RUNNING-задачу, которая превысила ожидаемую длительность, через kanban show <id>, и следите за хартбитами. Когда вывод воркера не проходит ревью, стандартные варианты вмешательства:

1. Прокомментировать задачу воркера конкретной обратной связью (kanban_comment)
2. Создать задачу на перезапуск, указав исходную как родительскую
3. Скорректировать объём в брифе и дать режиссёру переразложить работу

Диагностические паттерны, рецепты вмешательства и плейбук «задача застряла» — в references/monitoring.md.

Справочник: разобранные примеры

Шесть конкретных конвейеров под очень разные стили видео — нарративный фильм, продуктовый/маркетинговый ролик, музыкальный клип, объясняющий ролик про математику/алгоритм, ASCII-видео, инсталляция реального времени — показывают, как один и тот же рабочий процесс даёт очень разные команды и графы задач. См. references/examples.md.

Важнейшие правила

1. Опрос до действий. Никогда не начинайте генерировать бриф или команду, не задав хотя бы три базовых вопроса. Плохой бриф каскадом ломает весь конвейер.

2. Подгоняйте команду под видео. Не переиспользуйте одну и ту же сборку из 4 профилей для каждой задачи. Музыкальный клип без профиля анализа бита даст осечку. Нарративный фильм без профиля сценариста выдаст бессвязные сцены. См. references/role-archetypes.md.

3. Одно рабочее пространство на проект. Все профили одного видео делят одно и то же рабочее пространство dir:. Задачи передают артефакты через общую файловую систему и структурированные передачи артефактов. Каждый вызов kanban_create передаёт workspace_kind="dir" + workspace_path="<absolute project path>".

4. Тенант на каждый проект. Используйте тенант под конкретный проект (--tenant <project-slug>). Так дашборд остаётся в рамках проекта и не перемешивается с другими работающими kanban.

5. Уважайте существующие навыки. Когда сцена укладывается в существующий навык, соответствующий рендерер загружает его через --skill <name> в своей задаче или через always_load в профиле. Не воссоздавайте то, что навык уже предоставляет.

6. Режиссёр никогда не исполняет. Даже с полным набором инструментов kanban + terminal + file правила в SOUL.md режиссёра запрещают ему выполнять работу самому. Он только раскладывает и маршрутизирует — каждая конкретная задача становится вызовом hermes kanban create к профилю-специалисту. Навык kanban-orchestrator разбирает это подробнее.

7. Не перебарщивайте с декомпозицией. 30-секундному продуктовому видео НЕ нужно 20 задач. Стремитесь к наименьшему графу задач, который всё ещё хорошо параллелится и открывает нужные точки человеческого ревью.

8. Проверьте API-ключи ДО запуска. Внешним API (TTS, генерация изображений, image-to-video) нужны ключи в ~/.hermes/.env или в хранилище секретов пользователя. Воркер, наткнувшийся на ошибку отсутствующего ключа, тратит слот задачи впустую. Хелпер check_key в setup-скрипте аккуратно прерывает работу, если обязательный ключ отсутствует.

Карта файлов

SKILL.md                            ← этот файл (процесс + правила)
references/
  intake.md                         ← банки вопросов discovery по стилям
  role-archetypes.md                ← библиотека ролей (сценарист, дизайнер, аниматор, …)
  tool-matrix.md                    ← маппинг навык + набор инструментов по роли
  kanban-setup.md                   ← структура setup-скрипта и конфиги профилей
  monitoring.md                     ← паттерны наблюдения и вмешательства
  examples.md                       ← шесть разобранных конвейеров
assets/
  brief.md.tmpl                     ← шаблон брифа
  setup.sh.tmpl                     ← шаблон setup-скрипта
  soul.md.tmpl                      ← шаблон личности профиля
scripts/
  bootstrap_pipeline.py             ← генерация setup.sh из брифа + JSON команды
  monitor.py                        ← хелперы опроса и вмешательства