novel-to-script

name	novel-to-script
description	将小说/故事转化为专业影视剧本的完整工作流 Skill。当用户输入小说、短篇故事、故事大纲，并要求生成/改编为影视剧本、电影剧本、TV 剧本时使用。触发关键词：小说改编剧本、生成剧本、故事转剧本、novel to script、story to screenplay、写剧本、改编成剧本。输出符合专业影视行业格式规范的中文剧本，并为下游 storyboard 工作流生成视觉合约文档。

novel-to-script — 小说/故事 → 影视剧本

概述

本 Skill 将输入的小说或故事文本，通过六个阶段的结构化工作流，生成专业影视剧本。

• 输出语言：中文（默认）
• 输出位置：/Users/pixies/Library/Mobile Documents/iCloud~md~obsidian/Documents/Mydoc/02_Projects/Script Workflow/Output/<作品名>/
• 人工确认节点：Phase 2（Beat Sheet）+ Phase 3+4（人物/场景档案）完成后需用户确认，再继续 Phase 5
• 下游接口：输出的 characters.md（含视觉档案）和 locations.md（含场景视觉基准）直接供 Storyboard 工作流调用

---

Reference 文档位置

所有参考规范文档已内置于 skill 目录：references/

文件	用途
references/script-adaptation.md	Phase 1+2：改编原则与媒介转化
references/script-plot.md	Phase 2：三幕结构与节奏设计
references/script-characters.md	Phase 3：人物塑造与视觉档案规范（含主要角色数量核对）
references/script-scenes.md	Phase 4：场景环境与视觉基准规范（含主要场景数量核对）
references/script-format.md	Phase 5：剧本格式规范（含代码块格式要求）
references/script-dialogue.md	Phase 5：对白创作规范（隐藏问题/欲望不对称/信息转化为武器/潜文本技法）
references/script-narrative.md	Phase 5：叙述性描写规范（选择即意义/节奏类型快中慢/形象系统/四行上限/具象动词/可拍摄性）
references/script-qa.md	Phase 6：质检标准（含叙述质检/数量核对/AI错误清单扩充）

执行前必须读取对应 Phase 的 Reference 文档（路径相对于 skill 目录解析）。

---

工作流总览

[用户输入] 小说/故事文本 + 作品名
    ↓
Phase 1：改编分析          → story-analysis.md
    ↓
Phase 2：结构设计          → beat-sheet.md          ★ 等待用户确认
    ↓
Phase 3：人物档案          → characters.md           ★ 等待用户确认
Phase 4：场景视觉基准      → locations.md            ★（Phase 3+4 并行）
    ↓ 确认后继续
Phase 5：场景正文生成      → scenes/SC_xxx.md（分幕并行 sub-agent）
    ↓
Phase 6：QA 质检           → qa-report.md + final-script.md
    ↓
[输出] 完整剧本 + 视觉圣经文档

---

输出目录结构

Output/<作品名>/
├── story-analysis.md       ← Phase 1
├── beat-sheet.md           ← Phase 2（确认节点）
├── characters.md           ← Phase 3（确认节点，含视觉档案）
├── locations.md            ← Phase 4（确认节点，含场景视觉基准）
├── scenes/
│   ├── SC_001.md
│   ├── SC_002.md
│   └── ...                 ← Phase 5
├── full-script-draft.md    ← Phase 5 合并
├── qa-report.md            ← Phase 6
└── final-script.md         ← 最终输出

---

Phase 1 — 改编分析

读取：references/script-adaptation.md

输入：原始小说/故事文本

任务：

1. 媒介转化分析（哪些内心独白/修辞/意识流内容必须转化为外部动作）
2. 叙事视角处理方案（第一人称/内心独白如何外化）
3. 主要人物清单（姓名 + 一句话功能定位 + 初始状态）
4. 主要地点清单（地点名 + 空间性质）
5. 核心戏剧性动作（驱动整个故事的外部冲突，一句话）
6. 叙事结构判断（线性/非线性，时间跨度）

输出：story-analysis.md

---

