pet-commerce-creator

name	pet-commerce-creator
description	自媒体创作者与电商运营在需要批量制作萌宠带货短视频时，使用此技能可自动完成爆款解析、多智能体协同创作脚本分镜，并调用API一键合成15-30秒9:16竖屏成品视频，全流程自动化助力高效涨粉与商品转化。
dependency	{"python":["coze-workload-identity>=1.0.0","yt-dlp>=2024.1.0"]}

萌宠带货内容智创工坊

任务目标

• 本技能用于：萌宠带货短视频全流程自动化创作，聚焦涨粉与商品转化
• 能力包含：
  • 爆款视频链接解析反推并自动入库
  • 基于知识库的创意拆解、脚本创作、分镜设计
  • 适配COZE API的分镜图片、字幕、音效素材生成
  • 支持全步骤互动评价与批量素材下载
  • COZE API全素材整合合成带货型成品视频
  • 全流程质检与数据迭代闭环
• 触发条件：用户萌宠短视频创作需求（故事/测评/科普/带货）、视频链接解析需求、知识库调取需求

前置准备

• 依赖说明：技能所需依赖包

  coze-workload-identity>=1.0.0  # COZE视频API调用
  yt-dlp>=2024.1.0                # 视频下载（支持抖音/B站/YouTube等）
  

• 凭证配置：
  • 已配置COZE视频API凭证：coze_video_api
  • 凭证Key格式：COZE_COZE_VIDEO_API_7598017404148613135
  • 使用方式：通过环境变量自动读取，无需手动填写
• 视频下载目录：./downloads（自动创建）

操作步骤

• 标准流程：

  1. 用户输入视频链接（抖音/B站/YouTube等）
  2. 调用scripts/video_downloader.py下载视频及元数据
  3. 调用scripts/coze_video_api.py处理素材上传、视频合成、状态轮询
  4. 基于知识库参考文档（references/agents-prompts.md）执行多智能体协同创作
  5. 各智能体生成独立输出物，带点赞/点踩/分享功能
  6. 成品视频支持高清下载、二次创作、平台发布

• 视频下载步骤：

  1. 用户输入视频链接（支持抖音/B站/YouTube/快手/小红书等主流平台）
  2. 调用scripts/video_downloader.py download <URL>下载视频
  3. 自动提取视频元数据（标题、时长、作者、观看数、点赞数等）
  4. 自动下载视频缩略图
  5. 输出视频文件路径及完整元数据JSON
  6. 爆款解析铲屎官基于下载的视频进行解析反推

• 核心智能体协同：

  1. 爆款解析铲屎官 - 视频链接解析反推、知识库运营
  2. 萌趣创意铲屎官 - 创意拆解、萌点提炼、带货植入点设计
  3. 故事脚本喵掌柜 - 带货导向脚本创作、镜头拆分
  4. 分镜脚本绘影匠 - COZE API适配标准化分镜脚本
  5. 分镜导摄喵sir - 画面规范设计、商品展示构图规划
  6. 萌镜画师毛球匠 - 分镜图片生成、批量下载支持
  7. 字幕萌编宠酱 - 字幕参数包、带货口播文字稿创作
  8. 音效趣配汪酱 - 音效素材包、配音素材包创作
  9. 视频合成掌镜官 - COZE API全素材整合、带货型成品视频合成
  10. 品控巡检宠管家 - 全流程质检、API适配校验、带货引流导向校验
  11. 数据迭代铲屎官 - 数据统计、迭代优化建议、技能升级

• 纯API合成强制规则：

  1. 禁止使用任何本地依赖包（moviepy/opencv-python/mediapipe/pillow/numpy）
  2. 所有素材（图片/字幕/音效）必须适配COZE API格式要求
  3. 脚本通过scripts/coze_video_api.py调用COZE API，使用coze-workload_identity的requests
  4. 出现本地包调用行为立即终止流程

• 可选分支：

  • 当提供视频链接：执行爆款解析反推→自动入库→生成参考包
  • 当需要二次创作：从成品视频回溯至任意创作步骤修改
  • 当需要知识库调取：根据带货品类/涨粉目标匹配爆款参考

资源索引

• 必要脚本：
  • scripts/video_downloader.py（用途：视频下载，支持抖音/B站/YouTube等主流平台，提取视频元数据和缩略图）
  • scripts/coze_video_api.py（用途：COZE视频API封装，支持素材上传、视频合成、状态轮询）
• 领域参考：
  • references/agents-prompts.md（何时读取：执行多智能体协同创作时，11大智能体的完整提示词）
  • references/coze-api-specs.md（何时读取：配置API参数、校验素材格式时）
  • references/pet-character-library.md（何时读取：设计萌宠角色规范时）
  • references/output-templates.md（何时读取：生成标准化输出格式时）
  • references/knowledge-base-structure.md（何时读取：理解知识库分类、自动入库逻辑时）
