企业官网建设流程全解析

narrator-ai-cli-skill 多平台部署清单：OpenClaw、WorkBuddy、有道龙虾等 8 种安装方式全解析

【免费下载链接】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 技能包，封装 narrator-ai-cli 命令行工具，让 OpenClaw、WorkBuddy、Claude Code 等 AI 助手学会自动制作电影/短剧解说视频：说一句「帮我做一个飞驰人生的解说」，AI 就会自动完成搜片、选模板、选 BGM、选配音、生成文案到合成视频的完整流程。本文为你梳理部署前的准备工作，并逐一解析 8 种平台的安装方式。

一、先搞懂：Skill 和 CLI 是什么关系

一句话记住：CLI 是手脚，Skill 是大脑🧠

安装好 Skill 后，你的 AI Agent 就能端到端地帮你产出解说视频。

二、部署前准备：3 个通用前置步骤

无论部署到哪个平台，以下 3 步都需要先完成：

1. 安装 CLI 工具：按 README.md 中 Quick Start 的说明，用 pip 安装narrator-ai-cli（要求 Python 3.10+）。
2. 配置 API Key：

narrator-ai-cli config set app_key 你的API_Key

3. 验证环境：运行narrator-ai-cli user balance查询积分余额，能正常返回即说明 CLI + Key 都配置成功。

⚠️最容易踩的坑：Skill 由 SKILL.md和references/目录共同组成，两者缺一不可。且references/必须作为子目录与SKILL.md并列，不能把文件平铺或改名，否则SKILL.md里的相对路径引用会全部失效。

三、8 种安装方式总览

官方已验证的部署方式一览：

下面逐一解析每种方式的具体操作。

四、方式 1：OpenClaw 一键部署（克隆到技能目录）

OpenClaw 是小龙虾 🦞 Agent，直接克隆到它的技能目录即可：

mkdir -p ~/.openclaw/skills git clone https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill \ ~/.openclaw/skills/narrator-ai-cli

OpenClaw 的优势在于：SKILL.md的 frontmatter 和 plugin.json 中已声明了依赖项，OpenClaw 可以自动通过 pip 安装narrator-ai-cli并识别所需的环境变量NARRATOR_APP_KEY，部署体验最省心。

五、方式 2：WorkBuddy 技能上传（腾讯系）

WorkBuddy 不支持直接 clone，需要在技能管理界面上传：

1. 上传 SKILL.md 文件；
2. 上传完整的references/目录（含 resources.md、workflows.md、magic-video.md、operations.md 四个文件）；
3. 保持目录结构不变：references/必须作为子文件夹与SKILL.md并列，严禁将 4 个 md 文件平铺上传。

六、方式 3：QClaw 技能上传（腾讯系）

QClaw 与 WorkBuddy 属于同一体系，操作完全相同：上传SKILL.md+ 整个references/目录，并保持子目录结构。如果团队同时在两个平台部署，上传一次即可复用。

七、方式 4：有道龙虾部署

有道龙虾同样使用「克隆到技能目录」的方式，目录结构与 OpenClaw 类似：

mkdir -p /path/to/youdao/lobster/skills git clone https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill \ /path/to/youdao/lobster/skills/narrator-ai-cli

路径请以有道龙虾实际文档中的技能目录为准，克隆后的文件夹名建议保持narrator-ai-cli。

八、方式 5：Windsurf 安装（项目级 .skills 目录）

Windsurf 的技能是项目级的，克隆到你正在使用的项目内：

mkdir -p /path/to/your/project/.skills git clone https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill \ /path/to/your/project/.skills/narrator-ai-cli

这样该项目下的 Windsurf 会话就能调用 AI 解说大师技能。

九、方式 6：Claude Code 部署（.skills 目录）

Claude Code 与 Windsurf 共用同一套.skills目录约定：

mkdir -p /path/to/your/project/.skills git clone https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill \ /path/to/your/project/.skills/narrator-ai-cli

十、方式 7：Cursor 部署（.cursor/rules 目录）

Cursor 使用规则（rules）机制，把技能克隆到项目的.cursor/rules目录：

mkdir -p /path/to/your/project/.cursor/rules git clone https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill \ /path/to/your/project/.cursor/rules/narrator-ai-cli

十一、方式 8：元气 AI 及通用 Markdown Agent

元气 AI 采用与 OpenClaw 相同的克隆方式；而任何能读取 Markdown 技能文件的 Agent都兼容——只要把仓库 clone 到该 Agent 的技能目录，并让它指向SKILL.md即可：

mkdir -p /path/to/agent/skills git clone https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill \ /path/to/agent/skills/narrator-ai-cli

十二、部署完成：验证与开始使用

升级 Skill：后续更新只需在克隆目录里执行git pull。

开始对话：安装完成后直接用自然语言下达指令，例如：

• 「帮我做一个飞驰人生的电影解说视频，喜剧风格」
• 「查看有哪些内置电影素材」
• 「用热血动作风格做一个解说视频」
• 「帮我做 5 条不同电影的解说视频」

这个 Skill 内置了丰富资源：约100 部电影素材（视频 + 字幕现成，大多无需自己上传）、146 首 BGM、63 个配音音色、90+ 解说风格模板，支持原创文案（Fast Path）与二创文案（Standard Path）两条流水线，还附带声音克隆、文本转语音等独立任务能力。

十三、部署常见问题速查

十四、相关文档资源

部署完成后，建议了解这些项目文件（均在仓库根目录）：

• SKILL.md — 技能主文件：决策流程、Agent 规则、双工作流
• references/resources.md — 素材 / BGM / 配音 / 模板的查询命令
• references/workflows.md — 两条流水线完整步骤与参数表
• references/magic-video.md — 可选的视觉模板（Magic Video）说明
• references/operations.md — 任务轮询、文件操作与错误码速查
• README_CN.md — 中文说明文档

按以上清单完成部署后，你的 AI Agent 就正式成为「AI 解说大师」了 🎬

【免费下载链接】narrator-ai-cli-skillAI 解说大师 — Agent skill；封装 narrator-ai-cli 供 Claude/Codex 等工具调用项目地址: https://gitcode.com/gh_mirrors/na/narrator-ai-cli-skill