“narrator-ai-cli-skill”是一个专门为AI智能体（Agent）设计的技能包，它的核心作用是教会AI助手如何使用“narrator-ai-cli”这个命令行工具，从而全自动地创作电影解说视频。

简单来说，它解决的是“让AI自己学会用专业工具”的问题。

🧠 项目核心概念：CLI工具 + AI技能

这个项目由两部分组成，协同工作：

组成部分 作用 类比
narrator-ai-cli (命令行工具) 实际执行视频制作任务的“双手”，包含所有底层命令。 厨房里的各种工具（刀、锅等）
narrator-ai-cli-skill (AI技能包) 指导AI如何使用工具的“大脑”，是一份机器可读的指令手册（SKILL.md）。 食谱和烹饪教程

安装了技能后，你只需用自然语言向AI下达指令（如“为《肖申克的救赎》创作一个喜剧风格的解说视频”），AI就会自动按照技能中的规则，调用CLI工具完成搜索、选模板、配音、合成、提供下载链接等一系列操作。

🚀 核心工作流程与能力

该技能为AI定义了两种主要的工作路径：

  1. 快速路径（原创解说）：适用于基于现有电影解说稿或创意直接生成视频。
  2. 标准路径（改编解说）：适用于基于已有视频或素材进行改编。

内置资源丰富：技能包内含对大量预设资源的调用指引，包括约100部电影、146首背景音乐、63种配音声音和90多种解说模板。

⚙️ 如何安装与使用

安装过程分为三步：

  1. 安装CLI工具：在终端执行 pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git"。
  2. 配置API密钥：执行 narrator-ai-cli config set app_key <你的密钥>。需要提前通过邮箱 merlinyang@gridltd.com 或微信联系开发者获取。
  3. 安装技能到你的AI平台：将本项目克隆到你的AI智能体（如OpenClaw、Windsurf、Claude Code等）指定的技能目录下。

该项目已在OpenClaw、Windsurf、Claude Code、Cursor等多个主流AI智能体平台上验证通过。

⚠️ 重要注意事项

  • 环境依赖：需要Python 3.10+，并确保CLI工具版本为v1.0.0+。
  • AI规则：技能中设定了强制AI遵守的规则，例如在执行关键操作前必须向用户确认，以及处理18种API错误码的指引。
  • 隐私与数据：技能描述中说明了API端点、文件处理方式和凭证作用范围。

💎 总结

narrator-ai-cli-skill 是一个精巧的“AI能力扩展包”，它通过结构化的指令，让通用的AI助手瞬间变成了一个专业的短视频解说导演。如果你正在使用支持Skill的AI智能体，并且有批量、自动化生成电影解说视频的需求，这个项目可以大大降低操作门槛和重复劳动。

需要注意的是，它的核心功能依赖于后端的CLI工具和API服务，因此获取有效的API密钥是使用的前提。如果在安装到特定AI平台时遇到问题，可以查阅项目README中针对不同平台的详细安装示例。