这是什么
music-composition-skills 是一个面向 AI 编程代理（Agent）的音乐创作与编曲技能库，由作者 jtydhr88 开发，项目采用 MIT 协议开源。它包含 29 个专业技能，专为 Claude Code 和 OpenAI Codex 设计，核心目标是将专业音乐制作中的编曲决策转化为结构化文档，引导生成式 AI 产出更高质量的音乐作品。
该技能库从 50 本关于管弦乐、和声、曲式、对位、混音及风格实践的书籍中提炼知识，并从 62 个多轨录音中测量了实际编曲数据，因此具有深厚的专业基础。它不提供任何现成的音乐作品，而是生成一份完整的编曲规格书（ARR-SPEC），包含调性、速度、段落划分、和弦标记、乐器进出时机、能量曲线、演唱细节和混音意图等关键信息。
这一份规格书可同时用于四种用途：交接给其他技能、控制 A/B 对比、编译为 Suno 或 YuE2 的输入、作为验收基准。通过这样的设计，创作者可以对 AI 生成结果进行逐字段检查与修改。
适合谁
- 音乐创作者：希望快速获得专业级编曲方案的作曲家、制作人。
- 自媒体运营者：需要为短视频、抖音等平台制作背景音乐或原创歌曲的人。
- AI 音乐爱好者：使用 Suno、YuE2 等工具但苦于提示词无法控制细节的用户。
- 歌词作者：可与配套的 lyric-writing-skills 库结合，实现词曲分离创作。
- 一人公司或独立开发者：想要低成本、高效生成定制音乐资产。
能做什么
该技能库涵盖了从灵感到成品的全流程，主要包括：
- 工作流路由（mc-workflow）：从简短的创作需求出发，自动匹配所需的技能组合。
- 编曲结构设计（mc-arrangement-arch）：规划整首歌曲的能量曲线、声部增减、情绪推进。
- 旋律与和声（mc-melody、mc-harmony、mc-progressions）：生成可唱的旋律，选择和声进行与和弦色彩。
- 节奏与风格（mc-rhythm-section、mc-rhythm-groove、mc-style-*）：涵盖城市流行、嘻哈、爵士、拉丁、电子舞曲等十余种风格。
- 配器与音色（mc-orchestration、mc-sound-design、mc-texture-layering）：决定音色、织体和频谱分配。
- 演唱与混音（mc-vocal-direction、mc-mix-intent）：指定演唱方式和混音目标。
- 输出编译（mc-render-compile、mc-symbolic-score）：将规格书转化为 Suno 提示词、ABC 乐谱、MusicXML 或 MIDI 文件。
- 质量诊断（mc-ai-tell-audit）：列出 14 种常见“AI 味”特征，逐项检查生成结果。
每个技能都独立可用，也可通过规格书中的外部接口与其他技能组合，形成完整的创作流水线。
使用前准备
你需要：
- 安装 Claude Code 或 OpenAI Codex（CLI、桌面应用或 IDE 扩展）。
- 具备基本的命令行操作能力，以便执行安装命令。
- 可选：安装同系列的 lyric-writing-skills 库，用于创作带歌词的歌曲。
- 对音乐理论有基础了解会更有帮助，但并非必须——技能会引导 AI 做出专业决策。
安装方法
有多种安装方式，推荐使用插件市场安装：
Claude Code（插件市场）
/plugin marketplace add jtydhr88/music-composition-skills
/plugin install music-composition@music-composition-skills然后通过 /music-composition: 调用技能，例如 /music-composition:mc-workflow。
个人目录安装（适用于所有项目）
git clone https://github.com/jtydhr88/music-composition-skills.git
cp -r music-composition-skills/plugins/music-composition/skills/* ~/.claude/skills/Codex（CLI / 桌面 / IDE）
codex plugin marketplace add jtydhr88/music-composition-skills或手动复制技能文件到 ~/.agents/skills/（个人）或 .agents/skills/（项目）。
安装后，技能会在检测到相关上下文时自动加载，可用 /skills 查看列表。
使用示例
以下是几个真实的使用场景和技能调用路径：
- 生成城市流行风格歌曲：请求“写一首关于最后一班回家的城市流行，3 分半，提供粘贴到 Suno 的完整信息” → 依次调用 mc-workflow → mc-style-citypop-rnb → mc-arrangement-arch → mc-render-compile。
- 修复副歌不够高潮：请求“副歌没有提升，修改编曲但保留旋律” → 调用 mc-arrangement-arch（能量曲线、提升前的减法）+ mc-texture-layering。
- 说唱加中国风副歌：请求“说唱+中国风，像某首 named song” → mc-workflow §2.4 融合路由 → mc-style-hiphop（基础）+ mc-style-chinese-pop（叠加）。
- 诊断 AI 味：请求“生成曲听起来像 AI 但说不清楚为什么” → 调用 mc-ai-tell-audit，按 14 项逐一检查。
- 询问 Bossa Nova 节奏：请求“Bossa Nova 需要什么鼓型与速度？” → 调用 mc-rhythm-section（11 个风格表，然后五步模式决策）。
风险与注意事项
- 时间成本：完整专业流程可能花费 20 分钟以上，因为 AI 需要读取标准、填写规格、运行检查清单。
- 不是万能生成器：该库不包含任何音乐作品或歌词，专注提供编曲决策，最终音乐仍由生成模型完成。
- 版权安全：通过引用风格而非具体歌曲，可避免侵犯版权，但使用者需自行判断。
- 依赖外部模型：实际音质取决于 Suno 或 YuE2 等生成模型的能力。
- 技术门槛：需要熟悉 AI 代理工具的基本操作，但无需是专业音乐家。
该项目在 GitHub 上拥有 166 颗星、23 个分支，无未解决问题，采用 MIT 许可证，完全免费。无论你是想快速制作背景音乐，还是深入探索 AI 辅助编曲，这个技能包都值得尝试。