Huashu Douyin Script

# 抖音爆款脚本创作

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

## 环境要求

- `uv`（Python包管理器）
- `yt-dlp`（抖音视频下载，需 `pip install yt-dlp` 或 `brew install yt-dlp`）
- `GEMINI_API_KEY` 环境变量（用于Gemini视频分析，从 https://aistudio.google.com/apikey 获取）
- 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. 分镜结构
用表格拆解每个镜头：
| 时间 | 景别 | 画面内容 | 旁白/字幕 | 转场方式 |

## 3. 节奏设计
- 快切片段时间点
- 节奏变化模式（快-慢-快/渐进加速/脉冲式）
- BGM与画面的配合度

## 4. 视觉元素
- 色调和滤镜风格
- 字幕样式和出现时机
- 产品展示方式
- 构图特点

## 5. 转化设计
- CTA类型和出现时机
- 价格锚定策略
- 紧迫感营造手段
- 转化路径（视频→?→?）

## 6. 合规检查
- 是否存在绝对化用语
- 功效表述是否合规
- 有无潜在审核风险

## 7. 可复制要素
- 可直接复制的：钩子句式、分镜结构、视觉风格、CTA话术
- 不可复制的：独特场景、特定达人、品牌势能

请用中文输出，尽量详细。
```

---

### Step 4: 爆款公式提炼 ← 用户确认节点

**有竞品视频时** → 汇总分析结果：

读取所有 `analysis-*.md` 文件，同时读取 `references/proven-formulas.md` 中的已验证公式作为对照，由Claude汇总提炼：

1. **品类爆款共性**：多个视频共同的成功要素
2. **钩子公式**：最有效的钩子类型和句式模板
3. **最佳分镜结构**：适合该品类的标准分镜流程
4. **节奏模板**：推荐的节奏设计方案
5. **转化路径**：最优的CTA策略
6. **风险提示**：需要避免的合规问题

**无竞品视频时** → 直接使用已验证公式：

读取 `references/proven-formulas.md`，根据产品品类选择最接近的品类公式作为基线。提醒用户：无竞品分析的脚本可能缺少品类针对性，建议后续补充竞品视频。

**保存汇总**到 `_temp/douyin-downloads/[产品名]-爆款分析汇总.md`

**展示给用户确认**：
- 确认分析是否准确
- 确认脚本类型（种草/千川）
- 补充产品信息（如果Step 1未完整提供）

**公式沉淀**：分析完成后，将新品类的公式追加到 `references/proven-formulas.md`，持续积累。

---

### Step 5: 脚本+分镜生成

基于爆款公式 + 产品信息 + 口语风格样本生成脚本。

**生成前准备**：
1. 读取 `references/script-style-samples.md` 获取口语风格范例
2. 读取 `references/analysis-dimensions.md` 中的种草/千川区别表
3. 读取Step 4的爆款分析汇总

**脚本生成Prompt模板**：

#### 种草视频脚本

```
你是抖音电商短视频编导，擅长带货类种草内容。

## 任务
为以下产品生成一个{时长}秒的种草视频脚本。

## 产品信息
{产品名称、核心卖点、目标人群、价格、品牌信息}

## 爆款公式（基于竞品分析）
{Step 4提炼的爆款公式}

## 口语风格要求
参考以下真实脚本的风格特征：
- 极度口语化：用说话的方式写字，短句为主（不超过15字）
- 具体数据锚点：用具体数字，不用「很多」「大量」
- 感官描述：调动视觉/触觉/味觉/嗅觉
- 情感触发：身份认同、焦虑激活、场景共鸣
- 品牌背书简化：一句话带过
- 价格锚定+紧迫感

真实脚本范例：
{从script-style-samples.md选取同品类或风格接近的1-2个样本}

## 输出要求

### Part A：完整脚本
- 开头3秒必须有强钩子（参考分析中最有效的钩子类型）
- 中间展示核心卖点（最多3个，多了观众记不住）
- 结尾有明确CTA
- 全文口语化，像朋友推荐
- 不使用绝对化用语，符合抖音广告审核规范
- 标注每段预估时长

### Part B：分镜表格（前3秒必须详细描述视觉钩子）
| 镜号 | 时长 | 景别 | 画面内容 | 旁白/字幕 | 拍摄建议 |

⚠️ 前3秒的分镜必须包含：
- 视觉钩子类型（视觉奇观/产品堆叠/画面突变/动作冲击/文字弹出/第一人称POV）
- 具体画面描述：构图、色调、运镜、特效、表情动作
- 第一帧设计：暂停在第0秒时这一帧能否吸引点击
- 文案×画面配合：声音和画面是否同步强化同一个信息
```

#### 千川投放素材脚本

```
你是千川投放素材编导，擅长高转化信息流广告。

## 任务
为以下产品写一条{时长}秒千川投放素材脚本。

## 产品信息
{产品名称、核心卖点、目标人群、价格、投放目标}

## 爆款公式（基于竞品分析）
{