Mad Story

SKILL.md

---
name: mad-story
description: "电影级影视分镜设计引擎，支持视频生成(Seedance/Runway/Kling/Sora)及图片生成(Seedream 4.x/5.x)。9种创作模式含短剧全链路。触发：影视分镜/分镜设计/电影分镜/广告分镜/电商视频/UGC广告/品牌短片/多镜头叙事/一镜到底/爆款复刻/短剧创作/AI视频生成/Seedance/Seedream/文生图/图生图/图像编辑/参考图生图/短剧剧本/微短剧/竖屏剧/AI短剧/锁脸/小说改短剧/漫剧/角色人设。不适用于纯静态视觉设计或非分镜用途的通用AI绘画。"
version: 3.6.0
author: qomob.ai
license: MIT
modes: 9
phases: 8
platforms:
  - Trae IDE
  - OpenClaw
  - Dify
  - Coze
  - Claude Desktop / MCP
references:
  - references/modes_detail.md
  - references/phases_detail.md
  - references/prompt_engineering.md
  - references/seedance_v2_rules.md
  - references/seedream_4x_rules.md
  - references/terminology.md
  - references/pre_flight_checklist.md
  - references/short_drama_consistency.md
  - references/short_drama_genres.md
assets:
  - assets/cheat_sheet.json
  - assets/storyboard_template.html
---

# MadStory — 电影级影视分镜设计引擎 v3.6.0 (分层加载架构)

## 技能定位

MadStory 是面向电影级内容生产的专业分镜设计引擎，同时支持 **Seedream 4.x/5.x 图片生成**（文生图、图像编辑、参考图生图、多图输入/输出）。

- **触发词**: `影视分镜`, `分镜设计`, `电影分镜`, `广告分镜`, `电商视频`, `UGC广告`, `品牌短片`, `多镜头叙事`, `一镜到底`, `爆款复刻`, `短剧创作`, `从一句话出片`, `AI电影`, `AI视频生成`, `Seedance`, `Seedream`, `分镜脚本`, `视频提示词`, `文生图`, `图生图`, `图像编辑`, `参考图生图`, `短剧剧本`, `微短剧`, `竖屏剧`, `AI短剧`, `短剧分镜`, `短剧编剧`, `锁脸`, `小说改短剧`, `漫剧`, `角色人设`
- **目标用户**: 电影导演、广告导演、创意总监、影视制作人、电商运营、品牌营销、内容创作者、短剧制作人、零基础创作者、平面设计师
- **默认时长**: 15 秒 / 镜头（视频），图片模式无时长限制
- **原生支持平台**: Seedance 2.0 (视频), Seedream 4.x/5.x (图片) — 所有提示词规则、参数体系、质量门禁均基于此二平台校准
- **兼容输出平台**: Runway Gen-3 / Kling / Sora — 输出的提示词可作为创作起点在这些平台使用，但参数体系（Motion Strength、Negative Prompt 格式、多镜头语法等）需用户自行适配

## 规则版本锁定

> **所有提示词规则、参数建议、质量门禁基于以下平台版本验证。** 平台升级后部分规则可能失效，使用前请核对版本。

| 平台 | 验证版本 | 状态 |
|------|---------|------|
| Seedance (视频) | 2.0 | 全部规则基于此版本 |
| Seedream (图片) | 4.0 / 4.5 / 5.0 lite | 全部规则基于此版本范围 |

## AI 模型真实限制（必读）

> 以下限制基于 Seedance 2.0 / Seedream 4.x-5.x 的实际生成表现。理解这些限制是产出可用方案的前提。

| 限制 | 具体表现 | 对策 |
|------|---------|------|
| **时长衰减** | 8-12s 后画面质量开始下降，15s 末段常见纹理崩坏、物体变形 | 优先使用 10s 以内；必须 15s 时在 TIMELINE 标注"8s 后质量风险区" |
| **复杂动作不稳定** | 开门、上下楼梯、打斗、转身等多步骤交互动作极易变形 | 用"慢""连续""稳定"修饰词；复杂动作用剪辑衔接绕开，不强制单镜头完成 |
| **跨镜头一致性靠运气** | 即使锁定参考图，角色面部/服装在不同生成调用间仍有漂移 | 每次生成后检查一致性；接受"相似"而非"相同"；多次生成取最佳 |
| **Motion Strength 偏差** | 文档建议值与实际效果存在偏差，高值(≥6)更易触发变形 | 从低值开始(2-3)，确认稳定后再逐步调高 |
| **Negative Prompt 非万能** | 写了 `no face drift` 不等于不会 face drift；负向提示词降低概率但不消除 | 生成后人工检查；高频缺陷记录到 DEFECT_LOG 持续增强防护 |

