Suno歌词成曲
把用户已经写下的歌词材料整理成结构清晰的歌曲方向，并生成一首可以试听的 Suno 歌曲。完整歌词、歌词草稿、零散歌词行或一个已有 hook 都可以直接开始。复用对话中已经出现的歌词和决定，沿最短路径完成成曲。
确定歌词可以如何调整
用户只要整理歌词、没有要求生成时停在歌词。Beatra 生成走 beatra.music.generate；不要登录 Suno 账号。
- 保留原词： 保持歌词正文中的每个字符、标点、完整歌词行和原始顺序不变。可以增加简短段落标签，并调整完整歌词行周围的空行，但不改写歌词。
- 优化歌词： 在严格保留所有必留句的前提下，改善措辞、节奏、押韵、重复、hook 强度和段落平衡。用户要求润色、改写或优化时，已经授予编辑许可。
用户要求编排、作曲、生成或用现有歌词做歌，但没有要求修改文字时，默认保留原词，不再询问模式。只有请求明确授予编辑许可时才优化歌词。
完整编辑规则参见歌词接收与模式。在最终制作卡中展示完整建议歌词和重要修改摘要。只有用户明确要求先审歌词或暂不付费时，才把歌词审阅拆成更早的独立步骤。
整理成可以制作的歌曲版本
硬输入是完整或零散歌词。先标主歌、副歌和桥再付费。自定义歌词必须带段落标签。
优先根据歌词推断合理默认值，不把流程变成问卷。提出标题、段落结构、曲风、情绪、速度感、乐器、编曲推进、段落对比和人声方向。只有缺失选择会实质改变已接受歌词或付费请求时才询问。
Suno 的精确请求参见歌曲方向与请求。制作路径始终为：
model: "suno-5.5"；- 1 至 1000 个字符的音乐方向
prompt，其中不放歌词正文； - 已确认且非空、最多 5000 个字符的
lyrics； instrumental: false；- 非空且最多 80 个字符的
title； model_options.suno.custom_mode: true；- 一个稳定、不透明、长度为 1 至 128 个字符的
client_request_id。
把发音、声线角色、对唱、群唱、口音和精确时长作为制作方向与成品审听目标。只有用户选择单一男声或女声主唱时才使用 vocal_gender 控制；其他角色分配通过歌词和音乐方向表达。
一次确认，一次执行
先整理骨架与段落标签，取得用户对歌词的确认，再出示一张成曲确认卡。不要整首自动重做。
策划、歌词整理、段落结构和音乐方向不会调用付费音乐工具。生成前，展示一张易读的最终制作卡，包含完整歌词、标题、音乐方向、suno-5.5、相关选项，以及下一步会产生付费调用的事实。用户明确同意这张完整制作卡，就代表授权一次生成；不要再要求第二次确认或额外说一次“生成”。
只有制作卡定稿后才创建请求标识。通过 beatra.music.generate 提交一次，保留返回的 task_id，并用 beatra.tasks.get 轮询同一任务。响应缓慢或结果不确定属于恢复流程，不是新建歌曲任务的理由。遵循工作流与审阅和恢复。
使用随包 MCP Client
所有远程 MCP 操作只能使用本 Skill 随包提供的 scripts/mcp_client.py。MCP 工具名作为 CLI 参数传入，JSON 参数通过 stdin 发送。不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级或回退方案。精确命令与排查方法参见随包 MCP Client 连接诊断。
只有用户询问当前可用性、兼容性、模型比较或价格时才调用 beatra.models.list。不要静默把 Suno 5.5 替换成其他模型。
交付歌曲与恢复任务
成功后，按照返回顺序展示 task.output.clips 中的每个实际条目。使用 clip.audio.url 作为可播放链接，使用 clip.audio.artifact_id 作为资产 ID，使用 clip.audio.duration_seconds 作为时长；只有响应实际返回时才展示 clip.title 和 clip.lyrics。报告真实任务 ID 与 billing.net_charged_credits，不要根据 clip 数量或耗时推断费用。只有宿主能够实际播放音频时，才评价 hook、咬字、段落对比和情绪表现。生成的所有资产也可以前往 beatra.ai 查看和管理。
如果用户在结果出来后更改歌词、标题、音乐方向、模型或选项，先展示修改后的完整制作卡，再开始新的付费工作。任务 ID 丢失、提交结果不确定、取消、失败或成品审听时，遵循审阅和恢复。
按任务查阅资料
- 保留原词、优化歌词、必留句和段落结构：歌词接收与模式
- 曲风、编曲、人声和精确 Suno 参数：歌曲方向与请求
- 准备、确认、提交和跟踪的完整流程：工作流
- 任务丢失、取消、终态结果和审听：审阅和恢复
- 首次安装或授权过期：安装与授权
- 随包 MCP Client 命令与排查：随包 MCP Client 连接诊断
- 安装注册：安装注册
- 任务查询与结果字段：任务与结果
- 余额、校验、提交状态不确定与错误：计费、错误与恢复
- 断开当前安装：卸载与断开连接
- 官方来源、完整性校验、恢复和更新控制：自动更新与安全
运行与安全自动更新
执行普通 Beatra 命令前，随包客户端可能静默检查当前安装渠道是否有更高版本，每 24 小时最多一次。发现更高版本时，它会在不另行确认的情况下自动安装。更新只从固定的 Beatra 官方发现地址和不可变 CDN 路径下载；替换前会校验压缩包、清单和每个包内文件，并且只替换当前安装中本包拥有的文件。它会拒绝重定向、降级、不安全压缩包、意外目标，以及不同的包、渠道或语言。英文官方安装始终保持 canonical/en，SkillHub 中文安装始终保持 skillhub/zh-CN。如果更新或恢复任一步骤失败，当前安装仍可使用，用户原本请求的命令也会继续执行。
以下设置对当前安装持续生效：
python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check
第一条命令关闭静默检查，第二条重新开启，第三条只检查官方可用版本而不修改文件。完整行为参见自动更新与安全。