# Short Fix Storyboard

> Storyboarder根据Director修改意见定向修正单集短视频分镜。读取现有分镜，只修改指出的问题。

- Skill: `wddxh/short-fix-storyboard` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wddxh/short-fix-storyboard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wddxh/short-fix-storyboard/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wddxh (https://skillmd.com/u/wddxh)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wddxh/short-fix-storyboard

---


## 输入

### 文件读取
- `story/episodes/$ARGUMENTS[0]/storyboard.md` — 必须读取（现有分镜）
- `story/episodes/$ARGUMENTS[0]/script.md` — 必须读取
- `story/episodes/$ARGUMENTS[0]/outline.md` — 必须读取（含资产清单）
- 从 outline.md 的「本集资产清单」中提取资产名称，使用 Glob 获取 `assets/**/*.md` 全部文件路径列表，仅读取文件名与清单中资产名称匹配的文件
- `config.md` — 必须读取
- `skills/short-storyboard/rules.md` — 必须读取并严格遵循
- `story/episodes/$ARGUMENTS[0]/.review-storyboard.md` — 必须读取（含本轮 review 意见）

### 动态参数（$ARGUMENTS）
- `$ARGUMENTS[0]` — 当前集数（如 ep01）

## 职责描述

### 核心使命

按 Director 审稿意见或用户编辑请求，定向修正现有短视频 storyboard.md。下游消费者是即梦视频模型和 short-review-storyboard。和系列剧分镜不同：单集短视频时长有限（通常 1-3 分钟），铺垫挤压风险更高，任何镜头改动都可能放大节奏失衡。修正分镜的连锁面广——改一个镜头可能影响相邻镜头的状态衔接，改一个资产引用可能波及所有引用镜头，改铺垫镜头可能让铺垫覆盖断链。已生成视频的镜头被改会导致相应 mp4 失效需要重生成（成本高），修正必须只动指出的问题。

### 工作思路

**评估阶段：**

1. 完整通读 storyboard.md 现状 + script.md 对照原文 + `.review-storyboard.md`（**定位最后一个 `## 第 N 轮` heading**，用 grep `^## 第 [0-9]+ 轮` 找最大 N 段，用该段内的意见列表），把每条意见映射到具体镜头编号
2. **状态连锁评估**：改镜头 N 的视觉位置 / 姿势 / 手持物 / "已告知信息" → 镜头 N+1 的开头状态是否需要同步调整？
3. **铺垫连锁评估**：改的镜头是否包含某条铺垫的种子或回收点？短视频铺垫挤压风险更高——改后铺垫覆盖必须仍完整、时序必须仍正确
4. **资产连锁评估**（若意见涉及资产引用）：被改的资产被哪些镜头引用？这些镜头都要同步检查
5. 必要时把"修正镜头 N"扩展为"修正镜头 N + 上下镜头 + 同资产镜头"——但不擅自改与意见无关的镜头

**编辑阶段：**

6. 动笔时仍用 short-storyboard 的"自包容、画面与声音连贯叙事、不跨镜头引用、画面文字改读出"原则
7. 修正完毕自检：每条意见是否落地？被改镜头与上下镜头状态衔接连贯？铺垫覆盖完整（短视频铺垫密度本就紧，自检要更严）？时长合理？rules.md 格式合规？

### 常见误区

- **改一个镜头忘了相邻镜头的状态衔接** — 模型本能在镜头 N 做隔离修改，但 N+1 的开头是基于 N 结束状态写的；改 N 后 N+1 出现状态突变 — 改镜头 N 后必读 N+1 开头，确认仍连贯
- **改资产引用忘改其他引用此资产的镜头** — 改了 A 资产名为 B 但其他镜头仍引 A — 改资产引用前 grep 此资产被引用的全部镜头，统一改
- **改铺垫镜头让覆盖断链** — 短视频铺垫密度本就紧，删 / 改一个铺垫镜头容易让对应回收点变成"莫名其妙的反转" — 改铺垫前先确认它的回收点；如果改后铺垫弱了，需要在另一个镜头补上
- **时长精简误删视觉修饰词** — 时长超出时模型本能删形容词（"光线柔和地照亮房间" → "光线照亮房间"），但形容词不占时间，台词和动作才占；删修饰词不省时间反而丢画面质感 — 精简优先缩台词 / 合并动作 / 减事件数量，视觉修饰词不动
- **跨镜头引用复活** — 改了镜头开头描述后模型本能写"延续上镜头"，rules.md 已禁但修正时本能违反 — 改完每段开头独立检查"这一句脱离上镜头还能看懂吗"

## 规则参考

- `skills/short-storyboard/rules.md` — 必须读取并严格遵循

## 输出

### 文件操作
- 使用 Write 覆写 `story/episodes/$ARGUMENTS[0]/storyboard.md`