mcpField
P
promo-director

promo-director

github.com/bitwize-music-studio营销与增长603228 次安装2 周前更新
代码仓库

关于 promo-director

promo-director 是面向音乐发行流程的技能，可根据已完成母带的音频制作社交媒体宣传视频。它结合封面、音频波形和曲目信息，并可为专辑生成逐曲短片或串烧。

主要功能

  1. 01生成 9:16 竖屏宣传视频
  2. 02提供 9 种波形可视化样式
  3. 03从封面提取配色
  4. 04自动选取高能片段
  5. 05生成专辑串烧视频

适用场景

  1. 01为发行前的单曲制作短视频
  2. 02为专辑生成曲目串烧
  3. 03为 Instagram Reels、Twitter 和 TikTok 准备视频

MCP 相关

该技能通过 MCP 的 resolve_path 定位专辑音频目录，并调用 generate_promo_videos 和 generate_album_sampler 生成视频。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bitwize-music-studio/claude-ai-music-skills --skill promo-director

安装后在 Claude Code 中输入/promo-director确认已加载。

附带文件technical-reference.mdvisualization-guide.md

详细介绍

促销视频制作 Skill

根据母带音频生成适用于社交媒体的专业宣传视频。制作 15 秒竖屏视频（9:16，1080x1920），针对 Instagram Reels、Twitter 和 TikTok 进行优化。

用途

完成音频母带处理后，生成包含以下内容的宣传视频：

  • 专辑封面
  • 音频波形可视化（提供 9 种样式）
  • 曲目标题 + 艺人名称
  • 自动从封面提取配色方案
  • 智能选择片段（找出最有活力的 15 秒）

适用时机

  • 音频母带处理完成后、发行前
  • 用户说“生成宣传视频”或“为 [专辑] 制作宣传视频”
  • 专辑已准备好母带音频和封面时

工作流中的位置

Generate → Master → **[Promo Videos]** → Release

母带处理工程师与发行总监之间的可选步骤。

工作流

1. 验证环境

检查 ffmpeg：

ffmpeg -filters | grep showwaves

必需的滤镜：showwaves、showfreqs、drawtext、gblur

如果缺少：

Error: ffmpeg not found or missing required filters

Install ffmpeg:
  macOS: brew install ffmpeg
  Linux: apt install ffmpeg

After installing, run this command again.

检查 Python 依赖：

调用 get_python_command() 验证虚拟环境是否存在。如果 venv_exists 为 false，显示警告并建议使用 /bitwize-music:setup。

2. 检测专辑

通过 MCP 解析音频路径：

调用 resolve_path("audio", album_slug) — 返回完整音频目录路径，包括艺人文件夹。

结果示例：~/bitwize-music/audio/artists/bitwize/albums/electronic/sample-album/

验证内容：

  • ✓ 母带音频文件（.wav、.mp3、.flac、.m4a）
  • ✓ 专辑封面（album.png 或 album.jpg）

如果缺少封面：

Error: No album artwork found in {audio_root}/artists/{artist}/albums/{genre}/{album}/

Expected: album.png or album.jpg

Options:
  1. Use /bitwize-music:import-art to place artwork
  2. Specify path manually: --artwork /path/to/art.png

Which option?
3. 用户偏好

先检查配置默认值：

从 ~/.bitwize-music/config.yaml 中读取 promotion 部分的默认值：

  • promotion.default_style - 默认可视化样式
  • promotion.duration - 默认视频片段时长
  • promotion.include_sampler - 默认是否生成专辑串烧
  • promotion.sampler_clip_duration - 串烧中每首曲目的秒数

如果不存在配置部分，则使用内置默认值（pulse、15s、启用串烧、每段 12s）。

询问：要生成什么？

选项（默认为配置值或“both”）：

  1. 单曲宣传视频（每首 15s）+ 专辑串烧（包含所有曲目）
  2. 仅生成单曲宣传视频
  3. 仅生成专辑串烧

询问：可视化样式？

默认使用 promotion.default_style；若未设置，则使用 pulse。

样式适用类型描述
pulse电子、嘻哈带强烈辉光的示波器/EKG 风格（默认）
bars流行、摇滚快速响应的频谱柱
line原声、民谣经典简洁的波形
mirror氛围、舒缓对称镜像波形
mountainsEDM、重低音双声道频谱（形似山脉）
colorwave独立、另类带细微辉光的简洁波形
neon合成器浪潮、80 年代风格锐利波形与鲜明霓虹辉光
dual实验性两条独立波形（主色与互补色）
circular抽象、实验性矢量示波器（狂野的圆形图案）

默认建议：

  • 电子/嘻哈 → pulse
  • 摇滚/流行 → bars
  • 民谣/原声 → line
  • 氛围/舒缓 → mirror

询问：自定义时长？

默认：15 秒（适合 Instagram/Twitter）

选项：

  • 15s（推荐，Instagram Reels 的理想时长）
  • 30s（较长预览）
  • 60s（完整片段，不太常见）

专辑串烧：

默认：每首曲目 12 秒

计算总时长：

Total duration = (tracks * clip_duration) - ((tracks - 1) * crossfade)
Twitter limit: 140 seconds

如果超过 140s：

WARNING: Expected duration {duration}s exceeds Twitter limit (140s)

Recommendation: Reduce --clip-duration to {140 / tracks}s
4. 生成

单曲宣传视频：

generate_promo_videos(album_slug, style="pulse", duration=15)

仅生成单曲：

generate_promo_videos(album_slug, style="pulse", track_filename="01-track-name.wav")

专辑串烧：

generate_album_sampler(album_slug, clip_duration=12, crossfade=0.5)

处理错误：

常见问题：

  • ffmpeg 滤镜错误 → 检查 ffmpeg 安装是否包含所需滤镜
  • 找不到字体 → 安装 dejavu 字体或指定自定义字体
  • 封面提取失败 → 使用默认青色配色方案
  • librosa 不可用 → 改为从曲目 20% 处选择片段
  • 音频文件损坏 → 跳过该曲目、报告问题，并继续处理其他曲目
5. 结果摘要

报告生成的文件：

## Promo Videos Generated

**Location:** {audio_root}/artists/{artist}/albums/{genre}/{album}/

**Individual Track Promos:**
- {audio_root}/artists/{artist}/albums/{genre}/{album}/promo_videos/
- 10 videos generated
- Format: 1080x1920 (9:16), H.264, 15s each
- Style: pulse
- File size: ~10-12 MB per video

**Album Sampler:**
- {audio_root}/artists/{artist}/albums/{genre}/{album}/album_sampler.mp4
- Duration: 114.5s (under Twitter 140s limit ✓)
- Format: 1080x1920 (9:16), H.264
- File size: 45.2 MB

**Next Steps:**
1. Review videos: Open promo_videos/ folder
2. Test on phone: Transfer one video and verify quality
3. Populate social copy: Fill in promo/ templates (twitter.md, instagram.md, etc.)
4. [Optional] Upload to cloud: /bitwize-music:cloud-uploader {album}
5. Ready for release workflow: /bitwize-music:release-director {album}

技术参考

请参阅 technical-reference.md，了解：

  • 输出规格（分辨率、格式、比特率）
  • 可视化样式（脉冲、条形、线条等）
  • 平台兼容性（Instagram、Twitter、TikTok）
  • 依赖项（必需和可选）
  • 常见问题排查

评论

支持 Markdown