# Huashu Douyin Script

抖音爆款脚本创作工作流。从竞品视频拆解到脚本生成的完整流程：下载抖音视频→Gemini视频分析→爆款公式提炼→脚本+分镜生成→AI味审校。...

- Repository: https://github.com/alchaincyf/huashu-skills (2152 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-26
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add alchaincyf/huashu-skills --skill huashu-douyin-script -g -a claude-code -y`
Codex: `npx skills add alchaincyf/huashu-skills --skill huashu-douyin-script -g -a codex -y`
Cursor: `npx skills add alchaincyf/huashu-skills --skill huashu-douyin-script -g -a cursor -y`
Gemini CLI: `npx skills add alchaincyf/huashu-skills --skill huashu-douyin-script -g -a gemini-cli -y`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 抖音爆款脚本创作

从竞品视频拆解到脚本生成的完整工作流。将「凭感觉模仿爆款」变成「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: 下载视频

运行下载脚本：

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

**参数说明**：
- `--urls`：支持短链、页面链接、分享文本（自动提取URL）
- `--output-dir`：默认当前工作目录下 `_temp/douyin-downloads/`
- `--cookies-browser`：默认chrome，可选edge/firefox

**下载失败时**：
1. 提示用户确认Chrome已登录抖音
2. 建议手动下载视频放入 `_temp/douyin-downloads/`
3. 如果有douyin-mcp-server可用，尝试通过MCP下载

---

### Step 3: Gemini视频分析（可并行）

对每个下载成功的视频，调用 Gemini 视频分析：

```bash
uv run SKILL_DIR/scripts/analyze_video.py \
  --video "_temp/douyin-downloads/douyin-1-xxx.mp4" \
  --prompt "PROMPT_BELOW" \
  --model flash \
  --resolution medium \
  --output "_temp/douyin-downloads/analysis-1.md"
```

**使用flash模型 + medium分辨率**（短视频足够，节省成本）。

**多个视频可并行分析**（用 `run_in_background=true`）。

**爆款分析Prompt**（传入 `--prompt` 参数）：

```
作为资深抖音电商视频分析师，请对这个视频进行7维度深度拆解。
特别注意：前3秒是最关键的部分，需要逐帧级别的详细拆解。

## 1. 钩子分析（前3秒）⭐ 最关键
前3秒 = 文案钩子 + 视觉钩子，两条线都要详细分析。

### 1a. 文案钩子
- 钩子类型（反常识/痛点/数据/场景/悬念/利益）
- 钩子文案完整转录
- 文案与产品的关联度（强关联/弱关联）

### 1b. 视觉钩子（逐帧描述）
- 第0秒画面：暂停在最开始，描述这一帧的构图、色调、主体
- 视觉钩子类型（视觉奇观/产品堆叠/画面突变/动作冲击/文字弹出/第一人称POV）
- 具体画面描述：景别、色调、运镜方式、特效、人物表情和动作
- 视觉信息密度：画面中同时出现了多少信息元素

### 1c. 文案×视觉配合
- 文案和画面是否同步强化同一个信息
- 声音设计：前3秒有无音效/BGM变化/人声语气变化
- 综合钩子强度评分（1-10）及理由

## 2. 分镜结构
用表格拆解每个镜头：
| 时间 | 景别 | 画面内容 | 旁白/字幕 | 转场方式 |

The rest: https://github.com/alchaincyf/huashu-skills/blob/HEAD/huashu-douyin-script/SKILL.md