Phase 2 — 结构设计（厚版 Beat Sheet）

读取：references/script-plot.md + references/script-adaptation.md

输入：原始小说全文 + story-analysis.md

任务：

1. 确定三幕结构比例和总场景数
2. 定位七大转折点（激励事件/情节点I/中点/情节点II/危机/高潮/结局）
3. 为每一个场景生成叙事摘要（见下方格式）

每个场景的叙事摘要格式：

SC_编号 INT./EXT. 地点 - 时间
幕次：第X幕
功能：（这个场景在整体结构中的戏剧功能）
原著对应：（原著哪个段落/章节，直接引用关键内容）
核心动作序列：（人物做了什么，3-5个外部可见动作，按顺序列出）
情绪走向：（场景开始→场景结束的情绪变化）
隐藏问题：（这场戏中不能被直接说出的核心张力，一句话；纯动作场景填"无"）
叙述节奏：（快 / 中 / 慢；快=动作堆叠，中=感知积累，慢=流动叙述）
场景结束状态：（这个场景结束时，情况如何了？为下一场景做什么铺垫）
原著保留项（Phase 5 必须继承，Phase 6 必须核对；如无则填"无"）：
  - [情节/道具/动作]：原著中必须在剧本里体现的情节要素、具体道具、人物动作，逐条列出
  - [台词/含义]：原著中值得保留的关键台词，或需要传达的核心含义，逐条列出；转化方式不限，含义相符即可

重要：Beat Sheet 是整个工作流的核心。每个场景摘要必须内容充分，包含原著信息提取，让后续 Phase 5 不需要再读原著。原著保留项 是防止关键信息在多步工作流中丢失的唯一机制——凡有重要情节细节、视觉焦点、原著台词或核心含义的场景必须填写。Phase 5 自行判断转化方式，不受限制。

输出：beat-sheet.md

⚠️ 确认节点：输出完成后，向用户展示 beat-sheet，说明场景总数和三幕结构，请用户确认。用户说"确认"或"继续"后才执行 Phase 3+4。

---

Phase 3 — 人物档案

读取：references/script-characters.md

输入：story-analysis.md + beat-sheet.md

任务：

步骤 0：主要角色数量核对（必须先执行）

1. 从原著逐章提取主要角色清单（有名字/台词/显著动作/在2个以上场景出现的角色）
2. 记录原著主要角色总数 N_char
3. 后续生成的【角色视觉档案】数量必须 ≥ N_char
4. 允许合并：功能完全重复的次要角色可合并，但档案中需注明

步骤 1-5：生成每个主要角色的以下内容：

1. 欲望（表层目标）/ 需求（深层动机）/ 恐惧
2. 人物弧光（从开始到结束的变化轨迹）
3. 关键行为模式（在剧中反复出现的行为特征）
4. 角色关系图谱
5. 【视觉档案】（必须完整填写，格式见 references/script-characters.md 零章节）

步骤 6：缺漏自检

• 对照原著清单逐一确认每个主要角色都有对应【角色视觉档案】代码块
• 有台词/动作但未生成视觉档案的角色必须补充

输出：characters.md

---

Phase 4 — 场景视觉基准

读取：references/script-scenes.md

输入：beat-sheet.md（地点列表）

步骤 0：主要场景数量核对（必须先执行）

1. 从原著提取主要地点清单（有具体地名/承载完整场景/被多次提及/对情节有功能性的地点）
2. 记录原著主要地点总数 N_loc
3. 后续生成的【场景视觉基准】数量必须 ≥ N_loc
4. 允许合并：功能相同、空间特征相似的地点可合并，但基准中需注明

步骤 1：生成每个主要地点的【场景视觉基准】（格式见 references/script-scenes.md 零章节）：

• 地点代码（与 SC 标题一致）
• 空间性质
• 基本布局
• 光线默认状态
• 固定视觉标志物（≥3个，可识别的具体物件）
• 可变元素

步骤 2：命名一致性检验

• 同一地点跨场次的标题命名必须保持一致
• 分镜工作流依赖命名识别同一空间

