🧠 Narrator AI CLI Skill — Научи своего AI-агента создавать видео с нарративом

中文文档

Установи этот скилл в своего AI-агента (OpenClaw, Windsurf, WorkBuddy и др.), затем просто скажи «создай видео с нарративом» — AI сделает всё остальное.

Что это такое?

Машиночитаемый файл скилла (SKILL.md), который обучает AI-агентов использовать инструмент narrator-ai-cli для автоматизированного производства видео с нарративом.

Вы говорите: «Создай видео с нарративом для фильма Пегас в комедийном стиле»

AI выполняет: Поиск фильма → Выбор шаблона → Выбор BGM → Выбор голоса → Генерация сценария → Монтаж видео → Возврат ссылки для скачивания

Как CLI и Skill работают вместе

	CLI (инструмент командной строки)	Skill (описание возможностей)
Что это	Набор исполняемых команд	Инструкции, обучающие AI использовать эти команды
Аналогия	Кухонные инструменты	Книга рецептов
Работает отдельно?	Да, в терминале вручную	Нет, требует CLI

Коротко: CLI — это руки. Skill — это мозг. Вместе AI-агент может производить видео от начала до конца.

Быстрый старт

Шаг 1: Установи CLI-инструмент

bash

pip install "narrator-ai-cli @ git+https://github.com/GridLtd-ProductDev/narrator-ai-cli.git"

Подробные варианты установки см. в репозитории narrator-ai-cli.

Шаг 2: Настрой API-ключ

narrator-ai-cli config set app_key <your_app_key>

📧 Нужен API-ключ? Напиши на merlinyang@gridltd.com или отсканируй QR-код в конце этой страницы.

Шаг 3: Установи скилл

Выбери способ для своей платформы агента:

OpenClaw:

bash

mkdir -p ~/.openclaw/skills/narrator-ai-cli
cp SKILL.md ~/.openclaw/skills/narrator-ai-cli/SKILL.md

WorkBuddy / QClaw (Tencent):

Загрузи SKILL.md через интерфейс управления скиллами.

Windsurf:

cp SKILL.md /path/to/your/project/.skills/narrator-ai-cli/SKILL.md

Claude Code / Cursor:

cp SKILL.md /path/to/your/project/.skills/narrator-ai-cli/SKILL.md

Любой агент, читающий markdown:

cp SKILL.md /path/to/agent/skills/narrator-ai-cli/SKILL.md

💡 Совет: Можно просто передать агенту URL этого репозитория — большинство агентов умеют читать структуру GitHub-репозитория и настраиваться автоматически.

Шаг 4: Начни общаться!

После установки используй естественный язык:

«Создай видео с нарративом для фильма Побег из Шоушенка»
«Покажи, какие фильмы доступны»
«Сделай 5 видео с нарративом для разных боевиков»
«Используй комедийный шаблон и сгенерируй нарратив»

Протестированные платформы

Платформа	Настройка	Статус
OpenClaw	Нативная загрузка скилла	✅ Проверено
Windsurf	Директория `.skills`	✅ Проверено
WorkBuddy (Tencent)	Загрузка `SKILL.md`	✅ Проверено
QClaw (Tencent)	Загрузка `SKILL.md`	✅ Проверено
Youdao Lobster	Загрузка скилла	✅ Проверено
Yuanqi AI	Загрузка скилла	✅ Проверено
Claude Code	`SKILL.md` в корне проекта	✅ Проверено
Cursor	Директория `rules/skills`	✅ Проверено
Любой агент с поддержкой markdown-скиллов	Указать путь к `SKILL.md`	✅ Совместимо

Возможности

Функция	Подробности
Два варианта рабочего процесса	Адаптированный нарратив и оригинальный нарратив
Три режима создания	Горячая драма / Оригинальный микс / Новая драма
Встроенные ресурсы	93 фильма, 146 треков BGM, 63 голоса для озвучки, 90+ шаблонов нарратива
Полный пайплайн	Сценарий → Данные клипов → Монтаж видео → Визуальный шаблон
Отдельные задачи	Клонирование голоса, синтез речи из текста
Маппинг потоков данных	Какой вывод подаётся на какой вход
Обработка ошибок	Все 18 кодов ошибок API с рекомендуемыми действиями
Оценка стоимости	Проверка бюджета перед созданием задачи

Что содержится в SKILL.md

Раздел	Описание
Frontmatter	Метаданные скилла (название, описание, требования)
Архитектура	Структура исходного кода CLI и принятые решения
Основные концепции	Ключевые термины: `file_id`, `task_id`, `order_num` и др.
Варианты рабочего процесса	Два полных пайплайна с пошаговыми командами
Предварительные требования	Как выбирать ресурсы (материалы, BGM, озвучка, шаблоны)
Быстрый путь	Рекомендуемый процесс: поиск → написание → клип → монтаж → магия
Стандартный путь	Полный процесс: изучение → написание → клип → монтаж → магия
Отдельные задачи	Клонирование голоса и TTS
Управление задачами	Запрос, список, бюджет, проверка, сохранение
Файловые операции	Загрузка, скачивание, список, удаление
Обработка ошибок	Все 18 кодов ошибок API с действиями
Поток данных	ASCII-диаграмма полного пайплайна
Важные замечания	9 критических нюансов и лучших практик

Требования

CLI: narrator-ai-cli v0.1.0+
Python: 3.10+
Зависимости: typer, httpx[socks], httpx-sse, pyyaml, rich
API-ключ: свяжитесь с нами для получения

Ссылки

Контакты

Нужен API-ключ или помощь?

📧 Email: merlinyang@gridltd.com
💬 WeChat: отсканируй QR-код ниже

Свяжитесь с нами

Лицензия

MIT

Narrator AI CLI Skill

Установка

README