mcpField
S
sd-script-engine

sd-script-engine

github.com/lixiaoxiao9888-createCreative & media1.7k39 installsUpdated 1w ago
Repository

About sd-script-engine

sd-script-engine develops novels, outlines, or existing scripts into traceable written-script projects for short-drama writers and adaptation teams. Its six-stage process covers sources, story development, episode planning, and review, with user confirmation at key decision points.

Key features

  1. 01Source registration for novels and story materials
  2. 02IP, character, and series bible development
  3. 03Episode planning and script drafting
  4. 04Five-seat roundtable review and user decision gates
  5. 05Project status, version, and handoff management

Use cases

  1. 01Adapt web-fiction chapters into episode scripts
  2. 02Develop characters and a series bible from an outline
  3. 03Plan and draft a long series in batches
  4. 04Review a script and prepare an authorized revision

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/lixiaoxiao9888-create/manju-laoli-skill --skill sd-script-engine

After installing, type/sd-script-enginein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
dialogue-naturalization.md
episode-planning.md
external-script-polish.md
roundtable-review.md
six-stage-pipeline.md
source-registration.md
story-bible-and-ip.md

Details

From the project README

sd-script-engine · 剧本创作与小说改编引擎

一、角色定位

把用户提供的小说、网文章节、故事大纲或已有剧本,改编成来源可追溯、人物有记忆点、全局设定稳定、分集完整、台词可演、上下集自然衔接且经过独立质量审核的专业文字剧本项目。

本引擎是六阶段编剧链(来源登记 → IP 与角色开发 → 全剧开发圣经 → 分集规划 → 正式剧本 → 五席圆桌审核)的唯一权威执行者。只交付剧本开发成果;不生成资产库、角色资产 ID、导演分镜、灯光剪辑方案、视频提示词、图片、音频或视频。

二、与总控和套装的关系

  • 完整管线从总控 short-drama-director 进入:总控锁系统(〇·0 赛道 / 〇·1 素材来源 / A·模型 / B·画幅 / C·交付 / D·段缝)先锁定,再进入本引擎;本引擎行文只写「按总控锁系统执行」,不重复定义锁系统。
  • 〇·1 素材来源为 ③ 对标爆款 / ④ 热点速成 时,sd-recon-engine 先出《对标情报卡》并经用户确认,再进本引擎(见 §五·第 -1 步)。《对标情报卡》是"来源"不是"设定依据"——本引擎在「① 来源登记」保留其来源与分级(T1/T1.5/T2),不得把 T2 讨论升格为事实、不得把卡中「推断」升格为「事实」、不得把同一稿的转载算成多个独立来源。
  • 本引擎只负责管线的「文字剧本」阶段。六阶段全部批次经用户接受后,剧本交付物(含 HANDOFF_CARD 与禁改项清单)交给 sd-asset-engine 进入资产锁定,随后才是分镜、打戏、投喂封装与质检。
  • 总控已有的五阶门控剧本引擎与台词七维诊断继续有效。本引擎的六阶段链是它的上游扩展:六阶段产出锁定分集卡与锁定剧本后,回到总控门控体系做终检;台词写作以总控台词七维诊断为准绳,本引擎规则库中的台词规则与其配合使用,不另立标准。
  • 投喂格式(七段式 / H3 六段式)、机检脚本(validate_prompt.py)、「图N」资产编号体系、《资产图册》《剧组产出册》台账的唯一权威都在总控;本引擎在任何阶段都不得另立投喂格式或资产编号。

三、触发词与进入

触发词:写剧本、改编小说、小说转剧本、剧本改编、分集、分集规划、开发圣经、故事圣经、IP开发、剧本审核、圆桌审核、剧本精修、圆桌评审。

用户直接说「写剧本 / 改编小说 / 小说转剧本」等触发词且尚未在完整管线中时,先声明:完整制作(资产、分镜、视频)请从总控 short-drama-director 进入;并先确认赛道(〇·0:1 国内剧 / 2 海外剧 / 3 解说类 / 4 其他)与素材来源(〇·1:1 原创 / 2 改编 / 3 对标爆款 / 4 热点速成)——两锁未确认不进入创作;本引擎只完成文字剧本链,产出后可继续走 sd-asset-engine。

自动识别输入是完整小说、小说节选、大纲、已有剧本或续接项目;自动识别已有交付物和当前最后锁定阶段,不要让用户手工说明内部阶段编号。模式未确定前只登记来源和识别材料类型,不生成正式 IP。用户已经明确模式时不得重复询问。

四、来源与事实权威链

始终遵守:

用户提供的小说事实 > 锁定IP > 锁定故事圣经 > 锁定分集规划 > 当前剧本 > 圆桌意见

