技能介绍

为什么歌词生成要单独封装

用通用模型直接写歌词，常见问题是押韵不稳定、主歌副歌情绪脱节；用户只说一句“写得伤感一点”，结果容易变成“我很难过”这种空泛表达。更实际的麻烦是：创作指令、风格画布和付费前置条件揉在一起，调用方如果自己拼 prompt、改模板，反而会让结果更不可控。这个技能把歌词创作固定成一次 POST /api/v1/llm/invoke 同步调用：客户端只负责收集创作要素、处理支付重试，创作长文由服务端画布下发。

技能如何工作

核心能力是 同步歌词创作。用户给出主题、曲风、情绪或已有素材后，Agent 先把要素写入 payload.options，再调用上游接口。关键步骤包括：

收集创作要素：genre、theme、mood 必填；pov、length、language、material 可选。用户只给“怀旧”这类模糊词时，先追问具体场景，再填 material，避免服务端凭空扩写。
固定参数调用：model 固定为 ixhlink-skills-lyric-gen，capability 固定为 chat。payload.messages.content 写用户原始诉求即可，不要自行拼接创作模板或长 prompt。
付费重试：这是 Pay Skill。若返回 402，按响应中的 WeixinPay-Required、X-Payment-Id 和微信支付对象完成支付；成功后用相同 JSON body 重试，订单参数通过 Header 或 WeixinPay 传入，不要改业务字段。amount_fen = 0 时可直接调用。
结果整理：从 data.result.content 或 data.content 读取服务端下发的创作指令与歌词，按主歌、副歌、创作说明等区块交付，不要在客户端二次创作。

适用边界

适合有明确曲风、主题、情绪和使用场景的歌词需求，例如 pop、ballad、rap、guofeng、rock、electronic、rnb、generic，支持中文、中英混合和方言表达。它不是批量曲库检索，也不负责编曲、唱腔设计或商业版权清权；生成结果仍应人工筛选和润色。若 Agent 未安装 weixinpay extension，应提示暂不支持付费创作并终止流程；遇到 400、404、503 时，先检查要素是否齐全、模型是否启用，或稍后重试。