Mintii-Labs/ozor-skills

Ozor 生成 (文本转视频)

使用 mcp__ozor__* 工具在 Ozor.ai 上实现端到端视频生成。该技能接收一个简短创意简报，返回已完成、已导出的可分享视频——不仅仅是提示词。

何时使用

当用户想从一个简短文本想法实际制作视频时使用此技能。信号包括：

• "制作一个关于……的视频"
• "为……生成一个发布视频"
• "创建一个 30 秒的解释视频，关于……"
• "为我们的新功能制作一个广告……"
• "渲染一个视频，内容是关于……"

请勿在以下情况使用此技能：

• 用户提供文档、PDF、PPTX、DOCX、幻灯片或文件 → 使用 ozor-document-video
• 用户提供 URL / 着陆页 → 使用 ozor-url-to-video
• 用户只是想帮助撰写 Ozor 提示词而不生成 → 使用 ozor-video-best-practices
• 用户想要管理现有视频 → 使用 ozor-video-library

必需的 MCP 工具

此技能假定 Ozor MCP 已连接。所使用的工具包括：

• mcp__ozor__generate_video — 启动文本转视频任务
• mcp__ozor__wait_for_job — 阻塞直到代理完成项目构建
• mcp__ozor__export_video — 开始渲染
• mcp__ozor__wait_for_export — 阻塞直到渲染完成，返回 URL
• mcp__ozor__get_embed_code — 返回 <iframe> HTML
• mcp__ozor__list_voices — 可选，查询可用声音
• mcp__ozor__send_message — 可选，对视频代理进行后续编辑

如果 Ozor MCP 未连接，请告知用户添加并停止——不要尝试退化为仅输出提示词。

工作流程

步骤 1 —— 完善简报

Ozor 提示词最多 2000 字符，应描述一个短片。在调用 MCP 之前，请确保简报包含以下信息：

• 视频内容：一句话概括
• 观众（创始人、开发者、客户、普通公众……）
• 格式 — 16:9（默认，横屏）或 9:16（竖屏，用于社交媒体）
• 大致时长 — 通常 15–90 秒
• 场景数量（3–6 个为最佳）
• 语气（自信、温暖、有活力、技术性强……）
• 视觉风格（深色/浅色、强调色、极简/大胆）
• 最终场景的清晰行动号召（CTA）

如果缺少上述任何一项且缺失内容会显著影响输出结果，则提出一个有针对性的问题。否则，选择一个合理的默认值并继续——采用自动模式行为。

切勿将文档中提取的多场景脚本粘贴到此提示词中。 这会导致超过 2000 字符限制并丢失幻灯片视觉效果。对于文档，请切换至 ozor-document-video。

步骤 2 —— 生成

调用：

mcp__ozor__generate_video({
  prompt: "<编译后的简报，2000 字符以内>",
  export: true   // 推荐：自动触发导出，以便跳过步骤 4
})

该调用返回 { videoId, jobId }。告知用户任务已启动，并说明正在等待。

步骤 3 —— 等待构建

调用：

mcp__ozor__wait_for_job({ videoId, jobId })

该调用会阻塞直到 Ozor 代理完成项目构建。如果失败，错误信息通常会说明如何修复提示词——将其传达给用户，并提供调整后重试的选项。

步骤 4 —— 导出（如果在步骤 2 中传递了 export: true，则跳过此步）

如果在步骤 2 中未传递 export: true，则调用：

mcp__ozor__export_video({ videoId })

步骤 5 —— 等待渲染

调用：

mcp__ozor__wait_for_export({ videoId })

该调用返回最终 URL：

• shareUrl — 已渲染视频的公开链接
• editorUrl — Ozor 编辑器链接，用于进一步调整
• downloadUrl — 直接 MP4 下载链接

步骤 6 —— 获取嵌入代码

调用：

mcp__ozor__get_embed_code({ videoId })

返回一个即用型 <iframe> 代码片段。

步骤 7 —— 向用户展示结果

按以下格式输出：

🎬 视频已就绪

**分享：** <shareUrl>
**编辑器：** <editorUrl>
**下载：** <downloadUrl>

**嵌入代码：**
```html
<iframe ...></iframe>

需要迭代吗？我可以：

• 更改某个特定场景
• 尝试不同的语气或视觉风格
• 制作 9:16 竖屏社交媒体版本

## 迭代

如果用户在查看结果后希望进行更改，请使用 `mcp__ozor__send_message({ videoId, message: "<变更请求>" })`，然后重新运行步骤 3–6（代理会重建项目，您需要重新导出）。

对于较大的调整（不同的主题、不同的受众），请启动一个新的 `generate_video` 调用，而不是迭代——提示词预算较小，原地调整往往会使输出变得混乱。

## 自动模式下默认值假设

当用户提供一行简报且您不想逐一询问时：

| 字段 | 默认值 |
|-------|---------|
| 格式 | 16:9 横屏 |
| 时长 | ~30 秒 |
| 场景数 | 3–4 |
| 语气 | 自信、现代 |
| 风格 | 干净、极简，带一种强调色 |
| CTA | "了解更多"，如果未提供则使用占位符 URL/句柄 |

在回复中说明您所假设的默认值，以便用户更正。

## 调用 `generate_video` 前的质量检查清单

- [ ] 提示词在 2000 字符以内
- [ ] 一个明确的主题，非多主题论述
- [ ] 在场景 1 中提出引人点
- [ ] 在最后一个场景中提出 CTA
- [ ] 指定了视觉风格 + 语气 + 受众
- [ ] 未复制文档中的文字——那是 `ozor-document-video` 的任务

## 错误与恢复

- **MCP 不可用** → 告知用户 Ozor MCP 未连接并停止。不要退化为写纸面提示词。
- **`generate_video` 因提示词过长而失败** → 压缩简报，删除冗余的风格说明，重试。
- **`wait_for_job` 返回失败** → 原样传达错误信息，建议修复方法（通常为：简化提示词，删除模糊的场景指令），并提供重试选项。
- **`wait_for_export` 超时** → 可安全地再次调用；导出将从 Ozor 中断处继续。

## 规则

1. **实际运行 MCP。** 此技能的存在是为了生成视频，而不是提示词。如果您只返回文本，则未完成技能要求。
2. **不要问 5 个澄清问题。** 最多问一个有针对性的问题，其余内容采用默认值。
3. **展示每一个 URL。** `shareUrl`、`editorUrl`、`downloadUrl` 和嵌入代码在不同场景下都很有价值——全部展示。
4. **遵守 2000 字符提示词限制。** 如果简报超过此限制，请先裁剪再发送。
5. **默认在 `generate_video` 中使用 `export: true`** —— 减少一次工具调用，更快获得最终视频。