AI歌曲创作技能

解决的核心问题

为一个特殊场合创作一首贴合个人故事的歌曲，传统流程涉及作词、作曲、编曲等多个环节，通常需要专业人士介入，成本较高且周期不可控。这项技能旨在将「从故事到歌曲」的流程自动化，允许用户通过提供结构化输入，快速生成可听的定制化音乐作品，特别适用于生日、婚礼、纪念日等情感驱动的场景。

工作原理与关键步骤

该技能实现了一个端到端的生成式音乐创作流水线，核心能力与步骤如下：

• 输入收集与故事结构化：技能首先收集一系列硬性输入，包括场合、收件人、值得写进歌里的真实细节、必须出现的名称、目标语言、情感方向以及需要省略的隐私信息。随后，它将这些信息构建为一个结构化的故事映射，涵盖主角、关系、转折点、核心信息、情感弧线等，为歌词创作打下基础。

• 免费创意阶段与用户确认：在触发任何付费API之前，技能会进行免费的创意工作。它会生成歌曲标题、一份带有段落结构的完整歌词草稿，以及一张描述曲风、氛围、配器、节拍和演唱方向的制作卡。用户可以在此阶段反复审阅和修改歌词与方向，此过程不产生费用，直到用户明确确认。

• API调用与音乐生成：确认后，技能调用 beatra.models.list 端点查询当前可用的音乐生成模型、字符限制及计费方式。随后，使用随包客户端 scripts/mcp_client.py 作为MCP客户端，向 beatra.music.generate 端点提交一次精确的生成请求。该请求包含已冻结的标题、歌词、制作提示词和模型参数，一次调用即为一个付费边界。

• 任务轮询与结果交付：生成请求提交后，技能获得一个任务ID，并通过 beatra.tasks.get 进行轮询，直到任务进入终态（成功或失败）。它会交付返回的音频文件或链接，并报告解析后的模型、片段数量、时长和用量。技能还会进行结果审阅，检查故事准确度、名字发音、副歌效果等，并向用户清晰说明哪些部分AI能或不能完全保证。

适用边界与注意事项

• 专注于完整工作流：本技能专精于「故事 -> 歌词 -> 歌曲」这一核心路由。如果输入是成品歌词需要谱曲，应使用「词到曲」工作流；需要重新演绎现有歌曲录音，应使用「翻唱歌曲」工作流；需要为音乐生成画面，则路由至「音乐短片」工作流。

• 清晰的付费模型：歌词的撰写、标题起草和方向调整是免费的创作准备工作。唯一的付费点发生在用户确认后，调用 beatra.music.generate 生成歌曲那一刻。更换已确认的任何核心要素（如标题、歌词、模型）将被视为新的逻辑付费请求。

• 严格的状态与事务管理：技能依赖于任务ID和阶段ID进行状态跟踪。对于请求丢失或任务失败，它提供了基于 beatra.tasks.list 和 beatra.tasks.get 的恢复逻辑，但严禁在未确认终态前重复提交生成请求。任务的「排队」和「运行中」是正常的进度状态，并非失败。