Muse Video Skill

---
name: muse-video
description: "When the user asks to 策划/构思/设计/写脚本/画分镜 for a video project — e.g. '帮我策划一个广告创意' '这个产品演示视频怎么拍' '帮我写科幻短片的分镜脚本' '给我这个品牌TVC的美术方向'。Not for actual video rendering/compositing or AI image/video generation."
version: 0.36.7
author: Hermes Agent + 钱多多
license: MIT
platforms: [linux, macos, windows]
metadata:
  hermes:
    tags: [video, creative, pre-production, storyboard, script, art-direction, filmmaking]
    related_skills: [hyperframes, comfyui, infographic-carousel]
---

# Muse Video — AI 视频前期策划引擎

> **定位**：产出 Creative Package（剧本 + 分镜 + 美术 + 提示词），由用户导入下游工具制作。
> **不做**：实际视频渲染、AI 生图/生视频。如有 HyperFrames/ComfyUI 等下游工具可对接；如无，产出策划案供手动制作。
> **宪法**：加载 `CONSTITUTION.md` 了解 5 条设计原则 + 数据流 + 禁止模式。

## 路由决策树

```
用户请求视频相关创作
        │
        ├─ "我做了一个视频，帮我修改/加特效/加字幕" → 这不是本 Skill。如已配置 HyperFrames 等视频合成工具可路由；否则告知用户本 Skill 产出分镜脚本供参考。
        ├─ "帮我生成一个视频/图片" → 这不是本 Skill。如已配置 ComfyUI/image_gen 可在视觉阶段按需调用；否则用文字描述替代。
        │
        └─ "帮我策划/设计/构思一个视频" → ✅ 激活本 Skill
                │
                ├─ 用户提供参考视频（本地文件 / 可下载 URL）？
                │   → 触发 Phase 1 拆解子流程（见 default.md §Phase 1 步骤 2.5）
                │   → 逐镜头拆解为拉片表 → 用户校准 → 聚合为技法摘要
                │   → 技法摘要写入 Project State，后续角色直接消费
                │   → 下载失败：告警 + 问替代方案，不降级不猜测
                │
                ├─ 用户提到具体案例/风格？
                │   → 加载 references/cases/INDEX.md
                │   → 匹配案例 → 加载 references/cases/<id>.md
                │
                ├─ 检测场景类型（关键词匹配）：
                │   studio-ad:      "广告/棚拍/TVC/品牌片"
                │   logo-animation: "LOGO/片头/品牌演绎/动画"
                │   product-demo:   "产品/演示/功能介绍/开箱"
                │   sci-fi:         "科幻/Cyberpunk/未来/赛博"
                │   custom:         无匹配 → 用通用流程
                │   新增场景类型 → references/scenes/_TEMPLATE.md
                │
                └─ 检测复杂度：
                    1-2 场景 / 无角色 / 用户催快 → fast-track 管线
                    多场景 / 有角色 / 需要深度策划 → default 管线
```

## 管线激活

### Default Pipeline（8 阶段 + 1 预留，完整创作）
1. **需求沟通**（Director）→ 确认比例/用途/场景/约束
2. **内容梳理**（Writer + Director）→ 故事、场景、叙事结构
3. **视觉开发**（Art Director + Director）→ 色调、风格、场景搭建、人物设定。含反主观化规则：情绪标签映射 visual_cause 字段（见 `references/roles/art-director.md`）
3.5 **风格定样**（条件性）→ 生图前先选模型（`references/image-gen-routing.md`）→ image_gen 生成场景 moodboard + 角色概念图 → 用户看图确认 → 锁定风格方向。不可用时跳过
4. **脚本**（Writer → DP → Director review）→ 台词、镜头语言、动作、时长
5. **声音方向**（Sound Designer）→ 配乐风格、音效、旁白基调
6. **分镜**（Storyboard Assembly）→ 6/9 宫格分镜 + 显式询问用户是否调用 image_gen 生成分镜图 + 可选实景参考图获取（`references/free-image-sources.md`）；生成产物登记顶层 `file_registry`
7. **组装+调优**（Director）→ `prompt_assembler.py` 产出 Creative Pack → HTML storyboard 确认门禁（四选项 + 默认，唯一最终确认关卡）。参考图经顶层 `file_registry` 全链引用（不转述），确认即锁定
7.5 **模型编译**（Model Compiler）→ 编译前先选模型（Phase 7 子步骤 6.5）；Creative Package 编译为模型调用指令（六段式 prompt + 多模态引用 + arkcli 命令 + 成本估算），导出编译预览 HTML 供用户二次确认。已适配 Seedance 2.0
8 **下游工具引导**（预留）→ 工具选择与费用预估（不执行，建设时遵循「机场指示牌」原则）

**每阶段**：角色产出 → Director 审核。通过 → 下一阶段。修改 ≤2 轮。拒绝 → 重启该阶段。
**角色文件**：按需加载 `references/roles/<name>.md`，不一次全载入。

### Fast-Track Pipeline（简化版）
合并阶段 2+3+4 → 一稿过，跳过 Director 多轮审核。仅适用于简单需求。

## 案例引用

> 案例匹配 → 加载 `references/cases/INDEX.md`。新增案例 → `references/cases/_TEMPLATE.md`。索引由 `scripts/build_index.py` 自动生成，禁止手动编辑 INDEX.md。

## 导出格式

`scripts/export_html.py` → 文学剧本 HTML（Courier 标准格式）/ 分镜展示 HTML（卡片网格）/ 编译预览 HTML（`--literary` / `--storyboard` / `--compilation`）
`scripts/export_xlsx.py` → 分镜技术表 Excel（镜号/景别/运动/灯光/VFX）
用户说"导出剧本/分镜表" → 自动触发对应脚本。

## 下游对接

> 产出 Creative Package 后，按 `references/downstream-integration.md` 对接下游工具（HyperFrames / ComfyUI / Kling / 火山引擎 / etc.）。

## INDEX.md 自动化

> 见 `CONSTITUTION.md` §元数据治理。`build_index.py --check` 校验，`--write` 重新生成。禁止手动编辑。

## 产出验证

> 见 `references/meta/verification-checklist.md`。