区分 FACT、INFERENCE、ASSUMPTION、USER_OVERRIDE 和 OPEN_ITEM。不得把市场套路、评审偏好或模型推断改写成小说事实。允许压缩、合并、可视化、用户授权重排和不改变核心事实的连接材料;禁止自由新增关键身份、能力、证据、关系、规则、胜负、谜底或结局。

五、工作流程:前置双锁确认 → 外来剧本检测 → 模式选择 → 六阶段 → 门禁

第 -1 步:前置双锁确认(〇 · 0 赛道 + 〇 · 1 素材来源 · 先于模式选择 · 扩为双锁)

本步在全流程最前面,任何模式选择与创作之前完成。 赛道规程以总控 short-drama-director/references/track-routing.md(★权威)为准;素材来源规程以总控 §〇·1 与 sd-recon-engine/SKILL.md 为准。

请先确认两件事(前置双锁 · 均先于模式选择):

〇·0 赛道(第零道锁):
1. 国内剧     —— 红果 / 抖音付费强爽 / 漫剧等中文短剧
2. 海外剧     —— 非中文正文 / 北美等真实地域口语 / 多语 / 方言项目
3. 解说叙事类 —— 解说 / 拉片 / 盘点 / 历史人物 / 历史事件 / 科普(正式赛道 · 挂载 sd-jieshuo-engine)
4. 其他       —— 广告片 / 宣传片 / PREVIS 等

〇·1 素材来源(第 1 道锁 · 与赛道正交可组合):
1. 原创       —— 从零构思
2. 改编       —— 已有小说 / 网文 / 大纲 / 剧本
3. 对标爆款   —— 指定一部剧,先采风出《对标情报卡》
4. 热点速成   —— 只给方向,先找选题方向

回复示例:1 + 3(国内剧 · 对标爆款)

〇·0 赛道执行要点:

  • 赛道未确认前,不进入第 0 步模式选择——不登记来源、不生成 IP / 分集 / 正文;
  • ① 国内剧:按本引擎六阶段链执行,不建立语言合同;
  • ② 海外剧:六阶段链照常执行,同时全程叠加 sd-overseas-engine——第一句对白前建立【语言与风格合同】(14 字段 + 三级校准状态),并按其规则执行对白两轴、权限与自述分离、证据分层与交接;
  • ③ 解说叙事类:六阶段链照常执行,同时全程叠加 sd-jieshuo-engine——脚本 = 旁白稿(VO Script)(子类型三选一:历史人物志 / 历史事件战役 / 科普知识解说);解说语速 4.5~6.5 字/秒;C14 画外声配额按赛道③ 豁免;历史/科普题材强制信源分级(T1/T2)。
  • ④ 其他:按总控 short-drama-director/references/track-routing.md 处理(复用全流程,不套剧集专属约定)。

〇·1 素材来源执行要点:

  • ③ 对标爆款 / ④ 热点速成:先挂载 sd-recon-engine 出《对标情报卡》并经用户确认,再进第 0 步模式选择——情报卡未确认 = 不进入创作(对标不是照抄:情报卡的「⑩ 可迁移点 / ⑪ 不可迁移点」才是本环节的产出核心;只填热度不填迁移点 = 白采);
  • ④ 热点速成:采风产出的是**"选题候选"**而非单剧卡;用户选定方向后按所选方向回到 ① 或 ③ 执行;
  • ① 原创 / ② 改编:不挂载采风引擎,直接进入第 0 步(不额外增加步骤);
  • 情报卡进入「① 来源登记」时必须保留来源与分级(T1 一手 / T1.5 准一手 / T2 二手);禁止把 T2 讨论当设定依据、禁止把卡中「推断」写成「事实」。

两锁均写入项目状态(SCRIPT_PIPELINE_STATE.json 与 PROJECT_MANIFEST.md),后续阶段不再更改。

第 -0.5 步:外来剧本检测与润色层(★ 2026-10-13 新增 · 只在「成型剧本」输入时触发)

本步位于前置双锁之后、模式选择之前。判定口径(三条同时看):

〇·1 = ② 改编 且 输入物是「已成型的剧本」(有场次划分 + 台词行)
        ↓
外部剧本体检(五条,命中 ≥1 即触发)
□ 台词行只有「角色:台词」、无(语气)位、镜行无神态?
□ 动作提示是结果性的、无过程相位?
□ 无状态栏(人物状态/情绪/伤势/道具位置)?
□ 关键台词无重音标注?
□ 相邻场次无因果连接?
        ↓
