narrator-ai-cli-skill 快速开始:4步在 Claude / Cursor / OpenClaw 上部署 AI 解说大师
【免费下载链接】narrator-ai-cli-skillAI 解说大师 — Agent skill;封装 narrator-ai-cli 供 Claude/Codex 等工具调用项目地址: https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill
narrator-ai-cli-skill 是「AI 解说大师」的 Agent 技能包:把它装进 Claude Code、Cursor 或 OpenClaw 之后,只需对 AI 说一句"帮我做一个电影解说",它就能自动完成搜片 → 选模板 → 选 BGM → 选配音 → 生成文案 → 合成视频 → 返回下载链接的全流程。本文用 4 个步骤带你完成部署,全程不需要写一行代码。
📦 先认识一下:AI 解说大师由什么组成
这个项目由两部分配合工作:
| 组件 | 角色 | 类比 |
|---|---|---|
| narrator-ai-cli(命令行工具) | 真正执行任务的"手脚" | 一套厨具 |
| narrator-ai-cli-skill(技能描述文件) | 教 AI 如何使用命令的"大脑" | 一本菜谱 |
Skill 本体由 SKILL.md 和 references/ 目录共同组成,两者缺一不可。它教给 AI 的能力包括:
- 🎬两条工作流:原创文案(Fast Path,更快更省)和二创文案(Standard Path,风格更精细)
- 🎞三种创作模式:热门影视 / 原声混剪 / 冷门新剧
- 📚内置资源库:约 100 部电影素材、146 首 BGM、63 个配音角色(11 种语言)、90+ 解说风格模板
- ⚙️独立任务:声音克隆、文本转语音(TTS)
技能元数据(名称、版本、依赖、触发关键词)在 plugin.json 中有完整声明;更详细的中文说明可阅读 README_CN.md。
🛠 部署前检查:系统要求
- Python:3.10+
- CLI 工具:narrator-ai-cli v1.0.0+
- API Key:一个有效的
NARRATOR_APP_KEY(配置命令见下文第 2 步)
第1步:安装 narrator-ai-cli 命令行工具
在终端执行:
pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git"安装完成后,终端里能直接运行narrator-ai-cli相关命令即表示成功。
第2步:配置 API Key
narrator-ai-cli config set app_key 你的API_KeyKey 会保存在~/.narrator-ai/config.yaml,注意不要提交到代码仓库。没有 Key 可通过邮件merlinyang@gridltd.com获取。
配置好之后,用这条命令验证账号与余额:
narrator-ai-cli user balance第3步:把 Skill 装进 Agent 技能目录
Skill 必须保持目录结构:references/需作为子目录与SKILL.md并列,不能平铺或改名,否则文件内的相对路径引用会失效。
小龙虾 OpenClaw:
mkdir -p ~/.openclaw/skills git clone https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill.git ~/.openclaw/skills/narrator-ai-cliWindsurf / Claude Code:
mkdir -p /path/to/your/project/.skills git clone https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill.git /path/to/your/project/.skills/narrator-ai-cliCursor:
mkdir -p /path/to/your/project/.cursor/rules git clone https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill.git /path/to/your/project/.cursor/rules/narrator-ai-cli💡升级技巧:后续更新只需在 clone 目录下执行
git pull即可。📌WorkBuddy / QClaw(腾讯系):在技能管理界面上传
SKILL.md和完整的references/目录,务必保持原有目录结构。
第4步:开口对话,生成你的第一条解说视频
安装完成后,直接用自然语言下指令即可:
- 「帮我做一个飞驰人生的电影解说视频,喜剧风格」
- 「查看有哪些内置电影素材」
- 「用热血动作风格做一个解说视频」
- 「帮我做 5 条不同电影的解说视频」
AI 会按 SKILL.md 中定义的决策顺序一步步引导你:先确认影片素材(内置约 100 部电影,大多数情况无需上传),再询问工作流路线,最后依次确认 BGM、配音和解说模板——每样资源都会等你确认后才使用,不会擅自替你选择。
🔍 进阶:让 Agent 跑得更稳
references/目录是技能"大脑"的详细资料,AI 会在需要时自动查阅,你也可以翻阅学习:
| 文件 | 内容 |
|---|---|
| references/resources.md | 素材、BGM、配音、模板的查询命令与字段说明 |
| references/workflows.md | 两条工作流的完整步骤与参数表 |
| references/operations.md | 任务轮询、文件操作、18 个 API 错误码 |
| references/magic-video.md | 可选的视觉模板(字幕样式、品牌版式)说明 |
两个实用命令值得了解:task verify可在创建任务前校验素材是否齐全;task budget可预估积分消耗,避免意外花费。
❓ 常见问题
部署到哪些平台已验证?OpenClaw、WorkBuddy、QClaw、Windsurf、有道龙虾、元气 AI、Claude Code、Cursor 均已验证 ✅,其他支持 Markdown 技能文件的 Agent 也可兼容使用。
技能升级了怎么办?在 clone 目录里执行git pull即可。
为什么不能只上传 SKILL.md?因为SKILL.md中的详细查阅表都通过相对路径指向references/下的四个文件,缺少它们 AI 就无法完成参数构造。
写在最后
总结一下 AI 解说大师的快速部署路径:
pip安装 narrator-ai-cli- 配置 API Key 并用
user balance验证 git clone技能仓库到对应 Agent 的技能目录- 用一句自然语言,收获一条完整的电影解说视频 🎬
从装好到出片,你只需要会说"帮我做一个电影解说"这一句话。
【免费下载链接】narrator-ai-cli-skillAI 解说大师 — Agent skill;封装 narrator-ai-cli 供 Claude/Codex 等工具调用项目地址: https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考