Suno歌词成曲
把用户已经写下的歌词材料整理成结构清晰的歌曲方向，并生成一首可以试听的 Suno 歌曲。完整歌词、歌词草稿、零散歌词行或一个已有 hook 都可以直接开始。复用对话中已经出现的歌词和决定，沿最短路径完成成曲。
确定歌词可以如何调整
用户只要整理歌词、没有要求生成时停在歌词。Beatra 生成走 beatra.music.generate；不要登录 Suno 账号。
- 保留原词： 保持歌词正文中的每个字符、标点、完整歌词行和原始顺序不变。可以增加简短段落标签，并调整完整歌词行周围的空行，但不改写歌词。
- 优化歌词： 在严格保留所有必留句的前提下，改善措辞、节奏、押韵、重复、hook 强度和段落平衡。用户要求润色、改写或优化时，已经授予编辑许可。
用户要求编排、作曲、生成或用现有歌词做歌，但没有要求修改文字时，默认保留原词，不再询问模式。只有请求明确授予编辑许可时才优化歌词。
完整编辑规则参见歌词接收与模式（references/lyrics-intake-and-modes.md）。在最终制作卡中展示完整建议歌词和重要修改摘要。只有用户明确要求先审歌词或暂不付费时，才把歌词审阅拆成更早的独立步骤。
整理成可以制作的歌曲版本
硬输入是完整或零散歌词。先标主歌、副歌和桥再付费。自定义歌词必须带段落标签。
优先根据歌词推断合理默认值，不把流程变成问卷。提出标题、段落结构、曲风、情绪、速度感、乐器、编曲推进、段落对比和人声方向。只有缺失选择会实质改变已接受歌词或付费请求时才询问。
Suno 的精确请求参见歌曲方向与请求（references/song-direction-and-request.md）。制作路径始终为：
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 轮询同一任务。响应缓慢或结果不确定属于恢复流程，不是新建歌曲任务的理由。遵循工作流（references/workflow.md）与审阅和恢复（references/review-and-recovery.md）。
使用随包 MCP Client
所有远程 MCP 操作只能使用本 Skill 随包提供的 scripts/mcp_client.py。MCP 工具名作为 CLI 参数传入，JSON 参数通过 stdin 发送。不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级或回退方案。精确命令与排查方法参见随包 MCP Client 连接诊断（references/mcp-connection.md）。
只有用户询问当前可用性、兼容性、模型比较或价格时才调用 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、咬字、段落对比和情绪表现。生成的所有资产也可以前往 www.beatra.cn 查看和管理。
如果用户在结果出来后更改歌词、标题、音乐方向、模型或选项，先展示修改后的完整制作卡，再开始新的付费工作。任务 ID 丢失、提交结果不确定、取消、失败或成品审听时，遵循审阅和恢复（references/review-and-recovery.md）。
工具返回积分不足时：把工具返回的原文整段交给用户，链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。
用户问还剩多少积分时，调用 beatra.wallet.get。问扣了什么时，调用 beatra.wallet.ledger。两者只读。不要发明账户余额或充值工具。不要把 wallet.get 当成每次付费提交前的必做步骤。
按任务查阅资料
- 保留原词、优化歌词、必留句和段落结构：歌词接收与模式（references/lyrics-intake-and-modes.md）
- 曲风、编曲、人声和精确 Suno 参数：歌曲方向与请求（references/song-direction-and-request.md）
- 准备、确认、提交和跟踪的完整流程：工作流（references/workflow.md）
- 任务丢失、取消、终态结果和审听：审阅和恢复（references/review-and-recovery.md）
- 首次安装或授权过期：安装与授权（references/installation-and-auth.md）
- 随包 MCP Client 命令与排查：随包 MCP Client 连接诊断（references/mcp-connection.md）
- 安装注册：安装注册（references/installation-registration.md）
- 任务查询与结果字段：任务与结果（references/tasks-and-results.md）
- 余额、校验、提交状态不确定与错误：计费、错误与恢复（references/billing-errors-and-recovery.md）
- 断开当前安装：卸载与断开连接（references/uninstall-and-disconnect.md）
- 更新与安全：更新与安全（references/updates-and-security.md）
更新与安全
本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息
（中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn）。有新版本时，它下载官方发布包，
逐个文件校验 SHA-256，再替换本 Skill 自己的文件；你放进这个目录的其他文件不会被
改动。替换过程中断时，下次运行会自动恢复到替换前的状态。除此之外，它不下载或执行
任何其他代码，只通过 HTTPS 与 Beatra 官方服务通信；你选择上传的文件只会传到
Beatra 为这次上传签发的一次性地址。
关闭自动更新：python3 scripts/mcp_client.py update --auto off。关闭后，客户端每天
最多提示一次在你安装它的商店里更新的命令。详见更新与安全（references/updates-and-security.md）。
