Narrator AI 解说技能包
让 AI 代理一键生成影视解说视频的技能包
证据显示：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 密钥处理细节不足，建议明确存储和传输方式。
- 依赖未锁定版本，存在供应链风险。
- 未提供回滚机制，操作失败后难以恢复。
- 未提供版本和变更日志，维护性差。
这个 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 有哪些优点和局限？
- 提供了完整的端到端视频创作流程，从脚本到成片代理都能自动完成，无需手动干预。
- 内置丰富的资源：约 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？
- 安装 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。