Narrator AI 解说技能包
让 AI 代理一键生成影视解说视频的技能包
- Star 数
- ★ 3.1k
- 最近更新
- 3 个月前
- License
- MIT
- FA 评分
- 51/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 内容创作者想批量生成热门剧集解说视频，只需告诉代理'给《肖申克的救赎》做一个解说'，代理自动完成选片、配乐、配音和合成。
- 不适合
- 不愿申请 API key 或联系邮箱审批的个人用户
- 希望脱离 narrator-ai-cli 独立使用的用户，技能本身无法单独运行
- 源码审查
- 51/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Narrator AI CLI Skill 是一个机器可读的技能包（SKILL.md），教 AI 代理（如 OpenClaw、Windsurf、Claude Code 等）如何使用 narrator-ai-cli 命令行工具自动完成影视解说视频从脚本到成片的全流程。它封装了工具的操作指南、资源查找表、工作流路径、错误处理和成本估算，使代理通过自然语言指令即可驱动视频创作。它依赖 narrator-ai-cli v1.0.0+ 和 Python 3.10+，需要申请 API key 才能调用后端服务。目前已在 OpenClaw、Windsurf、WorkBuddy 等 8 个平台验证可用。该技能包本身不包含视频生成引擎，而是充当'配方书'来教会 AI '厨具'（CLI）的使用方法。
读取 SKILL.md 和 references/ 目录中的资源表、工作流和操作规则，通过调用 narrator-ai-cli 执行一系列命令来完成影视解说视频制作：从可用电影库中选择电影、挑选 BGM、配音音色和模板，生成解说脚本，合成视频，并返回下载链接。它支持两条工作流路径（适配解说和原创解说）和三种创作模式（热剧、原创混剪、新剧），并能执行独立的语音克隆和文本转语音任务。代理需要按照 Agent Rules 操作：执行前确认、语言链应遵循、轮询任务状态等。所有操作通过 CLI 与远程 API 交互，输出为视频文件和文件 ID。
- 内容创作者想批量生成热门剧集解说视频，只需告诉代理'给《肖申克的救赎》做一个解说'，代理自动完成选片、配乐、配音和合成。
- 短视频运营者需要为不同动作片生成差异化风格的解说，通过自然语言指定喜剧风格模板，代理会选择合适的资源并产出多个视频。
- 个人开发者在 OpenClaw 中配置该技能，用语音命令触发视频创作流程，简化手动操作。
- 教育者用原创解说模式制作历史或文学作品的解读视频，利用内置的 90+ 模板和 63 种配音。
- 需要语音克隆或文本转语音的用户，代理可直接调用 narrator-ai-cli 的独立任务完成定制化配音。
如何安装或部署这个 Agent？
- 安装 CLI: pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git"
- 配置 API key: narrator-ai-cli config set app_key <your_app_key>（需要联系 [email protected] 获取）
- 克隆技能仓库到代理的技能目录。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: 克隆到项目 .skills 目录；Cursor: .cursor/rules；其他 markdown 代理可任意指定路径。
WorkBuddy/QClaw 通过 UI 上传 SKILL.md 和 references/ 文件夹，保持结构。
如何使用这个 Agent？
安装完成后，在支持的代理平台中用自然语言下达指令，例如：
"Create a narration video for The Shawshank Redemption"（为《肖申克的救赎》创建一个解说视频）。
代理会按照 SKILL.md 中的流程执行：搜索电影、选择模板、选 BGM、选配音、生成脚本、合成视频并返回下载链接。也可查询可用电影（"Show me what movies are available"）或批量创建（"Make 5 narration videos for different action movies"）。需要确保已安装 CLI 并配置好 API key。
这个 Agent 有哪些优点和局限？
- 提供了完整的端到端视频创作流程，从脚本到成片代理都能自动完成，无需手动干预。
- 内置丰富的资源：约 100 部电影、146 首 BGM、63 种配音音色、90+ 解说模板。
- 覆盖 8 个主流代理平台，包括 OpenClaw、Windsurf、Claude Code、Cursor 等，兼容性广。
- 详细的错误处理机制，列出了全部 18 个 API 错误码及建议操作，便于排查问题。
- 必须依赖于 narrator-ai-cli 工具和后端 API，需要申请 API key，并且需要 Python 3.10+ 环境。
- 技能包仅包含指令和文档，不包含视频生成引擎，无法独立工作，必须配合 CLI 使用。
- API key 的获取需要联系特定邮箱，可能存在审批流程或商业成本。
- 实际效果受限于 narrator-ai-cli 的后端服务质量和稳定性，可能存在供应商锁定。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Narrator AI 解说技能包 当前 | 51 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 3.1k | 3 个月前 | — | Codex · Claude Code |
| ClawMetry | 81 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 432 | 1 天前 | Python | Codex · Claude Code |
| OpenClaw 大师技能库 | 12 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 2.2k | 3 个月前 | Python | — |
| SkillHub | 56 · 缺口较多 | 自托管服务免费 | ★ 5.2k | 今天 | Java | Codex |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：SKILL.md 要求代理在执行前确认（user_confirmation 2），并提供了数据流映射和隐私说明（data_flow_transparency 2）。但未提供最小权限原则的明确说明，API 密钥处理仅提及范围，未详细说明存储和传输（least_privilege 1, sensitive_data_handling 1）。依赖安全性仅列出依赖名称，未提供版本锁定或漏洞扫描（dependency_security 1）。外部效果方面，技能会调用外部 API 创建视频，但未说明副作用或资源消耗（external_effects 1）。回滚方面，未提供撤销或恢复机制（rollback 1）。来源归属方面，未提供作者或维护者信息，仅有一个联系邮箱（source_attribution 1）。
证据显示：README 和 SKILL.md 内容一致，工作流描述清晰（self_consistency 2）。依赖可用性方面，依赖列表明确，但未提供版本锁定或镜像（dependency_availability 1）。失败消息方面，SKILL.md 提到错误处理，但未提供具体错误消息示例（failure_messages 2）。
证据显示：README 列出了多种平台和场景（audience_and_scenarios 2），能力边界在 SKILL.md 中有说明（capability_boundaries 2），触发词和示例明确（trigger_precision 2），环境适配性良好（environment_fit 2）。
证据显示：信息架构清晰，有目录和索引（information_architecture 2），安装说明详细（install_notes 2），命名稳定（naming_stability 1），示例和 FAQ 存在（examples_and_faq 2），已知限制部分提及（known_limitations 1），MIT 许可证明确（license 2），版本和变更日志缺失（versioning_changelog 1），维护责任未明确（maintenance_responsibility 1）。
证据显示：输出可用性高，提供下载链接（output_usability 2），边际价值高，自动化视频制作（marginal_value 2），成本效益方面，需要 API 密钥，但未提供定价信息（cost_benefit 1）。
证据显示：声明有部分支持，但未提供测试或验证（claim_traceability 1），跨来源验证不足（cross_source_corroboration 1），事实与推断分离不明确（fact_inference_separation 1）。
- API 密钥处理细节不足，建议明确存储和传输方式。
- 依赖未锁定版本，存在供应链风险。
- 未提供回滚机制，操作失败后难以恢复。
- 未提供版本和变更日志，维护性差。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v1.0.0 v1.0.0 - Initial Release
发布说明摘录
narrator-ai-cli-skill v1.0.0 Agent Skill (SKILL.md) for narrator-ai-cli video narration pipeline. Verified Platforms OpenClaw, Windsurf, WorkBuddy, QClaw, Claude Code, Cursor, Youdao Lobster, Yuanqi AI Install Copy SKILL.md to your agent’s skills directory, or point your agent to this repo URL.在 GitHub 查看 ↗