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 未連線，請告知使用者需先加入 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 字元
- [ ] 一個明確的主題，而非多主題的長篇大論
- [ ] 第一場景就點出核心鉤子
- [ ] 最後一個場景包含行動呼籲 (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`** — 減少一次工具呼叫，更快取得最終影片。