AIBit-Discover Open Source Projects AIBit-Discover Open Source Projects

Narrator AI CLI Skill：让 AI Agent 自动生成电影解说视频

Narrator AI CLI Skill 将电影搜索、脚本生成、配音、配乐和视频合成为可调用的 Agent 工作流。

Narrator AI CLI Skill：让 AI Agent 自动生成电影解说视频

制作一条电影解说视频，通常需要完成电影素材搜索、模板选择、文案撰写、配音、背景音乐、视频剪辑和成片导出等多个环节。对于开发者来说，真正麻烦的并不是单独执行某一步，而是把这些步骤稳定地串成一条可重复、可自动化的流水线。

NarratorAI-Studio/narrator-ai-cli-skill 提供了一种面向 AI Agent 的解决方案：它通过 SKILL.md 和 references/ 中的机器可读说明，把 narrator-ai-cli 的能力暴露给 OpenClaw、Claude Code、Cursor、Windsurf、WorkBuddy 等工具。安装完成后，用户可以直接用自然语言提出需求，由 Agent 负责调用命令行工具并完成端到端的视频制作。

它解决的是什么问题？

这个项目并不是另一个独立的视频编辑器，而是 Agent 与 CLI 之间的适配层。

  • CLI 是执行层：提供可运行的命令，用于搜索资源、生成脚本、创建任务和合成视频。
  • Skill 是决策层：告诉 Agent 每个命令应该什么时候使用、参数如何传递、前一步的输出如何成为下一步的输入，以及失败时应该如何处理。

可以把两者理解成厨房工具和菜谱：只有工具，Agent 不知道正确的操作顺序；只有菜谱，没有 CLI 也无法真正执行。两者组合后，Agent 才能把“做一条电影解说视频”转化为一系列可靠的 API 和任务调用。

典型请求可以非常简单：

Create a narration video for The Shawshank Redemption in a comedy style.

Agent 会尝试完成以下流程：搜索电影、选择解说模板、选择背景音乐和声音、生成脚本、合成视频，最后返回下载链接。

快速安装

1. 安装 CLI

项目要求使用 narrator-ai-cli 1.0.0 或更高版本。可以直接从 Git 仓库安装：

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

同时需要 Python 3.10+，以及以下依赖：

  • typer
  • httpx[socks]
  • httpx-sse
  • pyyaml
  • rich

2. 配置 API Key

安装后，将应用密钥写入 CLI 配置：

narrator-ai-cli config set app_key <your_app_key>

也可以按照 Agent 环境的要求配置 NARRATOR_APP_KEY。API Key 需要联系项目维护者获取，仓库 README 提供了邮箱和微信联系方式。

3. 安装 Skill

Skill 不能只复制单个 SKILL.md 文件。references/ 目录包含资源表、工作流说明、操作指南和视频能力相关文档，必须与 SKILL.md 一起保留。

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 Skill 的 Agent，也可以将仓库克隆到其 skills 目录，并让 Agent 指向 SKILL.md。WorkBuddy 和 QClaw 则需要通过技能管理界面上传 SKILL.md 以及完整的 references/ 文件夹，不能把引用文件扁平化到同一层级。

更新时，进入克隆目录执行：

git pull

安装后可以做什么？

完成配置后，可以直接用自然语言发起任务，例如：

Create a narration video for The Shawshank Redemption

Show me what movies are available

Make 5 narration videos for different action movies

Use a comedy template and generate a narration

对于批量任务，Skill 的价值尤其明显：Agent 可以重复执行资源选择、脚本生成和合成步骤，而不是要求用户手动复制每个任务的参数。

两条核心工作流

Skill 将创作流程分成两种路径：

Fast Path：Original Narration

适用于从头创作原创解说内容。Agent 通常需要根据主题或影片生成新的叙事脚本，然后完成配音、配乐和视频合成。该路径更适合原创混剪、新剧情或风格化表达。

Standard Path：Adapted Narration

适用于基于现有电影或素材进行改编解说。Agent 会先查找可用电影和素材，再根据选定模板生成解说内容，最后进入视频制作流程。

仓库的 SKILL.md 对两条路径的步骤、参数和输出关系进行了明确说明，并特别强调了 Fast Path 视频合成参数和路径选择等容易出错的细节。

内置资源和能力

