小马的 AI 工具集 给 Agent 学习

影视解说

教 AI Agent 调用 narrator-ai-cli，一句话自动生成电影解说视频

影视解说
类型 技能 1,311 星标 更新 2026-06-03 许可 MIT 原仓库

在 AI 助手（OpenClaw、Windsurf、WorkBuddy 等）中安装此 Skill，只需说“创建一个电影解说视频”——AI 会自动处理余下工作。

这是什么？

一份机器可读的技能文件（SKILL.md），用于教会 AI 助手如何使用 narrator-ai-cli 工具自动制作视频解说。

你说：“用喜剧风格创建一个关于《飞马》的解说视频”

AI 执行：搜索电影 → 选择模板 → 选择 BGM → 挑选配音 → 生成脚本 → 合成视频 → 返回下载链接

CLI 与 Skill 如何协同工作

CLI（命令行工具）Skill（能力描述）
是什么一组可执行的命令教会 AI 如何使用这些命令的指令
类比厨房工具菜谱
单独工作？可以，在终端里手动操作不行，需要 CLI

简单来说：CLI 是双手。Skill 是大脑。 二者配合，AI 助手就能端到端地制作视频。

快速开始

第一步：安装 CLI 工具

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

详细安装选项请参阅 narrator-ai-cli。

第二步：配置 API 密钥

narrator-ai-cli config set app_key <your_app_key>

📧 需要一个 API 密钥？请发送邮件至 merlinyang@gridltd.com 或扫描本页底部的二维码。

第三步：安装 Skill

Skill 包含 SKILL.md 和 references/ 目录——两者缺一不可。将仓库直接克隆到 AI 助手的技能文件夹中：

OpenClaw：

mkdir -p ~/.openclaw/skills
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  ~/.openclaw/skills/narrator-ai-cli

Windsurf / Claude Code：

mkdir -p /path/to/your/project/.skills
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  /path/to/your/project/.skills/narrator-ai-cli

Cursor：

mkdir -p /path/to/your/project/.cursor/rules
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  /path/to/your/project/.cursor/rules/narrator-ai-cli

任何支持 Markdown 的 AI 助手：

mkdir -p /path/to/agent/skills
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git \
  /path/to/agent/skills/narrator-ai-cli

WorkBuddy / QClaw（腾讯）：

通过技能管理界面上传 SKILL.md 和整个 references/ 文件夹，保持目录结构不变（references/ 必须作为 SKILL.md 的子文件夹存在——不要展平文件）。

💡 提示：要后续更新 Skill，只需在克隆的目录中运行 git pull 即可。

第四步：开始对话！

安装完成后，使用自然语言即可：

  • “创建一个《肖申克的救赎》的解说视频”
  • “显示有哪些电影可用”
  • “为不同的动作电影制作 5 个解说视频”
  • “使用喜剧模板并生成一个解说”

已测试平台

平台配置方式状态
OpenClawgit clone 到技能目录✅ 已验证
Windsurfgit clone 到 .skills 目录✅ 已验证
WorkBuddy（腾讯）上传 SKILL.md + references/ 下所有文件✅ 已验证
QClaw（腾讯）上传 SKILL.md + references/ 下所有文件✅ 已验证
有道 Lobstergit clone 到技能目录✅ 已验证
元气 AIgit clone 到技能目录✅ 已验证
Claude Codegit clone 到项目 .skills 目录✅ 已验证
Cursorgit clone 到 .cursor/rules 目录✅ 已验证
任何支持 Markdown 技能的 AI 助手git clone 仓库，让 AI 指向 SKILL.md✅ 兼容

能力范围

特性详情
两种工作流程路径改编解说与原创解说
三种创作模式热门剧集 / 原创混剪 / 新剧集
内置资源约 100 部电影、146 首 BGM、63 种配音音色、90+ 解说模板
完整流程脚本 → 剪辑数据 → 视频合成 → 视觉模板
独立任务声音克隆、文字转语音
数据流向映射哪个输出作为哪个输入
错误处理全部 18 种 API 错误码及推荐操作
费用预估任务创建前的预算检查

SKILL.md 包含内容

章节描述
前言Skill 元数据（名称、描述、依赖）
参考索引指向 references/ 中详细查询表的指针（资源、工作流、魔法视频、操作）
流程概览Fast Path 和 Standard Path 的 ASCII 图
AI 规则强制性规则：执行前确认、语言链、轮询模式等
前置条件假设已安装 narrator-ai-cli 并设置了 NARRATOR_APP_KEY
核心概念关键术语：file_id、task_id、task_order_num 等
对话启动如何开始会话及决策顺序
两种工作流路径Fast Path（原创解说） vs Standard Path（改编解说）
资源选择协议BGM、配音、模板的选择顺序和规则
Fast Path步骤 0–4 及参数说明
Standard Path步骤 0–5 及参数说明
独立任务声音克隆和 TTS
重要提示7 个关键注意事项和最佳实践
数据与隐私API 端点、文件处理、凭据范围

要求

  • CLI：narrator-ai-cli v1.0.0 或更高版本
  • Python：3.10 或更高版本
  • 依赖：typer、httpx[socks]、httpx-sse、pyyaml、rich
  • API 密钥：联系我们获取

链接

联系方式

需要 API 密钥或帮助？

联系我们

许可证

在 GitHub 查看完整项目