天谱乐音乐生成

这个 skill 是纯内容生成能力，负责天谱乐的纯音乐/歌曲/歌词任务创建、状态查询和本地下载，不负责对象存储上传或分享链接生成。

适用场景：

• 用户明确指定使用天谱乐生成纯音乐、歌曲或歌词
• 多媒体工作流需要一个音乐生成供应商
• 已有 item_id，只需要查询进度或下载本地结果

使用脚本

脚本位于 skill 目录内的 scripts/，运行时始终使用绝对路径。

设 TP_SKILL_DIR 为 .claude/skills/tianpuyue_music 的绝对路径：

• 纯音乐生成（完整流程）：uv run --python python $TP_SKILL_DIR/scripts/generate_music.py --prompt "..." --name "忧伤钢琴曲"
• 歌曲生成（完整流程）：uv run --python python $TP_SKILL_DIR/scripts/generate_song.py --prompt "..." --name "夏日海边"
• 歌词生成（完整流程）：uv run --python python $TP_SKILL_DIR/scripts/generate_lyrics.py --prompt "..." --name "青春离别"
• 纯音乐状态查询：uv run --python python $TP_SKILL_DIR/scripts/query_music_status.py --item-id <ID>
• 歌曲状态查询：uv run --python python $TP_SKILL_DIR/scripts/query_song_status.py --item-id <ID>
• 歌词状态查询：uv run --python python $TP_SKILL_DIR/scripts/query_lyrics_status.py --item-id <ID>

脚本参数

纯音乐生成

歌曲生成

歌词生成

输出约定

• 本地输出目录（相对于 OUTPUT_ROOT，默认为项目根目录）：
  • outputs/tianpuyue/music/
  • outputs/tianpuyue/songs/
  • outputs/tianpuyue/lyrics/
• 纯音乐/歌曲输出 JSON 至少包含：
  • type — music / song
  • provider — tianpuyue
  • item_id
  • local_path
  • source_url
• 歌词输出 JSON 至少包含：
  • type — lyrics
  • provider — tianpuyue
  • item_id
  • local_path
  • title
  • lyric

配置

• 环境变量：TIANPUYUE_API_KEY（必需，未设置时直接报错）
• 环境变量：TIANPUYUE_CALLBACK_URL（可选，轮询模式下使用占位值即可）
• 环境变量：OUTPUT_ROOT（可选，输出根目录，支持 ~ 展开，默认为用户主目录）

协作方式

• 如果用户只要求生成并得到本地文件，本 skill 可直接完成
• 如果用户还需要可访问链接，应由后续的交付环节继续处理
• 当用户未指定供应商时，是否使用天谱乐由多媒体内容生成 Agent 的预设策略决定