Narrator AI CLI Skill 详细部署教程

Narrator AI CLI Skill 是一个 AI 代理技能包，它能教会 Claude、OpenClaw、Windsurf 等 AI 编程助手使用 narrator-ai-cli 工具，从而自动完成电影解说视频的创作。您只需要用自然语言提出需求，AI 就能处理从搜索电影、选择模板到生成视频的全流程。

本教程将指导您完成 CLI 工具和 Skill 的安装与配置。

1. 准备工作

在开始前，请确保您满足以下条件：

1.1 环境要求

  • Python：版本 3.10 或更高。
  • AI 代理平台：已安装并配置好以下任一平台，或类似的支持 Skills 的代理：
    • OpenClaw
    • Windsurf
    • Claude Code
    • Cursor
    • WorkBuddy / QClaw (腾讯)
    • Youdao Lobster / Yuanqi AI
  • API 密钥：需要有效的 Narrator AI API 密钥。您可以通过邮件 merlinyang@gridltd.com 联系获取。

1.2 理解核心组件

  • CLI 工具 (narrator-ai-cli)：实际的命令行工具，负责与 Narrator AI 服务交互、执行任务。
  • Skill 文件 (SKILL.md + references/ 目录)：指导 AI 代理如何正确使用 CLI 工具的指令集和资源参考表。

2. 安装 CLI 工具

首先需要在您的系统中安装 narrator-ai-cli 命令行工具。

2.1 通过 pip 安装

在终端中执行以下命令：

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

此命令会从 GitHub 仓库直接安装最新版本的 CLI。

2.2 验证安装

安装完成后，可以运行以下命令检查是否成功：

1
narrator-ai-cli --help

如果显示帮助信息，则说明安装成功。

3. 配置 API 密钥

CLI 工具需要配置 API 密钥才能与后端服务通信。

3.1 设置密钥

使用以下命令配置您的 API 密钥：

1
narrator-ai-cli config set app_key <您的API密钥>

将 <您的API密钥> 替换为您获取到的实际密钥。

3.2 验证配置

您可以随时查看当前配置：

1
narrator-ai-cli config show

4. 安装 Skill 文件

Skill 由 SKILL.md 文件和 references/ 目录组成，两者必须一起安装。

4.1 克隆 Skill 仓库

选择您使用的 AI 代理平台对应的 Skills 目录，将仓库克隆进去。

对于 OpenClaw：

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

对于 Windsurf 或 Claude Code：

1
2
3
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：

1
2
3
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

对于 WorkBuddy / QClaw (腾讯平台)：
需要通过平台的技能管理界面上传 SKILL.md 和整个 references/ 文件夹，并保持 references/ 作为 SKILL.md 的同级子目录，不要打散文件。

4.2 更新 Skill

当 Skill 有更新时，进入克隆的目录执行 git pull 即可更新到最新版本。

5. 使用 Skill

安装并配置完成后，您就可以在 AI 代理中使用自然语言来创建解说视频了。

5.1 典型对话示例

  • 基础创建："为《肖申克的救赎》创建一个解说视频"
  • 指定风格："用喜剧模板为《哪吒之魔童降世》生成解说"
  • 批量操作："为三部不同的动作片创建解说视频"
  • 查看资源："显示有哪些可用的电影"

5.2 Skill 的工作流程

AI 代理会按照 SKILL.md 中定义的规则自动执行以下步骤：

  1. 理解意图：解析您的自然语言指令。
  2. 选择资源：根据指令选择电影、解说模板、背景音乐 (BGM) 和配音员。
  3. 生成脚本：调用 CLI 工具生成解说词。
  4. 合成视频：组合所有素材，合成最终视频。
  5. 返回结果：向您提供视频的下载链接或文件路径。

6. 故障排查

  • CLI 命令未找到：确保 narrator-ai-cli 已正确安装，并且其安装路径已添加到系统的 PATH 环境变量中。
  • API 密钥无效或未设置：请使用 narrator-ai-cli config set app_key 重新设置正确的密钥。
  • AI 代理无法识别 Skill：
    • 确认您已将完整的 Skill 仓库（包含 SKILL.md 和 references/ 目录）克隆到了您的 AI 代理指定的正确 Skills 路径下。
    • 对于需要手动上传的平台（如 WorkBuddy），请确保 references/ 目录结构未被破坏。
  • 任务执行失败：查看 AI 代理输出的详细日志。它通常会包含 CLI 工具返回的错误代码和信息，您可以参考 Skill 文档中关于错误处理的说明进行排查。

总结

通过以上步骤，您就完成了 Narrator AI CLI Skill 的部署。它的核心价值在于将复杂的视频制作流程封装成一套清晰的指令，让 AI 代理能够作为您的“智能助理”来执行。您只需专注于提供创意和需求，具体的资源选择、脚本生成和视频合成工作都由 AI 和 CLI 工具协作完成。部署成功后，您就可以在自己的 AI 代理中像使用任何其他能力一样，轻松地召唤出这个“AI 解说大师”了。