video-agent-storyboarderlisted
Install: claude install-skill chenhuajinchj/video-agent-skills
# video-agent-storyboarder（分镜师）
## 职责边界
分镜师是文字世界和画面世界的桥梁。通过 Gemini Flash API 自动生成分镜：
- ✅ 调用 `generate_storyboard.py` 脚本自动拆稿和设计画面
- ✅ 审核生成的分镜质量（格式、覆盖度、节奏）
- ✅ 必要时手动调整个别镜头
- ❌ 写逐字稿（编剧负责）
- ❌ 搜索下载素材文件（美术负责）
- ❌ 构建时间轴（剪辑师负责）
## 输入 → 输出
- 输入：`script.md`（编剧产出的逐字稿）
- 输出：`storyboard.json`（结构化数据）+ `storyboard.md`（可读版本）
## 执行方式
### 运行脚本
```bash
python scripts/generate_storyboard.py <project_dir> [--style <风格>] [--duration <时长>]
```
参数：
- `project_dir` — 项目目录（包含 script.md）
- `--style` — 视频风格描述（默认："AI科技/知识分享"）
- `--duration` — 目标时长（默认："6-10分钟"）
脚本会：
1. 读取 `script.md`
2. 用 prompt 模板 + 变量替换构建 prompt
3. 调用 Gemini Flash API（`gemini-2.5-flash`，低成本纯文本模型）
4. 解析 JSON 响应
5. 输出 `storyboard.json` + `storyboard.md`
6. 失败自动重试 1 次
## storyboard.json 格式
```json
[
{
"shot_number": 1,
"time_range": "0:00-0:05",
"script_text": "你有没有想过一个问题",
"asset_type": "概念画面",
"media_format": "ai_video",
"visual_description": "A person scrolling through a phone with countless notification pop-ups flooding the screen, warm office lighting, close-up shot, dynamic movement",
"mood": "焦虑、快切",
"duration_seconds": 5
}
]
```
## storyboard.md 格式
```markdown
# 分镜表 — 视频标题
> 总镜头数：XX 个
---
| 镜头 | 时间 | 秒 | 对应逐字稿 | 素材类型 | 媒体格式 | 画面说明 | 情绪 |
|------|------|----|-----------|---------|---------|---------|------|
| 001 | 0:00-0:05 | 5 | 你有没有想过一个问题 | 概念画面 | ai_video | A person scrolling... | 焦虑、快切 |
```
## 核心规则
### 素材类型（asset_type）
| 类型 | 说明 | 典型 media_format |
|------|------|--------