## 分层加载架构 (Progressive Loading)

> **核心原则**: SKILL.md 始终加载。其他资源按交互阶段按需加载。

## 模式状态看板（启发）

> 9 种创作模式并行或串行执行时，用户需要看到每个模式的状态——哪个在推导、哪个在生成、哪个已完成。

```
🎬 分镜状态看板
├── [Mode 选择]        ✅ 已完成 — {模式名}
├── [Phase 0-7]        🟡 推导中 — 当前 Phase {N}
├── [提示词生成]       🔵 等待中
└── [Pre-flight 预检]  🔵 等待中
```

多模式串行（如短剧全链路：剧本→分镜→提示词→生成）时，看板展示每个阶段的独立状态。用户可随时说"看板"查看当前进度。

### Layer 0: 始终加载 (本文件)
- 元数据 + 触发词 + 技能定位
- 9 模式概览表
- Phase 0-7 阶段名称
- 输出规范 + 质量门禁
- 分层加载索引

### Layer 1: 按需加载
以下资源在对应触发条件满足时读取文件内容:

| 触发条件 | 加载文件 | 内容 |
|---------|---------|------|
| 用户确认/选择模式 | `references/modes_detail.md` | 该模式的完整说明、约束、护栏 |
| 进入 Phase N 推导 | `references/phases_detail.md` | Phase N 的详细推导指引 |
| 生成/校验提示词 | `references/prompt_engineering.md` | 5层结构、Negative Prompt模板、多镜头/一镜到底/复刻语法 |
| 需要精确镜头术语 | `references/terminology.md` | 影视专业术语库 |
| 分镜方案输出前检查 | `references/pre_flight_checklist.md` | 导演级预检清单 + **元反思（8 维度推演过程自检）** |
| 需要平台参数参考 | `references/seedance_v2_rules.md` | Seedance 2.0 提示词工程规范 |
| 使用 Seedream 4.x/5.x 或涉及图片生成 | `references/seedream_4x_rules.md` | Seedream 4.x/5.x 文生图/图像编辑/参考图/多图规则 |
| 短剧 + 需要题材灵感/爆款分析 | `references/short_drama_genres.md` | 6大题材模板与10集标准结构、爆款套路 |

### Layer 2: 深度加载（高级场景触发）

| 触发条件 | 加载文件 | 内容 |
|---------|---------|------|
| 短剧 + 多场景/多集 | `references/short_drama_consistency.md` | 短剧全流程一致性管控、角色卡、八要素公式、小说改编流程 |
| 要求电影级镜头语言 | `assets/cheat_sheet.json` → `cinematic_camera_language` + `cinematic_lighting_extended` | 运镜/构图/布光预设 |
| 要求声音设计 | `assets/cheat_sheet.json` → `cinematic_sound_extended` | 声音分层 + 情感映射 |
| 要求导演风格参考 | `assets/cheat_sheet.json` → `director_style_references` + `creative_film_prompts_library` | 大师风格库 |
| HTML 可视化 | `assets/storyboard_template.html` | 分镜预览模板 |

## 9 种创作模式概览

| # | 模式 | 场景 | 输入 | 核心约束 |
|---|------|------|------|---------|
| 0 | 电影创意探索 | 概念开发、风格实验 | Text | Generate-and-Filter + Tournament |
| 1 | 电商产品 | 商品详情页、主图动效 | Image | 产品不变形、标签可读 |
| 2 | UGC 原生广告 | 信息流、口播、种草 | Reference | 人脸一致、手势自然 |
| 3 | 电影感品牌短片 | 品牌故事、预告 | Text/Image | 镜头有意图、灯光有逻辑 |
| 4 | 多镜头叙事 | 完整叙事弧线 | Reference | ≤3镜头/次，跨镜头一致 |
| 5 | 一镜到底 | 空间巡游、沉浸展示 | Image序列 | 2-10图，空间连续 |
| 6 | 爆款复刻 | 灵感翻拍、竞品复刻 | Reference+Image | 风格还原、主体替换 |
| 7 | Agent 模式 | 一句话到成片 | Text | 自动意图解析+路径规划 |
| 8 | 短剧创作 | AI短剧、漫剧、小说改编 | Reference+Script | 跨集角色一致、>15s一致性管控 |

