爆款裂变SKILL
🚨 强制前置校验流程
所有 KickArt 操作必须先完成 CLI 可用性与 OAuth 登录态检查：
- KickArt CLI 校验
- 读取
references/CLI前置校验指南.md。 - 使用
command -v npm检查npm exec是否可用。所有命令通过npm exec -y --package @volcengine/kickart-open-mcp@1.0.x kickart-open-cli调用固定版本，无需全局或项目级安装。 - 执行
npm exec -y --package @volcengine/kickart-open-mcp@1.0.x kickart-open-cli auth_token >/dev/null检查登录态，禁止展示、记录或持久化 token。 - 尚未登录或凭据失效时，执行
npm exec -y --package @volcengine/kickart-open-mcp@1.0.x kickart-open-cli auth_login获取授权链接并展示给用户；该命令立即返回，不会轮询授权状态。 - 等待用户明确确认已完成网页授权后，单次执行
npm exec -y --package @volcengine/kickart-open-mcp@1.0.x kickart-open-cli auth_complete获取 token 并完成登录，再次检查登录态；禁止自动轮询或在用户确认前执行。 - npm exec 下载包失败或 CLI 仍不可用时，反馈脱敏后的 npm 错误并终止操作。
- 不要求用户提供长期密钥，不读取或回显 OAuth token，禁止直接请求 OpenAPI。
- 读取
🎯 意图识别与任务执行指南（基于对话历史自动识别）
结合当前用户输入和历史记录判断意图后，必须严格读取并遵循对应的执行依据指南，不可凭空猜测执行步骤。
| 任务类型 | 触发意图与关键词 | 执行依据 (强制首要读取) | 输出要求 | 前置要求 |
|---|---|---|---|---|
| 进度查询 | 【最高优先级】用户提及「查询进度」「查看结果」「生成怎么样了」「好了吗」或查询某个具体任务ID的状态时。 | 读取 references/任务查询指南.md，执行 npm exec -y --package @volcengine/kickart-open-mcp@1.0.x kickart-open-cli query_task_v2 --task-id <ID> --source ad_variations --auto-publish true。 | 解析 stdout JSON 并输出当前状态或结果。 | 需从会话上下文获取对应任务 ID；无有效 ID 时直接告知用户未查询到相关任务。 |
| 独立素材入库 | 用户明确要求「上传到 KickArt」「创建媒资」「保存到素材库」或「查询媒资」，且不是在为生成任务提供输入素材 | 读取 references/素材上传指南.md，执行 npm exec -y --package @volcengine/kickart-open-mcp@1.0.x kickart-open-cli material_pipeline_v2 --file-path <绝对路径> | 从 stdout JSON 输出 created.media_id 和 origin_url | 生成任务中的图片和视频不得触发本流程；本地素材由提交命令自动上传 |
| 爆款裂变 | 用户提及「爆款裂变」、「爆款克隆」、「复制视频」、「克隆视频」、「同款视频」、「生成同款」、「裂变视频」等，或者表达希望制作和某热门视频一样的内容的等价意图时。 | 读取 references/爆款裂变指南.md，执行 npm exec -y --package @volcengine/kickart-open-mcp@1.0.x kickart-open-cli submit_viral_task_v2 | 解析 stdout JSON 并输出任务 ID；后续通过 query_task_v2 获取结果 | 必须严格按照指南 Phase 0 逐步收集参考视频、商品信息和语言；角色图片、场景图片、创意提示词、字幕、字幕擦除、明水印等可选参数也必须逐一询问。完成信息收集后必须展示成片信息，并进行二次确认与合规提示，未确认前严禁提交。 |
| 视频参考 | 用户主动提供参考视频、视频链接，或表示要上传视频时 | 读取 references/视频参考指南.md，校验并记录本地绝对路径或公网 URL；不预先上传 | 获取可直接传给 submit_viral_task_v2 --ref-video 的素材值 | 用户触发爆款裂变意图时首要的前置步骤 |
| 数字形象 | 用户提及「添加模特」「自定义角色」「模特出镜」「数字人」「自定义模特」时 | 读取 references/数字形象指南.md，校验并记录本地绝对路径或公网 URL；不预先上传 | 获取可直接传给 submit_viral_task_v2 --model-images 的图片列表 | 用户在裂变任务中需要指定角色出镜时触发 |
⚠️ 错误处理规范
所有错误必须明确告知原因和可执行解决方案，禁止模糊提示！！！
通用错误码
| 错误码 | 错误类型 | 错误描述 | 详细说明 | 用户处理建议 |
|---|---|---|---|---|
| 0 | Success | 任务成功 | 任务处理完成，结果已生成 | - |
| 1000 | AsyncTaskRunning | 任务运行中 | 任务正在处理，请稍后轮询结果 | - |
| 1300 | AuthFailed | OAuth 认证失败 | 登录凭据无效或已过期 | 依次执行 auth_login 获取授权链接、等待用户完成网页授权、执行 auth_complete 完成登录；禁止自动重试付费提交，重新提交前须再次展示成片信息并取得二次确认 |
| 1400 | ParamErr | 参数错误 | 请求中包含无效或缺失的参数 | 请对照文档检查请求体结构、字段类型和必填项 |
| 1401 | ConcurrentErr | 并发超限 | 当前的并发请求数超过了约定的上限 | 请降低请求频率，或联系商务代表调整并发额度 |
| 1402 | InsufficientPoints | 创点不足 | 账户余额不足以支付本次任务消耗 | 请前往 创点充值页面 充值创点或升级套餐 |
| 1403 | QuotaErr | 无权限 | 套餐不足 | 请联系管理员开通，或访问 Kickart 套餐购买页面 订阅套餐 |
| 1404 | QuotaErr | 无权限 | 套餐不足 | 请联系管理员开通，或访问 Kickart 套餐购买页面 订阅套餐 |
| 1410 | TemplateIdNotExist | 模板不存在 | 请求的 template_id 无效或对应的模板未上线 | 请确认模板ID是否正确（当前模板ID: 978755330） |
| 1412 | ImageFormatErr | 图片格式错误 | 输入的图片格式不受支持或文件已损坏 | 建议使用 JPEG 或 PNG 格式 |
| 1413 | InvalidMediaUrlErr | 媒体 URL 无效 | 媒体URL无法访问 | 请确保 URL 是公网可达的，且未过期；推荐接入火山对象存储 |
| 1418 | InvalidDurationBillingErr | 无效时长参数 | 入参时长参数不满足接口入参要求 | 请检查参考视频时长是否满足要求（>5秒且≤60秒） |
| 1422 | GetDouDianProductInfoError | 商品信息获取失败 | 服务端无法从提交的抖店/抖音链接或商品ID解析商品信息 | 请确认链接关联了可访问的商品，或改用商品ID、商品图片；修改后重新展示成片信息并取得二次确认，禁止自动重试 |
| 1423 | VideoResolutionError | 参考视频分辨率错误 | 参考视频分辨率不符合要求 | 请检查视频分辨率是否≥480p |
| 1424 | VideoDurationError | 参考视频时长错误 | 参考视频时长不符合要求 | 请检查视频时长是否在>5秒且≤60秒范围内 |
| 1425 | VideoFormatError | 参考视频格式错误 | 参考视频格式不支持 | 请检查视频格式是否为MP4或MOV |
| 1426 | VideoSizeError | 参考视频大小错误 | 参考视频文件大小超出限制 | 请检查视频大小是否≤50MB |
| 1427 | RefVideoError | 参考视频链接错误 | 参考视频链接无效或无法访问 | 请检查您提供的视频URL是否正确 |
| 1428 | LanguageEnumError | 语言枚举值错误 | 请求的语言参数不在支持的枚举列表内 | 请检查语言参数是否为以下有效值：zh、en、en-us、pt-br、ja、es-mx、id、ms、tl |
| 1450 | InputValidationErr | 模板入参校验失败 | message会列出多个字段与规则 | 按提示修正后重新展示成片信息并取得二次确认，禁止自动重试 |
| 1500 | InternalErr | 内部错误 | 服务端发生未知错误 | 请记录 request_id 并联系技术支持 |
| 1600 | AsyncTaskNotExist | 任务不存在 | task_id无效 | 请检查任务ID是否正确 |
| 1601 | AsyncTaskTimeoutErr | 任务超时 | 任务执行超过系统设定的最长处理时间（当前为1小时） | 请联系技术支持核实任务状态；如需新建任务，必须重新展示成片信息并取得二次确认 |
| 2000 | AsyncTaskFailed | 任务失败 | 任务在执行过程中失败 | 请查看message中的具体失败原因；如需修正后新建任务，必须重新展示成片信息并取得二次确认 |
| x01401 | TokenFailed | 令牌获取失败 | 当前用户没有套餐权限 | 请联系管理员开通，或访问 Kickart 套餐购买页面 订阅套餐 |