Ks Idol Mv — Development skill for Claude Code

ks-idol-mv · 给你的偶像写首歌，再剪一支 MV 🎬

*Make an original tribute song for someone you love watching — sung in your own voice — and a lyric MV built from real news photos and official clips, cut word by word.*

[English](README.en.md)

偶像退役、告别、夺冠的那天，你心里有一堆话说不出来。网上的混剪千篇一律：一首别人的歌，一堆随手截的图，字幕对不上拍。

这个 skill 让 AI 陪你把这件事做成**专业音乐媒体的质感**：一首用你自己声音唱的原创歌，一支每句歌词都对着一个真实历史瞬间的 MV，最后按各平台的规矩发出去。

🎯 你会得到什么

• 🎵 一首原创致敬歌：选一首你喜欢的歌当风格参考，用你本人的清唱克隆音色；歌词是「他带给你的东西」，不是人物百科
• 🎞️ 一支逐字对点的 MV：真实新闻图 + 官方视频片段，进球入网落在副歌那个重音字上；胶片日期戳、地点小字、统一调色和颗粒、片头片尾署名
• 📐 三种画幅：竖屏 9:16（抖音、视频号、Shorts、Reels）、横屏 16:9（YouTube、B 站）、方屏 1:1，同一个工程分别渲染
• 🌏 多语言歌词：简中、繁中、日文逐字出现；英文、韩文和西葡法德等逐词出现，各配一套开源字体
• 📣 发布包：平台 AI 声明怎么勾、话题标签按证据分级、标题正文两版、3 分钟以内的短版、SRT 字幕

🗺️ 十一步，每个关键处停下来等你拍板

1. 🎤 开工访谈 —— 致敬谁、为什么、发哪里、用哪个音乐引擎
2. 🧰 环境与项目 —— 一条命令查环境、一条命令建工程
3. 🎧 参考曲 —— 找换气口和长音尾巴，剪出严格 30 秒 🛑
4. 🗣️ 音色 —— 教你录 20–30 秒清唱，查削波 🛑
5. ✍️ 歌词 —— 访谈出你的记忆碎片，多语种核对事实，A/B 两版 + 5 个歌名 🛑
6. 🎼 生成 —— 一张清单一次确认请求体和费用，生成、去水印、选版本 🛑
7. 🧭 MV 立项 —— 歌词 → 画面对应表、版权路线、要不要画面里的 AI 标识 🛑
8. 🔎 素材调研 —— 多路搜索 → 对抗核查 → 补缺，冲突交给你裁决 🛑
9. 🎨 镜头表与样片 —— 只调一个数，直到字和唱对上 🛑
10. 🎬 全片与核查 —— 独立核查日期、地点、署名；40+ 帧抽检 🛑
11. 📤 发布 —— 你自己发，它只准备好一切 🛑

已经有歌（Suno 网页做的、自己录的都行）就从第 6 步进；已经有成片就只做第 10 步。

📖 来历

一次完整的实跑：某球星的告别，一首近 4 分钟的歌，一支约 50 个场景、近 60 条镜头、约 10 处官方视频片段的竖屏 MV。从出歌到成片十几个小时，总花费三十多元。踩过的几十个坑、每一个参数、每一条判断标准都写进了 `references/`。

🧩 支持什么

Agent	任何支持 Agent Skills 的 agent：Claude Code、Codex、Cursor、GitHub Copilot、Gemini / Antigravity CLI、OpenCode、Kimi Code、CodeBuddy / WorkBuddy、Trae 等。没有子 agent、联网、选择题工具的 agent 也能跑，只是慢一点（SKILL.md 开头有能力自检）
音乐引擎	Mureka（API：本人声音 + 参考曲风格 + 逐字时间戳）；ElevenLabs Music（API）；Suno 等没有官方 API 的（官方 App 里生成、官方下载后导入）；你自己的歌。没有时间戳的歌用强制对齐补（Demucs + WhisperX）
系统	macOS、Windows、Linux（脚本全是 Python；Windows / Linux 分支目前只做了代码审查，欢迎反馈）
视频素材	用 yt-dlp 下载公开、非 DRM 视频的片段。2026-10 不登录实测能拿到格式列表的：YouTube（截段下载也实测成功）、B 站（720p）、X、TikTok、Twitch、Dailymo