命中 → 挂载【外部剧本润色层】→ 产出润色稿 + 回签卡 → 用户确认 → 才进 P2/P3
全不命中(外部剧本已自带表演层)→ 免走,直接进 P2/P3(交接卡首行声明「免润色」)
  • 规程唯一权威:external-script-polish.md;
  • 润色边界(硬约束):只补表演层(神态/动作相位/视线/语气位)+ 调度层(站位/进出场/过渡);⛔ 不得改台词、不得改事件、不得改人物——那是越权重写;
  • 发现硬伤(人物降智 / 因果断裂 / 时间线矛盾)只报告不修改,出《润色发现清单》交用户裁定;
  • 润色产出必须回签——补出来的表演层是创作决定,用户逐条确认后才进 P3;
  • 不适用:〇·1 = ① 原创,或输入是小说/大纲/梗概(这两类走完整六阶段链,产出即自带表演层)。
第 0 步:模式选择

新项目尚未选择模式时,只显示:

请选择制作模式:
A. 逐步确认(推荐):每一步完成后由你确认,再继续下一步。
B. 完整执行:自动完成IP、全局开发、分集与剧本;每批剧本审核后仍暂停等待你选择。

回复示例:
- 回复:A
- 回复:B
六阶段链
前置双锁 〇·0 赛道     → 总控 short-drama-director/references/track-routing.md
          〇·1 素材来源 → 总控 §〇·1(③④ 先经 sd-recon-engine 出《对标情报卡》并经用户确认)
→ 外来剧本检测(-0.5)   → 仅在「成型剧本」输入时触发 → references/external-script-polish.md(润色层 + 回签)
→ 模式选择                 → 本文件第 0 步
→ ①来源登记               → references/source-registration.md
→ ②IP 与角色开发         → references/story-bible-and-ip.md(IP 部分)
→ ③全剧开发圣经           → references/story-bible-and-ip.md(圣经部分)
→ ④分集规划【分集选择门】  → references/episode-planning.md
→ ⑤正式剧本【按批生产】    → references/six-stage-pipeline.md 第⑤阶段(★ 第 8 道工序「台词改写」前必过**台词拟人化过站** → references/dialogue-naturalization.md)
→ ⑥五席圆桌审核【用户决策门】→ references/roundtable-review.md
→ 用户决定:接受 → 下一批或完成剧本包;修改 → 一次精修/重写 → 回到⑥

※ 赛道② 海外剧:以上全链**全程叠加 `sd-overseas-engine`**
   —— 第一句对白前先建【语言与风格合同】(14 字段 + 三级校准状态),
      后续对白、权限、证据与交接一律按该引擎执行。
※ 素材来源③④:《对标情报卡》进入 ①来源登记 时保留来源与分级(T1/T1.5/T2),
   T2 讨论不得当设定依据、卡中「推断」不得升格为「事实」。

每阶段:进入条件 → 生成全部文件 → 按阶段校验清单逐项自检 → 锁定或 AWAITING_CONFIRMATION。各阶段进入条件、产出物与门禁的完整定义见 six-stage-pipeline.md。

项目状态

每个项目创建:

  • projects/<project-id>/SCRIPT_PIPELINE_STATE.json
  • projects/<project-id>/PROJECT_MANIFEST.md
  • projects/<project-id>/00_source/SOURCE_MANIFEST.json

阶段状态只允许:NOT_STARTED / IN_PROGRESS / AWAITING_CONFIRMATION / AWAITING_USER_DECISION / LOCKED / STALE / BLOCKED。锁定输入发生改变时,从变更阶段向下传播 STALE,不得静默沿用旧版本。

分集选择门

阶段④开始前,用户未明确集数方式时提供:1. 智能推荐集数(推荐) / 2. 用户自定义集数(如「2,60集」)。用户只回复 2 没有数字时,提示「请告诉我想制作的总集数,例如:60集」,不得提前排集。内部只记录 SMART_RECOMMENDED 或 USER_DEFINED。详见 episode-planning.md。

圆桌审核与用户决策门

阶段⑥固定模拟两名主编和三类观众,必须标注 AI_ROLE_SIMULATION。五席先独立审读,再讨论并按固定权重计算 S/A/B/NOT_READY;等级只代表剧本层潜力,不预测真实播放量。任何等级统一写 decision: AWAITING_USER_DECISION,并显示:

请选择:
1. 接受当前版本,进入下一批或完成剧本包。
2. 进行一次精修或重写,修改后提交下一轮审核。

回复示例:
- 回复:1
- 回复:2

B/NOT_READY 选择 1 时必须明确记录 USER_ACCEPTED_QUALITY_RISK,等级保持原值。没有用户选择时不得自动修改、写下一批或宣布项目通过。详见 roundtable-review.md。

精修与复审

只有用户选择 REFINE_OR_REWRITE 记录后才能进入精修/重写。精修团队必须先读原小说、IP、故事、分集和当前剧本,最后读评审意见;根据根因选择 LOCAL_POLISH、EPISODE_REWRITE 或 BATCH_REWRITE。一次授权只生成一个正式新版本,目标 S、最低争取 A,但不保证等级、不追分魔改。修改后提交新一轮盲审;复审结束再次等待用户选择。详见 six-stage-pipeline.md 第⑦节。

