小说剧本转分镜脚本 Skill v1.0

功能概述

触发条件

当用户提出以下需求时，立即加载并执行本 Skill：

• "把这篇小说/剧本转成分镜脚本"
• "帮我分析剧本的角色特征/场景特征"
• "我有一段文案，帮我出分镜"
• "根据脚本生成角色卡"
• "小说转分镜"、"剧本分镜"

工作流程

用户提供文案（粘贴文本 or 文件路径）
        ↓
[步骤 1] 读取 & 清洗文本
        ↓
[步骤 2] 段落切分 & 类型标注（叙事/对白/动作/场景标头）
        ↓
[步骤 3] 场景聚合 → 场景特征分析（地点/时间/氛围/色调）
        ↓
[步骤 4] 角色提取 → 角色特征分析（外貌/性格/对白统计）
        ↓
[步骤 5] 分镜脚本生成（镜头类型/摄影机运动/光线/音效）
        ↓
[步骤 6] 输出 Markdown 报告 + 可选 JSON 数据

使用方式

方式一：直接粘贴文案

用户将小说/剧本文字粘贴到对话框，AI 直接处理，无需文件。

用户：帮我把下面这段剧本转成分镜脚本：
[粘贴文案内容]

此时 AI 无需调用脚本，直接按照分镜模板在对话中输出结构化内容。

方式二：文件处理（调用 Python 脚本）

当用户提供 .txt 或 .md 文件时，调用核心脚本处理：

# 基础用法（输出 Markdown）
python "C:\Users\drago\.workbuddy\skills\novel-to-storyboard\scripts\parse_novel.py" "C:\path\to\novel.txt"

# 指定输出目录 + 同时输出 JSON
python "C:\Users\drago\.workbuddy\skills\novel-to-storyboard\scripts\parse_novel.py" "C:\path\to\novel.txt" -o "C:\output" -f both

# 只输出 JSON（供程序化使用）
python "C:\Users\drago\.workbuddy\skills\novel-to-storyboard\scripts\parse_novel.py" "C:\path\to\novel.txt" -f json

命令参数说明：

输出内容说明

1. 分镜脚本（Storyboard）

每个镜头包含：

2. 角色特征卡（Character Cards）

每个角色包含：

3. 场景特征卡（Scene Cards）

每个场景包含：

文本格式建议（获得最佳效果）

为了让 AI 更准确地识别场景、角色和对白，建议文案遵循以下格式：

推荐格式：剧本格式

第一场 旧街道 黄昏

街道上行人稀少，橙红色的夕阳把影子拉得很长。

林默（站在路口，望着远处）：我知道你一直在这里。

阿九（从阴影中走出，声音低沉）：你终于来了。

（两人对视，沉默片刻）

---

第二场 咖啡馆内 夜晚

咖啡馆里灯光昏黄，角落里只剩最后一桌客人。

也支持：小说叙事格式

林默站在旧街道的路口，夕阳把他的影子拉得很长。他是一个三十岁出头的男人，眼神里总带着一丝不动声色的警惕。

"我知道你一直在这里。"他开口说，声音平静。

阿九从阴影中走出来。她的脸容姣好，但眉宇间有一种说不清的压抑。"你终于来了。"

AI 直接输出模式（无文件时）

当用户粘贴文案时，AI 直接在对话中输出以下结构：

输出模板

## 统计摘要
- 总镜头数：XX
- 场景数：XX
- 角色数：XX

---

## 分镜脚本

### 场景 1：[场景名]
地点：室内/室外  时间：白天/夜晚  氛围：紧张/温馨...

#### 镜头 1  `全景`
| 项目 | 内容 |
|------|------|
| 画面内容 | ... |
| 出场角色 | ... |
| 摄影机运动 | ... |
| 光线 | ... |
| 色调 | ... |
| 音效 | ... |
| 对白 | ... |

...（后续镜头）

---

## 角色特征卡

### 林默
| 属性 | 内容 |
|------|------|
| 总出场次数 | 15 |
| 对白条数 | 8 |
| 外貌特征 | 三十岁出头，眼神警惕 |
| 性格特征 | 沉稳，不动声色 |
| 代表台词 | 「我知道你一直在这里。」 |
| AI 绘图提示词 | `林默，三十岁男性，警惕眼神，电影级写实风格` |

---

## 场景特征卡

### 场景 1：旧街道 黄昏
| 属性 | 内容 |
|------|------|
| 地点类型 | 室外 |
| 时间 | 黄昏 |
| 氛围 | 神秘 |
| 色调 | 深蓝紫暗调 |
| 光线 | 暖橙逆光 |
| AI 场景提示词 | `旧街道黄昏，室外，暖橙逆光，神秘氛围，8K电影分镜概念图` |

镜头类型推断规则

氛围色调映射表

快速使用示例

用户输入：

帮我把下面这段文案转成分镜脚本：

林默推开门，走进昏暗的地下室。角落里坐着一个人，背对着他。

"你找到我了。"那人没有回头，声音沙哑。

林默慢慢走近，手放在腰间的枪上。"游戏结束了。"

（两人对峙，空气凝固）

AI 输出：
- 统计：4 个镜头，1 个场景，2 个角色
- 分镜：建立镜头（全景，推镜头）→ 对白镜头1（近景）→ 对白镜头2（近景）→ 对峙特写
- 角色卡：林默（动作主导）、未知角色（对白出场）
- 场景卡：室内·地下室·夜晚·紧张氛围·高对比冷蓝绿

文件结构

novel-to-storyboard/
├── SKILL.md                  ← 本文件（技能文档）
├── skill.json                ← 技能元数据
└── scripts/
    └── parse_novel.py        ← 核心处理脚本（文件模式使用）

注意事项

1. 中文剧本格式 支持最佳，英文剧本（INT./EXT. 格式）同样支持
2. 对白识别 依赖 角色名：台词 格式，如格式不规范可能漏识别
3. 场景切分 优先识别 第X场、INT.、EXT.、场景X 等标头；无标头则按双空行自动切分
4. 特征提取 基于关键词规则，复杂隐晦的描述可能需要 AI 进一步人工补充
5. 长文本 建议使用文件模式（.txt），对话模式适合 5000 字以内的文案

novel-to-storyboard Skill v1.0 — 2026-04