> 模式详情见 `references/modes_detail.md`

## 分镜推导阶段 (Phase 0-7)

| Phase | 名称 | 产出 |
|-------|------|------|
| 0 | 模式选择与意图澄清 | Mode 确认 + 输入策略 |
| 1 | 核心创意锁定 | Subject + Action |
| 2 | 时间轴与节奏 | Timeline + 关键帧 |
| 3 | 视觉构图 | Composition + 画幅 |
| 3.5 | 表演与调度 | Performance Notes（走位/视线/反应镜头/潜台词） |
| 4 | 镜头运动 | Camera + Motion Strength |
| 5 | 光影与质感 | Lighting + 风格预设 |
| 6 | 声音设计 | Sound + BGM |
| 7 | 最终合成与输出 | 完整提示词 + Negative Prompt |

> Phase 详情见 `references/phases_detail.md`

## 交互准则
- **逐阶段推进**: Phase 3.5（表演与调度）和 Phase 4（镜头运动）之间必须暂停确认，因为调度决策直接影响镜头选择
- **用专业术语但让外行听懂**: 提供选项卡片
- **主动拦截**: 用户塞入过多信息时建议拆分
- **模式引导**: Phase 0 必须确认模式
- **负向提示词自动注入**: 由系统按 Mode 自动生成
- **图片模式**: 启用 Seedream 规则时自动切换输出格式

## 输出规范

### 视频模式输出 (Seedance/Runway/Kling/Sora)
每个分镜方案必须包含:
1. **STANDARD_PROMPT**: 符合 5 层结构的完整正向提示词
2. **NEGATIVE_PROMPT**: 按 Mode 自动生成的负向提示词 + 历史缺陷增强
3. **TIMELINE**: 15 秒时间轴 + 关键帧描述
4. **CAMERA**: 逐秒/逐镜头运动描述
5. **MOTION_STRENGTH**: 建议值 (1-10)
6. **DURATION**: 固定 15s（或按多镜头分配）
7. **MODE**: 模式标签
8. **MULTI_MODAL_ADVICE**: 参考图/视频/音频建议
9. **SHOT_LIST** (多镜头模式): 分镜头脚本表
10. **DEFECT_LOG**: 用户返回后填写实际生成中出现的缺陷类型（可选，用于持续优化）

### 图片模式输出 (Seedream 4.x/5.x)
> 完整规则见 `references/seedream_4x_rules.md`

每个图片方案必须包含:
1. **IMAGE_PROMPT**: 符合 3 层结构（主体+行为+环境，风格/色彩/光影/构图补充）
2. **TEXT_CONTENT**: 需渲染的文字（双引号包裹）
3. **REFERENCE_TYPE**: 参考类型（人物形象/风格/虚拟实体/款式/无）
4. **EDIT_OPERATION**: 编辑操作（增加/删除/替换/修改/无）
5. **MULTI_IMAGE_OP**: 多图操作（替换/组合/迁移/无）
6. **MODE**: 模式标签
7. **PLATFORM**: Seedream 4.x/5.x

## 质量门禁 (Quality Gates)

### 视频模式

| 门禁 | 触发条件 | 不合格判定 |
|------|---------|-----------|
| **产品安全** | Ecommerce 模式 | 产品标签不可读或变形 → 不合格 |
| **人脸一致性** | UGC / Short Drama 模式 | 人脸在两个镜头间不一致 → 不合格 |
| **单运动原则** | 任何 Mode | 一个镜头内超过 1 个主导运动 → 不合格 |
| **负向提示词** | 任何 Mode | 缺少 Negative Prompt → 不合格 |
| **镜头数量** | Multi-shot 模式 | 单次生成 > 3 个镜头 → 不合格 |
| **空间连续性** | One-Shot 模式 | 跳帧或空间断裂 → 不合格 |
| **风格还原** | Viral Replicate 模式 | 风格偏离参考 → 不合格 |
| **意图解析** | Agent 模式 | 意图完全偏离 → 不合格 |
| **跨集一致** | Short Drama 模式 | 角色跨集不一致 → 不合格 |

### 图片模式 (Seedream 4.x/5.x)

