前言¶
做短剧或系列视频时，常见做法是分别在文案工具、绘图工具和文生视频工具里来回切换：剧本一版、角色参考图一版、分镜又一版，上下文很难在多个产品之间对齐。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 。