步骤 3：缺漏自检

• 对照原著清单逐一确认每个主要地点都有对应【场景视觉基准】代码块

输出：locations.md

Phase 3 和 Phase 4 可以并行运行（spawn 两个 sub-agent 同时执行）。

⚠️ 确认节点：Phase 3+4 完成后，向用户展示人物档案和场景视觉基准，请用户确认。用户说"确认"或"继续"后才执行 Phase 5。

---

Phase 5 — 场景正文生成

读取：references/script-format.md + references/script-dialogue.md + references/script-scenes.md + references/script-narrative.md

输入：beat-sheet.md + characters.md + locations.md

分幕并行策略：

• 按幕分 3-4 个 sub-agent 并行生成
• 每个 sub-agent 获得：完整 characters.md + locations.md + 本幕的 beat-sheet 片段 + format/dialogue/scenes/narrative 规范
• 注意：Phase 5 sub-agent 不需要原著全文，所有必要的叙事信息已在 beat-sheet 的场景摘要中

每个场景必须包含：

1. 场景标题（SC_编号 INT./EXT. 地点 - 时间）
2. 叙述性描写——严格遵循以下规则（来自 references/script-narrative.md）：
   • 可拍摄性：只写摄影机能看见的 + 话筒能听见的，绝对现在时
   • 四行上限：每段最多4行，理想1-2行，一段一意
   • 具象动词：疲惫→踉跄/拖行；谨慎→贴墙挪动/蹑手蹑脚；傲慢→大步迈入；犹豫→退缩/停顿；急迫→冲出/飞奔
   • 可拍摄性禁令：内心想法/记忆/顿悟/情绪告知/作者介入——全部禁止，违者必须转化为外部动作
   • 暗示镜头：禁止摄影机指令，通过描写细节引导视觉焦点
   • 动作堆叠：快节奏序列每行一个动作，段落间留空行
   • 节奏设计：按 beat-sheet 中的叙述节奏字段选择模式——快（动作堆叠）/ 中（感知积累）/ 慢（流动叙述），全幕节奏不得均速
3. 对白块（有潜文本、有角色个性、简洁有力）——必须使用代码块格式，内容4空格缩进
4. 场景收尾动作（明确的视觉结束点）

对白质量要求（来自 references/script-dialogue.md）：

• 80% 视觉，20% 对白原则
• 禁止直白说出情感（"我很难过" → 动作替代）
• 每句台词必须有潜文本或推进戏剧
• 写对白前先确认 beat-sheet 中的隐藏问题，所有台词围绕它兜圈子
• 检查两个角色欲望是否有结构性冲突（欲望对称 = 台词平）
• 信息型场景：背景信息必须转化为角色在压力下使用的武器，不得平静传递

输出：每个 SC 一个文件 → scenes/SC_001.md，完成后合并为 full-script-draft.md

---

Phase 6 — QA 质检

读取：references/script-qa.md

输入：full-script-draft.md + beat-sheet.md

质检项目：

1. 三幕结构比例验证（按场景数比例，非页数）
2. 七大转折点位置对照
3. 对白质量抽检（AI味检测：过度解释型、情绪说明型、总结型台词）
4. 场景级对白前置检验：对话场景确认隐藏问题存在、欲望不对称存在；信息型场景确认信息已转化为武器
5. 场景可拍摄性检查（无内心独白，无纯文学描写）
6. 视觉合约完整性（characters.md 视觉档案 + locations.md 视觉基准是否齐全）
7. SC 编号连续性检查
8. 叙述描写质检（新增）：
   • 可拍摄性：有无"他想/她感到/他记得/她知道/他意识到"、"我们看见/我们听见"、解释动作含义的句子
   • 节奏分布：全剧快/中/慢分布是否有意对比，均速视为质检失败
   • 动词精准度：有无模糊动词未替换为具象动词
   • 格式：全程现在时态、快节奏序列是否使用动作堆叠