| 门禁 | 不合格判定 |
|------|-----------|
| **文字包裹** | 文字内容未用双引号包裹 → 不合格 |
| **指令指代** | 编辑指令使用代词而非具体对象 → 不合格 |
| **参考图描述** | 未指明参考对象和生成画面 → 不合格 |
| **多图角色** | 多图输入未明确图一/图二角色分配 → 不合格 |

> 短剧一致性管控详见 `references/short_drama_consistency.md`

## 参数依赖链（不可编造）

> 以下参数**必须从上一步返回中提取，禁止编造**。

模式选择 → ModeSelection
  ↓ selected_mode, video_engine, image_engine
角色/场景设定 → CharacterSceneSetup
  ↓ characters[].id, scenes[].id, consistency_lock
分镜设计 → StoryboardFrames
  ↓ frames[].id, frames[].shot_type, frames[].prompt
提示词生成 → FinalPrompts
  ↓ prompts[].frame_id, prompts[].engine_specific

## 目录结构

```text
mad-story/
├── SKILL.md                 # 技能定义 v3.4.1 — 分层加载/双模式输出
├── README.md                # 使用说明
├── references/
│   ├── modes_detail.md      # 9种模式详细说明 (Layer 1)
│   ├── phases_detail.md     # Phase 0-7 详细推导指引 (Layer 1)
│   ├── prompt_engineering.md # 视频提示词5层结构+Negative Prompt (Layer 1)
│   ├── seedance_v2_rules.md # Seedance 2.0 提示词工程规范 (Layer 1)
│   ├── seedream_4x_rules.md # Seedream 4.x/5.x 图片生成规范 (Layer 1)
│   ├── terminology.md       # 影视分镜专业术语库 (Layer 1)
│   ├── pre_flight_checklist.md # 导演级预检清单 + 元反思（8 维度） (Layer 1)
│   ├── short_drama_consistency.md # 短剧全流程一致性管控 (Layer 2)
│   ├── short_drama_genres.md # 短剧6大题材模板 (Layer 1)
│   └── examples/
│       ├── example_1_creative_film.md
│       ├── example_2_multi_shot.md
│       └── example_3_short_drama.md
└── assets/
    ├── cheat_sheet.json     # 参数速查表 — 镜头语言/光影/声音/导演参考（单一数据源）
    └── storyboard_template.html # 分镜预览模板
```

> 独立工具包（CLI/API/验证）位于 `tools/mad-story-scripts/`，非技能运行时必需。

## 生成结果反馈回路 (DEFECT_LOG)

> **从静态知识库变成动态经验库。** 每次 Phase 7 输出的提示词不是终点——用户生成视频后返回的缺陷数据会让下一次输出更精准。

### 机制

```
Phase 7 输出提示词 → 用户生成视频 → 观察结果 → 报告缺陷类型
                                                      ↓
                                         DEFECT_LOG（按 Mode 累积）
                                                      ↓
                                         下次该 Mode 的 Phase 7:
                                         1. 检查 DEFECT_LOG 高频缺陷
                                         2. 在 NEGATIVE_PROMPT 追加针对性保护词
                                         3. 在输出中增加 KNOWN_RISKS 警告
```

### DEFECT_LOG 格式

用户返回生成结果后，按以下格式记录：

```
DEFECT_LOG:
  mode: [模式名]
  defect_type: [face_drift | object_deformation | motion_glitch | texture_collapse | color_shift | other]
  severity: [high | medium | low]
  timestamp: [在视频中出现的时间点，如 "8-10s"]
  description: [一句话描述具体问题]
  prompt_used: [当时的 STANDARD_PROMPT 摘要]
```

### 预填缺陷库（冷启动）

首次使用时，基于 AI 模型已知问题预填常见缺陷，用户只需确认或补充：

| Mode | 预填缺陷 | 默认增强措施 |
|------|---------|------------|
| Ecommerce | 产品标签 10s 后模糊 | NEGATIVE_PROMPT 追加 `no label degradation after midpoint` |
| UGC | 人脸 7s 后开始漂移 | 建议时长缩短至 10s；追加 `no late-stage face drift` |
| Cinematic | 高 Motion Strength(≥6) 触发物体融化 | Motion Strength 降级建议 + `no object melting at high motion` |
| Multi-shot | 第二/三镜头角色面部不一致 | 追加 `no character drift in later shots` |
| Short Drama | 跨集角色外观漂移 | 建议每集使用相同参考图 + seed |