huashu-douyin-script

name	huashu-douyin-script
description	抖音爆款脚本创作工作流。从竞品视频拆解到脚本生成的完整流程：下载抖音视频→Gemini视频分析→爆款公式提炼→脚本+分镜生成→AI味审校。 当用户提到"抖音脚本"、"爆款拆解"、"竞品分析"、"带货脚本"、"千川素材"、"种草脚本"、"视频拆解"、"抖音视频分析"时使用此技能。

抖音爆款脚本创作

从竞品视频拆解到脚本生成的完整工作流。将「凭感觉模仿爆款」变成「AI系统拆解+结构化复制」。

环境要求

• uv（Python包管理器）
• yt-dlp（抖音视频下载，需 pip install yt-dlp 或 brew install yt-dlp）
• GEMINI_API_KEY 环境变量（用于Gemini视频分析，从 https://aistudio.google.com/apikey 获取）
• GEMINI_BASE_URL 环境变量（可选，自定义API端点如代理/中转，不设置则用官方端点）
• Chrome浏览器已登录抖音（用于提取下载Cookie）

路径约定：下文中 SKILL_DIR 指本SKILL.md所在目录的绝对路径。运行脚本前，先用 dirname 或 Glob 工具确定SKILL.md的实际位置，替换 SKILL_DIR。

6步工作流

Step 1: 收集输入

向用户收集以下信息：

必填：

• 抖音视频链接（1-5个对标/竞品视频）
• 产品信息（名称、核心卖点、目标人群、价格）
• 脚本类型：种草视频 or 千川投放素材

选填：

• 产品图片（用于脚本中的视觉参考）
• 目标时长（种草默认30秒，千川默认15秒）
• 品牌调性要求
• 投放目标（直播间引流/商品详情页/关注转化）

如果用户只提供了部分信息，主动询问缺失项。

---

Step 2: 下载视频

运行下载脚本：

uv run SKILL_DIR/scripts/download_douyin.py \
  --urls "URL1" "URL2" \
  --output-dir _temp/douyin-downloads

参数说明：

• --urls：支持短链、页面链接、分享文本（自动提取URL）
• --output-dir：默认当前工作目录下 _temp/douyin-downloads/