9. 视觉档案与场景数量核对（新增）：
   • 对照原著清单，【角色视觉档案】数量 ≥ 原著主要角色数
   • 对照原著清单，【场景视觉基准】数量 ≥ 原著主要地点数
   • 同一地点跨场次命名一致性验证
10. AI错误清单逐项检查（新增）：叙述文学化、动词不具象、内心活动残留、视觉档案遗漏、格式错误（视觉档案/元数据/对白未用代码块）
11. 原著保留项核对（新增）：
    • 逐场对照 beat-sheet 中的 原著保留项 字段
    • [情节/道具/动作] 类：确认每条在剧本正文中有对应呈现，遗漏标记为【严重缺失】
    • [台词/含义] 类：确认核心含义已在剧本中呈现，转化方式不作限制（对白/动作/场景细节均可）；完全缺失标记为【严重缺失】
12. 跨场景逻辑一致性核查（新增）：
    • 道具状态连贯：关键道具在不同场景间的物理状态是否前后一致
    • 人物行为连贯：同一人物的行为模式、能力边界、身体状态在全剧是否保持一致
    • 空间逻辑：人物移动路径是否物理可行；同一空间布局描写是否一致
    • 时间逻辑：场景间时间跳跃是否有清晰视觉标记
    • 发现逻辑断裂时标记为【逻辑断裂】，说明断裂位置（SC_XXX → SC_XXX）和具体矛盾

AI生成后必做修正步骤：

1. 长台词拆分（连续独白必须用动作/表情/反应岔开，不允许不间断大段独白）
2. 删除内心描述（"他想"、"她感到"、"他意识到"等）
3. 强化动作（视觉动作替代解释性对白）
4. 检查转折（每个转折点改变游戏规则或赌注）
5. 对白去味（消除AI解释性语气、总结性台词）
6. 潜文本还原（"写在鼻子上"的台词改用反衬或置换法）
7. 叙述动词替换（模糊动词→具象动词）
8. 删除副词（换用本身携带情感色彩的动词）
9. 数量核对（对照原著，视觉档案和场景基准无遗漏）
10. 格式核对（视觉档案/场景基准/元数据/对白块均为代码块格式）
11. 节奏检查（检查全剧叙述节奏分布，设计快/中/慢对比，均速须修正）
12. 场景级对白诊断（每个对话场景确认隐藏问题 + 欲望不对称；信息型场景确认信息已武器化）
13. 必须呈现修复（qa-report 中标记【严重缺失】的项目必须在 final-script.md 中补全）
14. 跨场景逻辑修复（qa-report 中标记【逻辑断裂】的问题必须在 final-script.md 中修正后才能交付）

⚠️ 强制输出规则：

• qa-report.md 是 Phase 6 的必要输出，不得省略
• qa-report.md 必须在 final-script.md 之前写入文件
• 如果 qa-report.md 未生成，Phase 6 视为未完成，不得输出 final-script.md
• qa-report.md 必须包含：逐项检查结果（含通过/失败标记）+ 所有问题列表 + 【严重缺失】和【原著偏离】标记 + 整体评分

输出（按顺序）：

1. qa-report.md（逐项检查结果 + 问题列表 + 评分，必须先写）
2. final-script.md（修订后完整剧本，供 storyboard 调用，qa-report 写完后再写）

---

执行规则

1. 语言：所有剧本内容（场景描写、对白）均用中文输出
2. 文件写入：每个阶段完成后立即写入文件，不要等全部完成再写
3. 确认节点不可跳过：Phase 2 和 Phase 3+4 必须等待用户明确确认
4. Reference 文档优先：遇到格式、结构、对白的具体问题，以 Reference 文档内容为准
5. 视觉合约必须完整：视觉档案（characters.md）和场景视觉基准（locations.md）是向下游 storyboard 传递的合约，不得省略任何字段
6. 对白禁止内心叙述：剧本是视觉媒介，不写"他心想"、"她感到"等内心描述

---

启动方式

用户提供：

1. 小说/故事文本（直接粘贴或提供文件路径）
2. 作品名（用于创建输出文件夹）

立即开始 Phase 1，无需询问更多参数。