Byted Kickart Viral Replicator

SKILL.md

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

# 爆款裂变SKILL

## 🚨 强制前置校验流程（必须按顺序执行，任意不通过直接终止流程）
所有用户请求必须先完成以下4步校验，不得跳过：
1. **模型输入能力校验**
   - 读取openclaw.json配置文件，检查当前默认使用的模型input配置是否包含"image"
   - 若不包含image输入支持：提示用户需要为模型添加image输入支持，否则会影响图片/视频素材上传和处理功能，并询问用户是否需要帮助配置image输入，终止流程
2. **火山鉴权校验**
   - 读取`./references/火山鉴权指南.md`，检查本地是否已配置环境变量
   - 未配置：引导用户按指南完成密钥配置，终止流程
3. **套餐有效性校验**
   - 读取`./references/套餐开通指南.md`，调用套餐查询接口检查用户套餐是否在有效期内、创点余额充足
   - 套餐失效/余额不足：引导用户按指南升级/充值套餐，终止流程

## 🎯 意图识别与任务执行指南（基于对话历史自动识别）
结合当前用户输入和历史记录判断意图后，**必须严格读取并遵循对应的执行依据指南**，不可凭空猜测执行步骤。

| 任务类型 | 触发意图与关键词 | 执行依据 (强制首要读取) | 输出要求 | 前置要求 |
|---------|----------------|----------------------|---------|---------|
| **进度查询** | 【最高优先级】用户提及「查询进度」「查看结果」「生成怎么样了」「好了吗」或查询某个具体任务ID的状态时。 | 读取 `references/任务查询指南.md`。<br>⚠️**绝对禁止**不阅读指南直接调用任何脚本，严禁使用未经指南允许的内部 `poll` 命令！ | 输出当前任务执行状态（如「任务已完成」、「任务执行中」等），确认是否需要调整 | 需从会话上下文持久化存储中获取对应任务ID，无有效ID时直接告知用户未查询到相关任务 |
| **素材上传** | 用户提及「上传素材」「添加图片」「添加视频」「自定义素材」 | 读取 `references/素材上传指南.md` | 输出上传成功的素材URL列表，确认素材完整性后询问下一步需求 | 任务提交成功后自动将会话ID、素材列表持久化存储到会话上下文 |
| **素材分析** | 用户提及「素材分析」「分析商品」「拉取素材」或者直接发送「抖音商品详情链接」 | 读取 `references/素材分析指南.md` | 输出商品主图/详情图/视频数量、核心卖点、基础商品信息，确认结果准确性后询问下一步需求 | 任务提交成功后自动将Task ID持久化存储到会话上下文 |
| **创意分析** | 用户提及「创意分析」「卖点分析」「受众分析」「创作方向」 | 读取 `references/创意分析指南.md` | 输出目标受众、推荐视频规格、核心卖点提炼、创意方向建议，确认结果准确性后询问下一步需求 | 任务提交成功后自动将Task ID持久化存储到会话上下文 |
| **爆款裂变** | 用户提及「爆款复刻」「爆款裂变」「爆款克隆」「复制视频」「克隆视频」「同款视频」「生成同款」「裂变视频」等，或者表达希望制作和某热门视频一样的内容的等价意图时。 | 读取 `references/爆款裂变指南.md` | 输出裂变成片视频下载链接，确认结果并询问下一步需求 | 需要先完成创意分析，获取创意分析结果文件路径，以及用户提供的参考视频 |
| **视频参考** | 用户主动提供参考视频、视频链接，或表示要上传视频时 | 读取 `references/视频参考指南.md` | 获取符合规范的参考视频链接或素材ID，为裂变做准备 | 用户触发爆款裂变意图时首要的前置步骤 |
| **数字形象** | 用户提及「添加模特」「自定义角色」「模特出镜」「数字人」「自定义模特」时 | 读取 `references/数字形象指南.md` | 获取符合规范的角色图片媒资ID，为裂变提供自定义模特 | 用户在裂变任务中需要指定角色出镜时触发 |

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

| 错误码 | 错误描述 | 详细说明 | 用户处理建议 |
| --- | --- | --- | --- |
| 0 | 无返回值 | 接口调用成功，但服务返回结果为空 | 请稍后重试，如问题持续请联系火山技术支持 |
| 1400 | ParamErr参数错误 | 参数错误 | 联系技术支持 |
| 1402 | 创点不足 | 调用接口时，用户账户的创点额度不足 | 请前往 [创点充值页面](https://console.volcengine.com/kickart/fusion/setting/combobuy?tab=additionalCombo) 充值创点或升级套餐 |
| 1410 | 服务ID不存在 | 调用接口时，输入参数中包含了不存在的服务ID | | 升级SKILL |
| 1411 | 输入分辨率错误 | 调用接口时，输入参数中的图片或视频分辨率不符合要求 | 请检查素材分辨率是否符合规格要求（如≥480p） |
| 1412 | 图片格式错误 | 调用接口时，输入参数中包含了非支持的图片格式 | 请检查图片格式是否为 jpg、png 等支持的格式 |
| 1413 | 无效的媒体URL错误 | 调用接口时，输入参数中包含了无效的媒体URL | 请检查您提供的URL是否正确，避免包含特殊字符或格式错误 |
| 1414 | 输入包含敏感信息错误 | 调用接口时，输入参数中包含了敏感信息，如个人隐私数据等 | 暂不可生成带人物的营销视频，请等待后续版本更新 |
| 1415 | 输出包含敏感信息错误 | 调用接口时，服务返回结果中包含了敏感信息，如个人隐私数据等 | 暂不可生成带人物的营销视频，请等待后续版本更新 |
| 1416 | 输入媒体数量错误 | 用户输入的素材数量超过限制 | 提供的媒体素材数量超出限制，多出的素材可能不会使用 |
| 1417 | 大模型调用错误 | 模型调用出错，通常是输入参数错误 | 媒体素材处理存在问题，请重新尝试，如问题持续请联系火山技术支持 |
| 1418 | 时长计费参数错误 | 提交时入参时间有问题 | 要求的成片时长不符合技能要求，请按照0-60s的时长限制提交制作需求，如问题持续请联系火山技术支持 |
| 1501 | 用户套餐过期 | 调用接口时，用户套餐已过期 | 请前往 [套餐开通页面](https://console.volcengine.com/kickart/fusion/setting/combobuy?tab=combo) 开通套餐 |
| 100010 | 签名验证失败 | AK/SK签名验证失败 | 请检查您提供的火山鉴权AK/SK是否正确，可访问[火山引擎控制台](https://console.volcengine.com/iam/keymanage)确认 |
| 100013 | 缺少服务权限 | 缺少iccloud\_muse服务的RegisterArkClawCombo权限 | 您的企业账号未开通Kickart权限，请联系火山主账号管理员为您开通，或详询火山技术支持 |
| x01001 | AK/SK未配置 | 用户未配置AK/SK | 请输入火山鉴权的AK/SK，可访问[火山引擎控制台](https://console.volcengine.com/iam/keymanage)获取 |
| x01010 | 有效套餐缺失 | 素材上传出现错误，通常是套餐原因 | 请前往 [套餐开通页面](https://console.volcengine.com/kickart/fusion/setting/combobuy?tab=combo) 开通套餐 |
| A0101 | Session元数据格式错误 | 接口传入的Session元数据格式错误 | 根据 `references/消费成片指南.md` 校验当前主会话，确保传入的Session元数据格式正确 |
| 其他 | \- | 未明确列出的其他错误情况 | 稍后重试，如问题持续请联系火山技术支持 |