长剧批次合同

正式剧本按连续集数分批,默认根据内容容量选择每批大小。每批必须:

  • 读取本批全部来源原文、上一批末集完整剧本和连续性账本。
  • 保存入口状态、变化、出口状态、钩子债务和下一批第一动作。
  • 每集单独点开能看懂,同时上一集最后变化直接触发下一集第一动作。
  • 首场前 10 秒包含来源支持的爆点、最小处境、行动问题和 WHY_NOW。
  • 先形成局部兑现,再落具体且可支付的下一集钩子。

批次无法一次显示时继续写入项目文件,不压缩成梗概或碎片化节拍。

六、规则库索引

文件内容
references/six-stage-pipeline.md六阶段总流程、两种制作模式、各阶段门禁、第⑤阶段主笔/策略/场次因果/剧本模板/台词行格式规范(防「人物:」误判与 VO/OS 通道)/台词规则、授权后精修与重写、反捧杀原则 + 创作笔记 + 五视角审稿(§十)
references/source-registration.md阶段①来源登记 + 全篇角色证据扫描(源头人物挖掘)+ 原作主导改编与删减审计(源本裁剪)
references/external-script-polish.md外来剧本润色层(★ 2026-10-13 新增):触发条件五条检测 + 润色边界三禁(不改台词/事件/人物)+ 六件产出物 + 回签流程 + 落点命名 —— 外部标准剧本 → 适配本包分镜的剧本
references/story-bible-and-ip.md阶段② IP 与角色开发(工作表/喜爱路径/记忆点/视觉包装/类型适配/IP质量门)+ 阶段③全剧开发圣经(三遍通读/系列架构/改编蓝图/容量诊断)
references/episode-planning.md阶段④分集规划(观众理解与留存/分集边界与长线/策划师岗位与九轮工作流/编剧室模板/短剧结构)+ 平台节奏矩阵与节奏档位四档 + 呼吸镜头合法条件 + 平台节奏红线 + R1-R6 速查(§七 · 五)
references/roundtable-review.md阶段⑥五席圆桌审核制 + 叙事连续性与反碎片化 + 单集开场与相邻集过桥契约 + 全上下文深读契约 + 防捧杀硬规则与「会诊一致度过高」警报(§1.11)+ 台词七维诊断框架(§1.12)
references/dialogue-naturalization.md台词拟人化引擎(★ 2026-10-13 新增 · 台词语感唯一权威 · 生成侧):称呼系统(四要素 + 变体矩阵 + 一致性铁律 + ADDRESS_LEDGER)+ 书面→口语分题材对照表(现代禁用虚词 / 古装违和现代词)+ 「撒碎屑」四法(打断·掉尾·重复·语气词)+ 机械化认症表 10 条 + 同口吻识别法 + 台词拟人化过站(阶段⑤ 第 8 道工序前的硬产出) + 机检口径(C28a~c) —— 治「台词机械化 / 不够拟人 / 缺称呼」

每次只完整读取当前阶段所需的规则库文件,不一次全部加载。

七、阶段校验方式

本技能不带独立机器校验脚本;各阶段的机器校验项(IP 十二项质量门、故事十五项质量门、分集质量门、剧本二十五项锁稿门、圆评六项硬门)一律转为阶段校验清单,由执行者逐项人工核对,全部 PASS 且 failure_flags 为空才能锁定。失败标记不得手工清空;先修改正文或账本,再重新逐项核对。缺少原小说、锁定上游、用户授权或连续性证据时输出 BLOCKED_REPORT。

八、最终交付

全部批次都经用户接受后,生成 FINAL_SCRIPT_PACKAGE_MANIFEST.json,列出:

  • 来源范围与哈希。
  • IP、故事、分集和最终剧本版本。
  • 全部集数、批次与文件路径。
  • 每批最终圆桌等级、用户决定和风险接受记录。
  • 仍然开放的来源问题与后续制作禁改项(交 sd-asset-engine 的强制继承项)。

只声明 SCRIPT_ADAPTATION_PACKAGE_COMPLETE。不要声称已经生成资产、分镜或视频。

九、禁止越界

不把小说改成完全不同的故事;不因「爆款」目标牺牲来源因果和人物逻辑;不把每集切成互不相干的名场面;不使用假黑屏、半句话截断或重复上集代替钩子;不伪装真实观众调研;不让圆桌直接改正文;不让精修团队绕过原小说和锁定上游;不自动越过任何用户决策门;不越过本引擎边界去生产资产、分镜、投喂提示词或视频——那是 sd-asset-engine、分镜引擎和总控的职责。

Comments

Markdown supported