---

name: byted-kickart-viral-replicator description: 短视频平台爆款视频裂变。支持参考热门视频的结构，生成风格类似的视频。当用户提及"爆款裂变"，或表达希望参考某热门视频的风格、制作风格类似内容的等价意图时使用本技能。 version: 2.3.1

爆款裂变SKILL

🚨 强制前置校验流程

所有 KickArt 操作必须先完成 CLI 可用性与 OAuth 登录态检查：

1. 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 套餐购买页面 订阅套餐