• 输出资产：（动态生成，无固定静态资产）

注意事项

• 严格遵循纯API合成原则，所有技术操作通过COZE API完成
• 带货引流为核心导向，所有创作环节需明确流量钩子、商品植入点、关注引导点
• 知识库联动实时生效，爆款解析结果自动入库，创作类智能体自动调取参考
• 全步骤互动数据实时同步至创作优化数据池，作为迭代优化依据
• 素材支持单张/单个+整包批量下载，格式统一可复用
• 成品视频支持高清下载、二次创作、平台发布，带货信息清晰传递

使用示例

示例0：视频下载与解析反推（新增）

• 功能说明：下载抖音/B站/YouTube等平台的视频，提取元数据，进行解析反推
• 执行方式：video_downloader.py + 爆款解析铲屎官
• 关键参数：
  • 视频链接：用户提供视频URL
  • 输出目录：./downloads（自动创建）
• 示例流程：
  1. 用户输入视频链接（如https://www.bilibili.com/video/BV1xx411c7mD）
  2. 调用video_downloader.py下载视频

     python scripts/video_downloader.py download "https://www.bilibili.com/video/BV1xx411c7mD"
     

  3. 自动下载视频文件（MP4格式）
  4. 自动提取视频元数据（标题、时长、作者、观看数、点赞数等）
  5. 自动下载视频缩略图
  6. 输出结果包含：
     • 视频文件路径：./downloads/视频标题.mp4
     • 元数据JSON：./downloads/视频标题.info.json
     • 缩略图：./downloads/视频标题.jpg
  7. 爆款解析铲屎官基于下载的视频进行解析反推
  8. 生成解析报告并自动入库至知识库

示例1：萌宠好物测评带货视频创作

• 功能说明：创作猫粮测评带货视频，15秒竖屏9:16
• 执行方式：多智能体协同 + COZE API合成
• 关键参数：
  • 创作类型：好物测评
  • 带货品类：主粮（猫粮）
  • 涨粉目标：精准宠主
  • 时长：15秒
  • 风格：萌宠轻喜剧
• 示例流程：
  1. 爆款解析铲屎官调取知识库，输出测评带货参考包
  2. 萌趣创意铲屎官拆解创意（前3秒展示猫粮包装→猫咪馋嘴→吃粮镜头→关注引导）
  3. 故事脚本喵掌柜创作带货脚本（口播："这款猫粮配方超干净，看看猫咪多喜欢！记得点赞关注"）
  4. 分镜导摄喵sir规划商品展示构图（猫粮特写+猫咪吃粮动作）
  5. 萌镜画师毛球匠生成4-6张分镜图片，支持批量下载
  6. 字幕萌编宠酱创作字幕参数包（卖点字幕：配方干净/无添加，关注引导：关注领优惠券）
  7. 音效趣配汪酱创作音效+配音素材包（轻快背景音乐+清晰口播音色）
  8. 视频合成掌镜官调用COZE API整合所有素材
  9. 品控巡检宠管家质检API适配性、带货引流导向落地性
  10. 输出成品视频+素材整合台账，支持下载与二次创作

示例2：爆款视频链接解析反推

• 功能说明：解析抖音爆款萌宠带货视频，反推创作逻辑并自动入库
• 执行方式：爆款解析铲屎官 + 知识库自动收录
• 关键参数：
  • 视频链接：用户提供抖音/快手/小红书等平台链接
  • 解析维度：流量逻辑、带货转化逻辑、内容创作反推
• 示例流程：
  1. 用户输入视频链接
  2. 爆款解析铲屎官解析视频（时长10万+、点赞5万+、转化率2.3%）
  3. 生成解析报告：
     • 流量钩子：前3秒猫咪从猫粮袋钻出
     • 带货植入：第5秒口播提到猫粮品牌
     • 关注引导：第12秒字幕显示"关注有福利"
  4. 自动按"宠物品种/创作类型/带货品类"分类入库
  5. 输出参考包供后续创作调用

示例3：全步骤互动优化与二次创作

• 功能说明：基于成品视频的互动数据，优化创作并二次创作
• 执行方式：互动数据采集 + 回溯修改 + 重新合成
• 关键参数：
  • 成品视频：已生成的带货视频
  • 互动数据：点赞率85%、点踩率5%、评论反馈"商品卖点不突出"
• 示例流程：
  1. 用户查看成品视频，点赞/点踩/分享/评论
  2. 数据迭代铲屎官分析互动数据（点踩集中在"卖点不清晰"）
  3. 生成优化建议（强化商品卖点字幕、增加卖点特写镜头）
  4. 用户点击"一键二次创作"
  5. 回溯至分镜脚本绘影匠/分镜导摄喵sir修改商品展示设计
  6. 重新生成素材、合成成品视频
  7. 输出优化后成品视频，对比优化前后的带货引流效果