Menu
读取 project.yaml，将排行榜图片和音频合成为最终 MP4 视频。当所有选手的图片和音频均已就绪、或用户要求渲染/导出/完成视频时使用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
使用 edge-tts（免费）、OpenAI TTS 或 Fish Audio TTS 将旁白文案转换为音频文件。当片段缺少 audio 字段、用户要求生成配音、或需要将脚本合成语音时使用。
制作"从夯到拉"排行榜锐评视频。当用户想制作排行榜锐评视频、给事物打分排名、或从话题生成带动画的排行榜 MP4 时使用。负责协调 search-images、generate-tts 和 assemble_tierlist 脚本。
使用 DuckDuckGo 搜索并下载视频幻灯片所需的图片素材（无需 API Key）。当视频项目缺少 image 字段、某个片段没有图片、或用户要求根据关键词搜图时使用。
| name | assemble-video |
| description | 读取 project.yaml，将排行榜图片和音频合成为最终 MP4 视频。当所有选手的图片和音频均已就绪、或用户要求渲染/导出/完成视频时使用。 |
读取 project.yaml（type: "tierlist"），生成"从夯到拉"排行榜动画视频。
python skills/assemble-video/scripts/assemble_tierlist.py \
--project projects/myvideo/project.yaml \
--output projects/myvideo/output/video.mp4 \
[--config config.yaml]
标准输出（JSON）：
{"path": "projects/myvideo/output/video.mp4", "duration_seconds": 245.7}
project.yaml 中：
type: "tierlist"contestant 均有 image、audio、tier 字段intro 和 outro 均有 audio 字段若有字段缺失，请先运行 search-images 和 generate-tts 补全。
排行榜背景图（五档）：skills/assemble-video/assets/tierlist_bg.png
| 错误信息 | 原因 | 修复方法 |
|---|---|---|
ffmpeg not found / FileNotFoundError: ffmpeg | 系统未安装 ffmpeg | macOS: brew install ffmpeg；Ubuntu: sudo apt install ffmpeg |
ModuleNotFoundError: No module named 'moviepy' | Python 依赖未安装 | 在项目根目录执行 uv sync（或 pip install moviepy pillow numpy） |
FileNotFoundError: [image path] | project.yaml 中的图片路径不存在 | 确认 image 字段路径正确，或先运行 search-images 补全 |
FileNotFoundError: [audio path] | project.yaml 中的音频路径不存在 | 确认 audio 字段路径正确，或先运行 generate-tts 补全 |
PIL.UnidentifiedImageError | 图片文件损坏或格式不支持 | 删除该图片，重新运行 search-images 下载 |
| 视频合成卡住不动 | 某段音频时长为 0 或 duration 字段错误 | 检查 project.yaml 中所有 duration 字段，值应大于 0 |
| 输出视频无声音 | ffmpeg 版本过旧 | 升级 ffmpeg：brew upgrade ffmpeg |