前言¶
做短劇或系列視頻時，常見做法是分別在文案工具、繪圖工具和文生視頻工具裏來回切換：劇本一版、角色參考圖一版、分鏡又一版，上下文很難在多個產品之間對齊。Zopia-Skill 面向的是另一條路徑——在支持 Skill 的 AI Agent 裏，按「劇本 → 角色 → 分鏡 → 成片」串聯 Zopia 平臺上的 AI Agent 能力，讓對話式助手承擔流程編排，而不是隻生成單段提示詞。
下面介紹它是什麼、能做什麼、如何安裝，以及適合在什麼需求下啓用。
這是什麼¶
Zopia-Skill 是 SkillHub 上的社區技能（座標 @user_680513bf/zopia，當前版本 1.1.0），分類爲 design-media，由發佈者 user_680513bf 維護。技能說明將其定位爲：通過 Zopia 平臺的 AI Agent 進行視頻與圖片創作，並在 Agent 側約定觸發條件與創作鏈路。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_680513bf/zopia
- API 座標地址：https://api.skillhub.cn/user_680513bf/zopia
SkillHub 元數據標註 requires_api_key=true，使用前需要能訪問 Zopia 平臺並具備相應 API 憑證；具體密鑰如何寫入環境或項目配置，以安裝包內的 SKILL.md 爲準。
核心功能¶
以下能力均來自 SkillHub 上的技能簡介，對應 Zopia 側 Agent 可覆蓋的創作環節：
- AI 視頻生成：文生視頻、圖生視頻。
- AI 圖片生成：角色設定圖、分鏡關鍵幀等靜態素材。
- 劇本創作：對話、旁白、場景描述等文本層內容。
- 角色設計：與後續分鏡、成片保持角色一致性的設定工作。
- 分鏡設計：把劇本拆成可執行的鏡頭與畫面節點。
- 多集連續劇製作：在單集流程之上延伸的系列化製作場景。
技能的觸發判斷在簡介中寫得很明確：當用戶提到 zopia、視頻創作、短劇製作、分鏡、角色設計、AI 視頻生成等意圖時應啓用；更寬泛的規則是——只要請求涉及通過 AI 完成的系統化視頻創作流程（劇本 → 角色 → 分鏡 → 視頻），都應觸發此技能，而不是隻回答零散的提示詞技巧。
安裝與啓用¶
Zopia-Skill 遵循通用 SKILL.md 技能格式。SkillHub 官方頁面給出的安裝方式是：讓當前 AI 根據 SkillHub 安裝文檔 安裝座標 @user_680513bf/zopia。若本機已安裝 SkillHub CLI，也可在終端執行（--dir 必須指向當前 Agent 實際讀取的 skills 目錄，否則技能不會被加載）：
command -v skillhub && skillhub --version
未安裝 CLI 時，可按 SkillHub 文檔使用安裝腳本（完整安裝或僅 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝技能到對應客戶端目錄（將 <skills 目錄> 換成你正在用的 Agent 路徑）：
skillhub install @user_680513bf/zopia --dir <skills 目錄>
SkillHub 文檔中常見的 skills 目錄示例：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
安裝完成後，按包內 SKILL.md 完成 API Key 等前置配置，並重啓或重新加載 Agent，使技能進入可用狀態。
典型用法¶
官方頁面未單獨給出腳本級示例；可復現的用法主要體現在對話意圖與流程順序上。經過上面的步驟啓用技能後，可以在 Agent 裏用自然語言描述完整創作目標，例如：
- 先寫一集短劇的劇本（含場景描述與旁白），再基於劇本做角色設定圖；
- 在角色定稿後輸出分鏡關鍵幀，最後按分鏡做文生視頻或圖生視頻；
- 明確提到「zopia」「短劇製作」「分鏡」「AI 視頻生成」等關鍵詞，以便命中技能自帶的觸發規則。
Agent 在技能約束下應把任務拆到 Zopia 平臺能力所覆蓋的環節，而不是隻生成一段通用視頻提示詞。多集連續劇場景下，同樣是在上述鏈路上擴展集數與前後集銜接，具體調用細節以安裝後的 SKILL.md 與 Zopia 平臺文檔爲準。
適用場景與注意¶
適合誰
- 需要在 Agent 裏做端到端視頻創作編排的創作者或小團隊；
- 已經或計劃使用 Zopia 作爲視頻/圖片生成後端，並希望減少在多個工具間手工拷貝劇本與設定的工作；
- 工作流天然包含劇本、角色、分鏡、成片多個階段，而不是單次「生成一條視頻」。
使用上需要注意
- 技能依賴 API Key（SkillHub 標籤
requires_api_key=true），未配置憑證時無法真正調用 Zopia 側能力。 - 版本以 SkillHub 爲準（當前 1.1.0）；評分、下載量等統計會隨時間變化，選用前可在 SkillHub 技能頁 查看最新數據。
- 安裝路徑錯誤是常見坑：務必使用
--dir指向當前 Agent 的 skills 目錄，否則默認裝到./skills/可能不被識別。
結尾¶
Zopia-Skill 的價值在於把 Zopia 平臺上的視頻與圖片 Agent 能力，封裝成 Agent 可識別的創作流程與觸發規則，尤其適合劇本、角色、分鏡、成片需要一脈相承的短劇與系列視頻場景。若要查看簡介、版本與安裝提示，請訪問官方 SkillHub 頁面：https://www.skillhub.cn/skills/user_680513bf/zopia 。
