AI定制歌曲制作
把一个人的故事、场合和必须写进歌里的细节变成原创歌词和一首全新生成的歌曲。本 Skill 适用于定制生日歌、婚礼歌曲、纪念日歌曲、表白或求婚歌曲、家庭纪念、宝宝成长歌、宠物纪念歌、团队司歌、企业歌曲或一首歌曲礼物。
适用范围与相邻路由
常规路线是一份故事简报、一份确认的歌词草稿和一首完整的原创歌曲。只需要把成品歌词变成歌曲的请求路由到词到曲工作流；需要重新演绎参考歌曲录音的请求路由到翻唱歌曲工作流；需要把成品音乐变成画面的请求路由到音乐短片工作流。本路线专注于从故事到歌词到歌曲。通用音乐创作器仍是混合或不确定音乐请求的兜底。
输入与默认值
硬性输入是：
- 一个场合；
- 一位收件人或受众；
- 值得写进歌里的真实故事细节；
- 必须出现的名字或词句；
- 歌曲使用的语言；
- 一个情感方向；
- 需要省略的隐私细节。
只询问缺失的硬性输入。复用已知的曲风、氛围、配器、节拍感和演唱方向偏好。歌词写作、标题起草、段落规划和创意方向都是免费的准备工作；只有音乐生成是付费的。
黄金路径
- 收集输入信息。记录场合、收件人、关系、主角、转折点、难忘细节、必须出现的名字或词句、语言、情感方向、必须包含的事实以及需要省略的隐私细节。构建故事映射：主角、关系、转折点、难忘细节、核心信息、副歌、情感弧线和结尾。
- 免费起草创意方向。写出标题、带段落结构的完整歌词和一张制作卡：曲风、氛围、配器、节拍感和演唱方向。在任何付费调用之前，向用户展示必须保留的事实和歌词草稿以供确认。反复修改歌词和方向直到用户确认满意；此修改是免费的。
- 调用
beatra.models.list并传入{"capability":"text_to_music"}查看当前音乐目录。确认实时的提示词、歌词和标题字符限制、支持的语言、控制项和计价基础。除非用户已选定一个具体的可用模型，否则保持模型为auto。数值估计是暂定的，需要以实时目录事实为准。 - 冻结已确认的标题、已确认的歌词、制作提示词、模型行为和一个不透明且稳定的
client_request_id。展示确切的付费边界：一次基于已确认输入的歌曲生成。只调用随包scripts/mcp_client.py：MCP 工具名是 CLI 参数，其参数是标准输入上的 JSON。例如：
text
printf '%s' '{"prompt":"Warm acoustic pop, gentle guitar and piano, heartfelt mid-tempo vocal delivery.","lyrics":"[Verse 1]\n...approved lyrics...\n[Chorus]\n...approved lyrics...","title":"Approved Title","client_request_id":"opaque-song-id"}' | python3 scripts/mcp_client.py call beatra.music.generate
不要配置、调用或使用宿主 Beatra Connector。不要使用 REST/OpenAPI 回退。恰好提交一次 beatra.music.generate。
5. 立即记录返回的任务 ID，并用 beatra.tasks.get 轮询同一任务直到终态。交付每一个返回的音频素材或链接，只报告实际返回的任务状态、解析后的模型、片段数量、时长、用量和 billing.net_charged_credits。审阅可访问的结果，检查故事准确度、名字发音、副歌、歌词呈现、情感、编曲、演唱效果、音频质量和时长。说明宿主 Agent 能和不能查看的内容。
付费变更、恢复与取消
歌曲生成是一个付费阶段。更换标题、歌词、制作提示词、曲风、氛围、模型或控制，都属于新的逻辑付费工作，配以新的 ID 和新的确认。在唯一一次确认生成之前修改歌词是免费的；在付费运行后用变更输入重新生成属于新的付费请求。
如果创建响应丢失，只用相同的阶段 ID 重放字节完全一致的冻结负载。如果任务 ID 丢失，调用 beatra.tasks.list 查找相关能力，用 beatra.tasks.get 检查可能的候选任务，并对照该阶段的私有账本确认后再考虑相同重试。排队和运行中是进度状态，不是失败。在规划变更工作之前先恢复原阶段；绝不重复付费提交，也不猜测其扣费或退款。
只有当用户要求取消时才调用 beatra.tasks.cancel。调用一次，并用 beatra.tasks.get 确认最终的终态。409 表示取消未确认，因此继续轮询同一任务，不要创建替代工作。
工具返回积分不足时：把工具返回的原文整段交给用户，链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。
用户问还剩多少积分时，调用 beatra.wallet.get。问扣了什么时，调用 beatra.wallet.ledger。两者只读。不要发明账户余额或充值工具。不要把 wallet.get 当成每次付费提交前的必做步骤。
按任务查阅参考
- 在收集故事简报、起草歌词和方向、核对实时模型事实、构造确切负载、轮询、恢复、取消或审阅故事准确度和演唱效果时，阅读 故事到歌曲工作流。
- 仅当授权或共享凭据需要处理时，阅读 安装与授权。
- 关于非计费、尽力而为的安装登记步骤，阅读 安装登记。
- 关于共享的终态任务和素材语义，阅读 任务与结果；关于返回的计费或错误详情，阅读 计费、错误与恢复。
- 当随包客户端无法连接时，阅读 随包 MCP Client 连接诊断。不要配置宿主 Connector。
- 关于更新保证和控制方式，阅读 自动更新与安全。
- 仅当用户要求移除本包或共享凭据时，阅读 卸载与断开连接。
运行时与安全自动更新
每次 Beatra 操作都使用或调用随包 scripts/mcp_client.py。在每个安装中静默地每 24 小时最多检查一次更高版本。更高版本可用时，不另行确认而自动安装。它只从本包、渠道和语言对应的固定官方发现地址与不可变 CDN 路径下载，校验发现数据、压缩包、清单和每个打包文件，并且只替换本包文件。
更新检查、下载、校验、替换、回滚和恢复失败时，现有安装仍可使用，原本请求的命令继续执行。更新失败不会授权另一项付费请求。设置会在此安装中持续生效。
python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check
--auto off 禁用静默检查，--auto on 恢复静默检查，--check 报告官方可用版本而不替换文件。
