SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场mv-skill

mv-skill

设计与创作

查看项目

更新于 10-16 09:16

技能介绍

MV Skill 是一个动感短视频生成器。你只需描述主题和风格，这个 skill 会自动完成：AI 音乐生成、智能分镜规划、素材获取、Remotion 渲染，最终输出一个商业级 MP4 文件。

用途

该技能用于创建音乐视频、MV、短视频、视频片段或带音乐的动画视频。是否使用 mv-skill 的快速判断如下：

  • 用户要做 MV / 音乐视频 / 动感短片：YES
  • 用户有主题 / 歌词 / 风格偏好：YES
  • 用户提供了本地音乐文件：YES
  • 用户只要生成图片：NO，用 zimage-skill
  • 用户要录屏 / 教程视频：NO
  • 用户要纯文字动画：NO

主要能力

  • 多风格模板：热血动漫、赛博朋克、抒情 MV
  • AI 音乐生成：集成 Suno，自动生成配乐；也支持本地 MP3
  • 智能素材获取：素材库（Pexels/Pixabay）优先，AI 生成兜底
  • 可视化分镜预览：渲染前确认每一个镜头，支持逐镜修改
  • 短视频优化：9:16 竖屏，50-60 秒，适配抖音 / Reels / Shorts

使用方式

当触发 mv-skill 时，agent 应按以下步骤执行：

  1. 理解需求：提取用户描述中的主题、风格、时长偏好、是否有本地音乐
  2. 选择模板：根据风格关键词匹配最合适的模板
  3. 生成分镜脚本：调用 storyboard_generator.py 生成场景列表
  4. 获取 / 生成音乐：优先使用用户提供的音乐；否则调用 Suno API 生成；失败则使用占位音频
  5. 获取素材：调用 asset_manager.py 从素材库下载图片 / 视频片段
  6. 展示分镜预览：以文字表格形式展示各场景（场景名、时长、描述、素材）
  7. 等待确认：询问用户是否确认，或需要修改哪个场景
  8. 渲染输出：用户确认后调用 renderer.py，输出 MP4 到 output/ 目录
  9. 报告结果：告知输出文件路径，提示可以进一步修改

如果用户在初始描述中已经足够清晰，可以跳过第 7 步直接渲染，渲染完成后展示结果。

最简用法

"帮我做一个热血风格的 MV，主题是宇宙战士"

指定更多细节

"制作一个赛博朋克风格的 MV，主题：霓虹都市的孤独黑客，歌词：在数据的海洋里漂流，时长：55 秒"

使用本地音乐

"用我的音乐文件 /tmp/my_song.mp3 做一个抒情 MV，歌词是'代码里寻找诗意'"

可用风格模板

  • 热血动漫：模板 ID anime-hype，关键词为热血、动漫、燃、战斗、励志，适合战斗、励志、运动场景
  • 赛博朋克：模板 ID cyberpunk，关键词为赛博、科技、霓虹、未来、黑客，适合科幻、电子音乐场景
  • 抒情 MV：模板 ID lyric，关键词为抒情、唯美、治愈、情歌、慢歌，适合情歌、慢歌、叙事场景

工作流程示例

示例 1：热血动漫风

用户："做一个圣斗士星矢风格的 MV，主题是小宇宙觉醒"

AI：正在生成分镜预览……分镜预览显示场景包括标题、战士登场、蓄力、爆发、升华、结尾，并展示各自时长与描述。随后询问确认开始渲染？[确认 / 修改 Scene X / 重新生成]。用户确认后，AI 报告渲染完成，输出为 ~/.claude/skills/mv-skill/output/小宇宙觉醒_1080x1920.mp4

示例 2：逐镜修改

用户："修改 Scene 3，换成我自己的图片 hero.png"

AI：已更新 Scene 3 素材为 hero.png，预览已刷新。是否重新渲染？

示例 3：使用本地音乐

用户："使用这个音乐文件 /path/to/music.mp3 制作 MV"

AI：已检测音乐 BPM: 128，时长: 58秒，正在生成匹配的分镜……

首次配置

必需依赖：

# 安装 Remotion 依赖
cd ~/.claude/skills/mv-skill/remotion && npm install

# 安装 Python 依赖
pip install requests librosa pydub pyyaml pillow

API Keys（按需配置）：

# 写入 ~/.zshrc 或 ~/.bashrc
export SUNO_API_KEY="your_key"      # AI 音乐生成（可选）
export PEXELS_API_KEY="your_key"    # 高质量素材（推荐）
export PIXABAY_API_KEY="your_key"   # 备用素材源（可选）

输出位置：

~/.claude/skills/mv-skill/output/
└── {标题}_{分辨率}.mp4

适用场景与限制

适用场景包括：制作 MV / 音乐视频 / 动感短片；用户有主题、歌词或风格偏好；用户提供了本地音乐文件。不适用场景包括：仅生成图片、录屏 / 教程视频、纯文字动画。

常见问题：

  • 音乐生成失败怎么办？上传本地 MP3 文件代替："使用这个音乐文件 /path/to/music.mp3"
  • 素材质量不满意？在预览阶段说 "Scene 2 换一张" 或提供自己的素材路径
  • 渲染太慢？首次渲染需要下载 npm 依赖（约 1-2 分钟），后续会快很多
  • 如何添加自定义歌词？在描述中包含歌词，如 "歌词：燃烧吧小宇宙"
  • 支持横屏吗？当前默认 9:16 竖屏（1080x1920）；如需横屏请在描述中说明

技术架构

mv-skill/ 目录结构包括：SKILL.md、evals/（测试用例）、templates/（MV 风格模板，含 anime-hype、cyberpunk、lyric）、schemas/（分镜脚本 JSON Schema）、scripts/（核心 Python 脚本：cli.py、storyboard_generator.py、asset_manager.py、music_generator.py、music_analyzer.py、renderer.py）、remotion/（Remotion 项目，TypeScript/React）。

数据流：用户描述 → cli.py（参数解析）→ storyboard_generator.py（生成分镜 JSON）→ asset_manager.py（素材获取）+ music_generator.py（音乐生成）→ [用户确认分镜] → renderer.py → Remotion CLI → output/*.mp4

依赖的 Skills：remotion-best-practices（Remotion 视频制作知识库）、zimage-skill（AI 图像生成，素材兜底）、media-downloader（素材库下载，Pexels/Pixabay）。