项目提供了一套相对完整的内容生产资源：

  • 约 100 部电影
  • 146 条背景音乐
  • 63 种配音声音
  • 90 多个解说模板
  • Hot Drama、Original Mix、New Drama 三种创作模式
  • 适配解说和原创解说两种工作流
  • 脚本生成、片段数据生成、视频合成和视觉模板选择
  • 声音克隆和文本转语音等独立任务

这意味着 Agent 不只是“调用一个生成视频接口”，而是可以在资源选择阶段遵循明确规则。例如，先确定解说类型，再选择合适的模板和声音，检查预算，创建任务，轮询任务状态，最后处理视频文件或下载链接。

Skill.md 为什么重要？

SKILL.md 是整个项目的核心。它不仅描述了命令名称，还定义了 Agent 应该如何思考和执行任务，主要包括：

  • Skill 元数据和运行要求
  • references/ 文件索引
  • Fast Path 与 Standard Path 的流水线图
  • 执行前确认规则
  • 语言处理链和任务轮询模式
  • file_id、task_id、task_order_num 等核心概念
  • 会话启动和需求判断流程
  • 背景音乐、配音和模板的选择顺序
  • 独立的声音克隆与 TTS 流程
  • 18 种 API 错误码及对应处理建议
  • 创建任务前的成本估算和预算校验
  • 文件处理、API 地址和凭证范围等隐私注意事项

对开发者而言，这种结构比把一堆命令简单塞进 Agent 上下文更可靠。明确的数据流可以减少“上一步输出没有传给下一步”的问题，而错误处理规则则能让 Agent 在任务失败时采取可预测的行动，而不是盲目重试。

一次可靠执行应关注什么？

视频生成通常是异步任务，因此调用创建接口并不代表视频已经完成。一个健壮的 Agent 工作流应当：

  1. 确认用户的影片、风格、语言和数量要求。
  2. 根据任务类型选择 Fast Path 或 Standard Path。
  3. 查询可用的电影、模板、配音和 BGM。
  4. 在创建任务前估算成本并确认预算。
  5. 保存 file_id、task_id 等关键标识符。
  6. 按规定间隔轮询任务状态，而不是持续高频请求。
  7. 根据 API 错误码采取修正、重试或人工确认。
  8. 在任务完成后返回视频文件或下载链接。

这套规则对于批量生成尤其重要，因为多个视频任务可能同时排队，任何一个中间标识符丢失，都可能导致后续合成无法继续。

平台兼容性

仓库已验证或声明兼容的平台包括：

  • OpenClaw
  • Windsurf
  • WorkBuddy
  • QClaw
  • Youdao Lobster
  • Yuanqi AI
  • Claude Code
  • Cursor
  • 其他能够读取 Markdown Skill 的 Agent

不同平台的安装位置不同，但核心原则一致：让 Agent 能找到 SKILL.md，并保持 references/ 的相对目录结构不变。

适合哪些场景？

Narrator AI CLI Skill 特别适合以下开发和内容生产场景：

  • 构建自动化电影解说账号
  • 批量生成不同风格的短视频
  • 在 Agent 中加入视频制作能力
  • 验证多步骤媒体 API 工作流
  • 将命令行工具接入 Claude Code 或 OpenClaw
  • 把声音克隆、TTS 和视频合成整合到同一套流程

它也适合作为一个 Agent Skill 的工程案例：将工具能力、资源索引、参数说明、错误处理和安全注意事项拆分为可维护的文档层，而不是把所有逻辑写进单一提示词。

总结

Narrator AI CLI Skill 的核心价值，在于把复杂的视频制作 API 组织成 Agent 可以理解和执行的工作流。narrator-ai-cli 负责真正执行，SKILL.md 负责提供上下文、决策规则和数据流说明，二者结合后，用户只需描述目标，Agent 就能完成从素材选择到成片输出的多步骤任务。

项目采用 MIT License，当前提供 v1.0.0 初始版本。对于希望让 Claude Code、OpenClaw、Cursor 或其他 Markdown 驱动 Agent 具备视频创作能力的开发者来说，这是一个值得研究和试用的开源集成方案。

Source

NarratorAI-Studio/narrator-ai-cli-skill: AI 解说大师 — Agent skill；封装 narrator-ai-cli 供 Claude/Codex 等工具调用