# Story Video Orchestrator

> 端到端剧情视频流水线编排，串联角色图、主题、分镜生成与质量分析，适合漫剧、剧情短片和角色一致性视频创作。

- Skill: `lujiaheng-artpivot/story-video-orchestrator` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add lujiaheng-artpivot/story-video-orchestrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lujiaheng-artpivot/story-video-orchestrator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lujiaheng-artpivot (https://skillmd.com/u/lujiaheng-artpivot)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lujiaheng-artpivot/story-video-orchestrator

---


# 剧情视频流水线 Skill

把 `manga-drama` 和 `volcengine-video-understanding` 组合成可复用的剧情视频流水线：角色图 -> 剧本/分镜 -> 多场景视频 -> 批量分析。

## 何时使用

- 用户要从一张角色图快速生成剧情短片
- 需要把主题、风格、分镜数量封装成一次执行
- 需要在生成后自动拿到漫剧分析报告

## 使用方法

```bash
python3 scripts/run_story_pipeline.py \
  --character ./character.png \
  --theme "樱花树下的邂逅" \
  --style anime_2d \
  --scenes 4 \
  --ratio 16:9 \
  --output-dir ./story_output
```

## 参数说明

- `--character`：角色图片路径，必填
- `--theme`：故事主题；与 `--script-file` 二选一
- `--script-file`：自定义剧本路径
- `--style`：漫画风格，默认 `anime_2d`
- `--scenes`：分镜数，默认 4
- `--ratio`：输出比例，默认 `16:9`
- `--duration`：单镜头时长，默认 5
- `--skip-analysis`：跳过分析报告
- `--output-dir`：输出目录，默认 `./story_output`

## 输出结构

```text
story_output/
├── task_info.json
├── drama/
│   ├── script.txt
│   ├── scene_1.mp4
│   └── drama_info.json
├── analysis/
│   └── drama_analysis.md
└── events/
    ├── event_story_pipeline_started_*.json
    ├── event_drama_generated_*.json
    └── event_video_analysis_completed_*.json
```

## 事件流

1. `story.pipeline.started`
2. `drama.generated`
3. `video.analysis.completed`（如果未跳过分析）

## 进阶资料

- 需要选择不同流程模式时，读取 `references/workflow-modes.md`
- 需要拆解剧情节奏时，进一步读取 `../manga-drama/references/story-beats.md`