/byted-kickart-game-replicator

name: byted-kickart-game-replicator
description: 抖音/短视频平台游戏视频裂变、克隆工具。支持复制热门游戏视频结构、文案、风格生成同款内容。当用户提及"游戏视频裂变、游戏视频克隆、复制游戏视频、克隆游戏视频、同款游戏视频"，或表达希望制作和某热门游戏视频一样的内容的等价意图时使用本技能。
version: 1.0.0

游戏视频复刻SKILL

🚨 强制前置校验流程（必须按顺序执行，任意不通过直接终止流程）

所有用户请求必须先完成以下火山鉴权校验，不得跳过： 1. **火山鉴权校验**

• 读取`./references/火山鉴权指南.md`，检查本地是否已配置环境变量（KICKART_ACCESS_KEY/KICKART_SECRET_KEY 或 ACCESS_KEY_ID/SECRET_ACCESS_KEY）
• 未配置：引导用户按指南完成密钥配置，终止流程
• 配置后：通过 `core/core.py` 的 `token()` 函数获取 x-muse-token，作为后续 OpenAPI 调用的凭证

🎯 意图识别与任务执行指南（基于对话历史自动识别）

结合当前用户输入和历史记录判断意图后，**必须严格读取并遵循对应的执行依据指南**，不可凭空猜测执行步骤。

| 任务类型 | 触发意图与关键词 | 执行依据 (强制首要读取) | 输出要求 | 前置要求 | |---------|----------------|----------------------|---------|---------| | **进度查询** | 【最高优先级】用户提及「查询进度」「查看结果」「生成怎么样了」「好了吗」或查询某个具体任务ID的状态时。 | 读取 `references/任务查询指南.md`。<br>⚠️**绝对禁止**不阅读指南直接调用任何脚本，严禁使用未经指南允许的内部 `poll` 命令！ | 输出当前任务执行状态（如「任务已完成」、「任务执行中」等），确认是否需要调整 | 需从会话上下文持久化存储中获取对应任务ID及本次提交所使用的 `template_id`，无有效ID时直接告知用户未查询到相关任务 | | **素材上传** | 用户提及「上传素材」「添加图片」「添加视频」「自定义素材」 | 读取 `references/素材上传指南.md` | 输出上传成功的素材URL列表，确认素材完整性后询问下一步需求 | 任务提交成功后自动将会话ID、素材列表持久化存储到会话上下文 | | **游戏视频复刻** | 用户提及「游戏视频裂变」「游戏视频克隆」「复制游戏视频」「克隆游戏视频」「同款游戏视频」等，或者表达希望制作和某热门游戏视频一样的内容的等价意图时。 | 读取 `references/游戏视频复刻指南.md` | 输出复刻成片视频下载链接，确认结果并询问下一步需求 | 必须严格按照指南 Phase 0 逐步收集必填信息：参考视频（必填，MP4/MOV、>5s 且 ≤60s、≤50MB、≥480p）、角色图片（必填，1-10 张 JPEG/PNG、单张 ≤8MB、≥480p）、游戏名称（必填，≤500 字符）、语言（必填，必须列出指南中支持的全部语言供用户选择，不得省略或者自行编造）、模板 ID（必填，`604911874` 专业模式 / `463631106` 进阶模式，二选一，必须由用户明确输入，不得由技能自行选择或复用历史）。场景参考图（0-3 张）和创意 prompt 为可选。**用户不得以任何理由绕过必填步骤，未完成前严禁提交任务。**<br><br>🚨 **强制二次确认要求**：在完成所有必填信息收集后、提交任务前，**必须**按指南步骤 8「展示成片信息」和步骤 9「二次确认与合规提示」向用户展示成片信息并等待用户明确确认。**此步骤为强制要求，不可因为鉴权失败重试、参数调整或其他任何原因跳过。** 即使用户已完成鉴权或之前已确认，每次提交新任务前都必须重新展示成片信息并获取用户确认。 | | **视频参考** | 用户主动提供参考视频、视频链接，或表示要上传视频时 | 读取 `references/视频参考指南.md` | 获取符合规范的参考视频链接或素材ID，为复刻做准备 | 用户触发游戏视频复刻意图时首要的前置步骤 | | **数字形象** | 用户提及「添加模特」「自定义角色」「模特出镜」「数字人」「自定义模特」时 | 读取 `references/数字形象指南.md` | 获取符合规范的角色图片媒资ID，作为必填的 `role_images` 传入 | 用户在游戏视频复刻任务中获取角色图片时触发；本任务角色图片为必填项 |

