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。 ⚠️绝对禁止不阅读指南直接调用任何脚本，严禁使用未经指南允许的内部 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 为可选。用户不得以任何理由绕过必填步骤，未完成前严禁提交任务。 🚨 强制二次确认要求：在完成所有必填信息收集后、提交任务前，必须按指南步骤 8「展示成片信息」和步骤 9「二次确认与合规提示」向用户展示成片信息并等待用户明确确认。此步骤为强制要求，不可因为鉴权失败重试、参数调整或其他任何原因跳过。 即使用户已完成鉴权或之前已确认，每次提交新任务前都必须重新展示成片信息并获取用户确认。
视频参考	用户主动提供参考视频、视频链接，或表示要上传视频时	读取 references/视频参考指南.md	获取符合规范的参考视频链接或素材ID，为复刻做准备	用户触发游戏视频复刻意图时首要的前置步骤
数字形象	用户提及「添加模特」「自定义角色」「模特出镜」「数字人」「自定义模特」时	读取 references/数字形象指南.md	获取符合规范的角色图片媒资ID，作为必填的 role_images 传入	用户在游戏视频复刻任务中获取角色图片时触发；本任务角色图片为必填项

⚠️ 错误处理规范

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

通用错误码

错误码	错误类型	错误描述	详细说明	用户处理建议
0	Success	任务成功	任务处理完成，结果已生成	-
1000	AsyncTaskRunning	任务运行中	任务正在处理，请稍后通过查询接口轮询结果	-
1300	AuthFailed	认证失败	token 无效、过期或未激活	请检查您提供的火山鉴权 AK/SK 是否正确，可访问火山引擎控制台确认
1400	ParamErr	参数错误	请求中包含无效或缺失的参数	请对照文档检查请求体结构、字段类型和必填项
1401	ConcurrentErr	并发超限	当前的并发请求数超过了约定的上限	请降低请求频率，或联系商务代表调整并发额度
1402	InsufficientPoints	创点不足	账户余额不足以支付本次任务消耗	请前往 创点充值页面 充值创点或升级套餐
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	参考视频大小错误

📦 输出目录

• 提交任务的结果 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