short-video

## 失败处理（核心规则） **sub-agent task 失败后，永远不要在主 session 自己接管本应由 sub-agent 做的工作。** 正确做法： 1. 分析失败原因（task return 值 / 错误信息） 2. 如可修复：用修正后的参数重新派发同一 sub-agent 3. 如不可修复：将失败原因和已尝试方案返回给用户，停止流程 错误做法： - ❌ "sub-agent 失败了，我自己来写这个 novel.md" - ❌ "task 报错了，我在主 session 直接调用 Write" - ❌ "我 fallback 一下，自己生成 keyframes.json" 原因：主 session 缺少 sub-agent 的隔离上下文（专属 system prompt、skill 加载、permission 配置），自己接管会导致质量下降、跨步骤上下文污染、permission 错配等问题。即使 sub-agent 失败，工作所有权也必须留在 sub-agent 层。 ## 总流程 调用 `/short-video` 后，按以下顺序执行： 1. **配置加载** — 读取或创建 [config.md](config.md)（首次运行进入交互式引导） 2. **输入解析** — 解析用户输入，确定故事来源（内联文本/文件/交互式/Director 生成） 3. **创建目录** — 创建项目目录结构 4. **执行工作流** — 按顺序执行剧本创作流水线 **版权规避：所有生成内容（大纲、剧本、分镜、资产提示词等）不得出现现实中的明星或公众人物名字、真实地名、商标名或其他受版权/商标保护的名称，必要时使用虚构替代名称。** **硬性约束：每次调用 `/short-video` 生成一个完整的单集短视频内容。** 生成完毕后 skill 结束。 ## 阶段 1: 配置加载 1. 使用 Read 工具检查当前工作目录下是否存在 [config.md](config.md) 2. 若已存在 → 读取并解析配置值 3. 若不存在 → 进入**交互式配置引导**（仅首次运行），参考 [config-template.md](config-template.md) 模板进行交互式配置引导，逐个询问每项配置，每次只问一个，提供多选项供用户选择： **第 1 项：图像模型** - A) none（不生成图像） - B) dreamina（即梦） **若用户选择 dreamina，继续询问以下 3 项配置：** **第 1a 项：即梦 — 图像模型版本** - A) 4.0（免费，推荐） - B) 5.0（每张约 3 积分，画质更高） - C) 其他版本（3.0/3.1/4.1/4.5/4.6） **第 1b 项：即梦 — 图片比例** - A) 1:1（推荐） - B) 3:4 - C) 16:9 - D) 其他 **第 1c 项：即梦 — 图片分辨率** - A) 2k（推荐） - B) 4k（仅 4.0+ 支持） **第 1d 项：视频模型** - A) none（不生成视频） - B) dreamina（即梦） **若用户选择 dreamina，继续询问以下配置：** **第 1e 项：即梦 — 视频模型版本** - A) seedance2.0fast（推荐，速度更快） - B) seedance2.0（标准） - C) seedance2.0fast_vip（VIP 加速） - D) seedance2.0_vip（VIP 标准） **第 1f 项：即梦 — 视频比例** - A) 16:9（推荐，横屏） - B) 9:16（竖屏，短视频常用） - C) 1:1 - D) 其他 **第 1g 项：即梦 — 视频分辨率** - A) 720p（当前仅支持 720p） **第 2 项：视频风格** - A) 2D动漫 - B) 3D动漫 - C) 3D写实 - D) 2D手绘 - E) 自定义输入 **第 3 项：语言** - A) auto（跟随输入语言） - B) zh（中文） - C) en（英文） - D) 自定义输入 **第 4 项：每集分镜数**（建议 10-20） - A) 10 - B) 15（推荐） - C) 20 - D) 自定义输入 **第 5 项：每集时长目标** - A) 1-2分钟（推荐） - B) 2-3分钟 - C) 自定义输入 **第 6 项：单镜头时长范围** - A) 8-12秒 - B) 10-15秒（推荐） - C) 12-18秒 - D) 自定义输入 **第 7 项：单镜头资产上限** - A) 3 - B) 5（推荐） - C) 7 - D) 自定义输入 所有配置收集完毕后，根据用户选择生成 [config.md](config.md) 写入项目根目录。告知用户可通过 `/short-video config` 随时修改。若图像模型为 `dreamina`，在 config.md 中额外写入 `## 图像生成配置` 区域（包含即梦模型版本、图片比例、图片分辨率）。若图像模型为 `none`，不写此区域。若视频模型为 `dreamina`，在 config.md 中额外写入 `## 视频生成配置` 区域（包含即梦视频模型版本、视频比例、视频分辨率）。若视频模型为 `none`，不写此区域。 4. 解析以下配置值： - **图像模型**：none 或 dreamina - **图像生成配置**（仅图像模型非 none 时）：即梦模型版本、图片比例、图片分辨率 - **视频模型**：none 或 dreamina - **视频生成配置**（仅视频模型非 none 时）：即梦视频模型版本、视频比例、视频分辨率 - **视频风格**：视频的视觉风格（2D动漫/3D动漫/3D写实/2D手绘等） - **语言**：提示词输出语言 - **每集分镜数**：每集包含的分镜数量 - **每集时长目标**：每集目标时长 - **单镜头时长范围**：每个分镜镜头的时长约束 - **单镜头资产上限**：每个分镜镜头中引用资产的最大数量 ## 阶段 2: 输入解析 解析 `$ARGUMENTS`，提取故事材料。 **特殊命令：** 若 `$ARGUMENTS` 为 `config`，使用 Read 打开 [config.md](config.md) 展示给用户，询问是否编辑。流程结束，不进入后续阶段。 **故事材料识别：** - `$ARGUMENTS` 为空 → 无故事材料 - `$ARGUMENTS` 以 `.txt` 或 `.md` 结尾 → 使用 Read 读取该文件内容作为故事材料 - 其他 → 作为内联文本故事材料 ## 阶段 3: 创建目录 + 输入分流 1. 使用 Bash 创建目录结构：`story/`、`story/episodes/ep01/`、`assets/characters/`、`assets/items/`、`assets/locations/`、`assets/buildings/` 2. 根据故事材料进行输入分流： - **有故事材料** → 使用 Skill tool 调用 `short-input-confirm` skill，传递参数：`"{story_input}"`，等待用户确认 - **无故事材料** → 使用 Skill tool 调用 `short-plot-options` skill，等待用户选择 ## 阶段 4: 执行工作流 按以下顺序执行： **4.1 Director — 生成大纲：** 使用 Skill tool 调用 `short-outline` skill，传递参数：`"{用户确认的剧情方向文本}"` **4.2 Scriptwriter — 写剧本：** 使用 Skill tool 调用 `scriptwriter-script` skill，传递参数：`ep01` **4.3 Director — 审核剧本：** 1. 使用 Skill tool 调用 `director-review-script` skill，传递参数：`ep01` 2. 若 review return `needs_revision M` → 使用 Skill tool 调用 `scriptwriter-fix-script` skill，传递参数：`ep01`（最多 2 轮 fix；fix skill 自动读 `.review-script.md` 最后一轮意见） **4.4 Director — 规划关键帧 + 资产清单：** 使用 Skill tool 调用 `director-keyframes` skill，传递参数：`ep01` → 写入 `story/episodes/ep01/keyframes.json` 并将本集资产清单追加到 `ep01/outline.md` **4.5 Director — 审核关键帧叙事：** 1. 使用 Skill tool 调用 `director-review-keyframes-narrative` skill，传递参数：`ep01` 2. 若 review return `needs_revision M` → 使用 Skill tool 调用 `director-keyframes` skill，传递参数：`ep01 incremental`（最多 2 轮 fix；fix skill 自动读 `.review-keyframes-narrative.md` 最后一轮意见） **4.6 Creator — 创建资产：** 使用 Skill tool 调用 `creator-create-assets` skill，传递参数：`ep01` **4.7 Creator — 生成关键帧 .md 文件：** 使用 Skill tool 调用 `creator-keyframe-prompts` skill，传递参数：`ep01` → 写入 `assets/keyframes/ep01/{KF-id}.md` **4.8 Creator — 批量出图（资产 + 关键帧）：** 若 config 中图像模型非 `none`：使用 Skill tool 调用 `creator-generate-images` skill，传递参数：`ep01`（自动扫描资产 .md 与关键帧 .md，统一出图）。 若 config 中图像模型为 `none`，跳过此步及 4.9。 **4.9 Director — 审核关键帧画面：** 1. 使用 Skill tool 调用 `director-review-keyframes-visual` skill，传递参数：`ep01` 2. 若 review return 以 `needs_revision` 开头 → 使用 Skill tool 调用 `creator-fix-keyframe-image` skill，传递参数：`ep01`（最多 2 轮 fix；fix skill 自动读 `.review-keyframes-visual.md` 最后一轮 dirty list + 意见） **4.10 Storyboarder — 生成分镜：** 使用 Skill tool 调用 `short-storyboard` skill，传递参数：`ep01` **4.11 Director — 审核分镜：** 1. 使用 Skill tool 调用 `short-review-storyboard` skill，传递参数：`ep01` 2. 若 review return `needs_revision M` → 使用 Skill tool 调用 `short-fix-storyboard` skill，传递参数：`ep01`（最多 2 轮 fix；fix skill 自动读 `.review-storyboard.md` 最后一轮意见） **4.12 完成：** 输出摘要：剧名、镜头数量（分镜数量）、关键帧数量、新建资产列表。