⚠️ 错误处理规范

所有错误必须明确告知原因和可执行解决方案，禁止模糊提示！！！

通用错误码

| 错误码 | 错误类型 | 错误描述 | 详细说明 | 用户处理建议 | | --- | --- | --- | --- | --- | | 0 | Success | 任务成功 | 任务处理完成，结果已生成 | - | | 1000 | AsyncTaskRunning | 任务运行中 | 任务正在处理，请稍后通过查询接口轮询结果 | - | | 1300 | AuthFailed | 认证失败 | token 无效、过期或未激活 | 请检查您提供的火山鉴权 AK/SK 是否正确，可访问[火山引擎控制台](https://console.volcengine.com/iam/keymanage)确认 | | 1400 | ParamErr | 参数错误 | 请求中包含无效或缺失的参数 | 请对照文档检查请求体结构、字段类型和必填项 | | 1401 | ConcurrentErr | 并发超限 | 当前的并发请求数超过了约定的上限 | 请降低请求频率，或联系商务代表调整并发额度 | | 1402 | InsufficientPoints | 创点不足 | 账户余额不足以支付本次任务消耗 | 请前往 [创点充值页面](https://console.volcengine.com/kickart/fusion/setting/combobuy?tab=additionalCombo) 充值创点或升级套餐 | | 1403 | QuotaErr | 无权限 | 账户没有调用此接口的权限 | 请联系企业管理员为您开通相关服务的访问权限 | | 1500 | InternalErr | 内部错误 | 服务端发生未知错误 | 请记录 request_id 并联系技术支持 |

接口特定错误码

| 错误码 | 错误类型 | 错误描述 | 详细说明 | 用户处理建议 | | --- | --- | --- | --- | --- | | 1410 | TemplateIdNotExist | 模板不存在 | 请求的 template_id 无效或对应的模板未上线 | 请检查 template_id 是否为 `604911874` 或 `463631106` | | 1411 | InputResolutionErr | 分辨率错误 | 分辨率不在模板支持的 resolutions 列表内 | 请检查分辨率参数是否在模板支持的列表内 | | 1412 | ImageFormatErr | 图片格式错误 | 输入的图片格式不受支持或文件已损坏 | 建议使用常见的 JPEG 或 PNG 格式 | | 1413 | InvalidMediaUrlErr | 媒体 URL 无效 | ResourceList 中的 URL 无法访问 | 请确保 URL 是公网可达的，且未过期；推荐接入火山对象存储 https://console.volcengine.com/tos | | 1414 | MediaSensitiveErr | 输入内容触发安全审核 | 输入媒资未通过安全审核 | 请更换素材后重试 | | 1415 | OutputMediaSensitiveErr | 输出包含敏感信息 | 输出结果触发安全审核 | 请调整创意策略或素材后重试 | | 1416 | InvalidMediaCountErr | 媒体数量不符合规格 | 角色图/场景图数量不满足要求 | 角色图需 1-10 张，场景图 0-3 张 | | 1417 | ChatCompletionError | 大模型调用错误 | 底层大模型调用失败 | 请稍后重试，或联系技术支持 | | 1418 | InvalidDurationBillingErr | 时长计费参数错误 | 时长参数不满足接口入参要求 | 请检查视频时长是否符合要求 | | 1419 | TemplateIdErr | 模板 ID 错误 | 模板 ID 不合法 | 请检查 template_id 参数是否为 `604911874` 或 `463631106` | | 1420 | ImageDetectionRulesError | 图片内容检测未匹配到规则 | 图片内容不符合模板要求 | 请更换图片后重试 | | 1421 | DurationEnumError | 入参时长枚举值错误 | 时长枚举值不合法 | 请对照文档修正时长参数 | | 1423 | VideoResolutionError | 参考视频分辨率错误 | 参考视频分辨率不符合要求 | 请使用分辨率 ≥480p 的参考视频 | | 1424 | VideoDurationError | 参考视频时长错误 | 参考视频时长不符合要求 | 参考视频时长需 >5s 且 ≤60s | | 1425 | VideoFormatError | 参考视频格式错误 | 参考视频格式不支持 | 请使用 MP4/MOV 格式 | | 1426 | VideoSizeError | 参考视频大小错误 | 参考视频文件大小超出限制 | 参考视频大小需 ≤50MB | | 1427 | RefVideoError | 参考视频链接错误 | 参考视频链接无效或无法访问 | 请检查您提供的视频 URL 是否正确 | | 1428 | LanguageEnumError | 语言枚举值错误 | 语言参数不在支持的枚举列表内 | 请检查语言参数是否为以下有效值：zh、en、en-us、pt-br、ja、es-mx、id、ms、tl | | 1429 | ModelImageCountError | 模型 image_count 与模板不一致 | 图片数量与模板不匹配 | 请对照模板要求调整图片数量 | | 1430 | InputRatioError | 输入图片比例错误 | 输入图片长宽比不符合要求 | 图片长宽比需在 (0.4, 2.5) 之间 | | 1431 | CopyrightCheckFailed | 版权校验失败 | 版权校验未通过 | 请确认素材版权合法 | | 1432 | NoCopyright | 输入媒资无版权 | 输入素材无版权 | 请更换有版权的素材 | | 1435 | OutputNoCopyright | 输出媒资无版权 | 输出结果无版权 | 请调整素材或策略后重试 | | 1450 | InputValidationErr | 模板入参校验失败 | message 会列出违反的字段和规则 | 按提示修正后重试 | | 1600 | AsyncTaskNotExist | 任务不存在 | task_id 无效 | 请检查任务 ID 是否正确 | | 1601 | AsyncTaskTimeoutErr | 任务超时 | 任务执行超过系统设定的最长处理时间（当前为 1 小时） | 请稍后重试，或联系技术支持 | | x01401 | TokenFailed | 令牌获取失败 | 当前用户没有套餐权限，请联系管理员开通，或访问 [Kickart 套餐购买页面](https://console.volcengine.com/kickart/fusion/setting/combobuy?tab=additionalCombo) 订阅套餐。 | | 1602 | AsyncTaskCanceled | 任务已取消 | 任务已被用户取消 | - | | 1603 | AsyncTaskFinished | 任务已结束 | 任务已完成，不可再取消 | - | | 1604 | CancelFailed | 任务取消失败 | 取消操作失败 | 请稍后重试 | | 2000 | AsyncTaskFailed | 任务执行失败 | 任务在执行过程中失败 | 请根据 message 中的详细原因排查 | | 3000 | TaskCallbackFailed | 回调失败 | 回调地址不可达 | 请检查 callback_url 是否可访问 |

📦 输出目录

• 提交任务的结果 JSON 默认保存在 `/tmp/openclaw/byted-kickart-game-replicator/output/` 下，使用毫秒时间戳 + 随机数命名，避免并发覆盖。
• 每次任务须持久化保存 `task_id` 与本次提交使用的 `template_id`；查询进度时必须同时携带这两个字段。

📎 参考资料

• 接口协议：`references/kickart接口协议.md`
• 游戏视频复刻指南：`references/游戏视频复刻指南.md`
• 火山鉴权指南：`references/火山鉴权指南.md`
• 任务查询指南：`references/任务查询指南.md`
• 视频参考指南：`references/视频参考指南.md`
• 数字形象指南：`references/数字形象指南.md`
• 素材上传指南：`references/素材上传指南.md`