--- name: short-drama-write description: 编写或修订可拍摄的中文短剧、漫剧单集 Markdown 剧本,也负责保留作者原文并把现成剧本整理成标准格式。用户提出“写/改一集短剧”“把大纲写成剧本”“优化场景/对白”“去模板感”“去 AI 味润色”“续写下一集”或提供剧本要求进入后续制作时使用;不负责视觉设定、分镜、生图与视频提示词或终审。 license: MIT --- # 短剧写作 把单集构思写成能演、能拍、能实实在在往前推剧情的 `剧集//剧本.md`。 ## 快速开始 只维护一份剧本 Markdown,不另建单集卡片、节拍表、段落索引、录音表、质检单或确认记录。 一级标题写 `# EP001 集名`,场景标题写 `## EP001-SC001 内 · 地点 · 时间/天气`(`·` 两侧空白可灵活排版)。 对白写 `角色(可选语气/顺手小动作提示):台词`,支持带空格的外文角色名(如 `Dr. Lin`、`Agent K`)与全半角括号提示;制作标记使用 `[VO]`、`[OS]`、`[SFX]`、`[画面文字]`、`[连续性]`、`[转场]`。动作段开头避免写“短词组+全角冒号”,以免与对白撞车。 ## 入口 - 有分集大纲或合一简纲:看清本集开场接什么局面、人物眼下争什么、核心变化与集尾落点后直接动笔。 - 只有点子或粗纲:在当前对话里理顺本集核心看点和前因后果,直接写剧本,不必补建上游拆书或长剧状态账。 - 已有剧本定稿:尊重作者原有文风口吻,只按用户指定位置做局部修改;“去 AI 味”润色不磨平作者个人口吻。 - 排版不统一的来稿要进制作:原字保留台词与剧情,只把场次、动作、对白和制作标记整理成标准格式。 ## 工作流 1. 定准本集核心看点(爽点、悬念、笑点或情感落点)、开场承接局面、当集落定结果与集尾停点。 2. 在对话上下文里顺清各场戏的作用与场尾变化,不另存节拍表;把动作、对白、画外音、关键音效和画面文字一并写进 `剧本.md`。用户要求写整集就一口气写完整集,分场续写时自动往下接。 3. 交稿前通读自检一遍:核对现有材料事实与 `必须/禁止` 要求,清掉专替观众补背景、复述刚演完动作或原地车轱辘的废句(创作者原稿台词不删改),对照[精简打磨与删繁就简](references/script-craft.md#81-精简打磨与删繁就简)压实篇幅。 ## 写作要求 - 守住现有材料定好的事实、题材路数和集尾落点;严禁凭空编造原稿没有的精确数字、记录、资源、流程、人物关系或机关设定;凡会改写核心剧情走向的分岔点先请用户确认。 - **对抗场默认做法**:正面交锋场次写清谁占上风、谁拿到筹码或处境更险,破局靠前文有迹可循的实据、权限、代价或人物出招,少靠对手无故失声或天降外援;温情、喜剧、悬疑留白与过场消化戏顺应本场情绪节奏,推进知情范围、人物关系或连戏状态即可,不必场场硬拧反转。 - 关键剧情转折靠看得见、听得着的动作与物证状态演出来,不拿大段无法拍摄的心理说明替代行动;实拍与漫剧均可适度用 `[VO]` 表现言行反差或跨时空浓缩。挑大梁的对手要有盘算与招数,走过场的龙套干净利索不硬加支线。 - 全集第一拍单拎出来就要抓人,冲突动作、反常景象,或规则怪谈、系统弹窗、报警录音等强视听冲击的文字/声音钩子均成立(见[开场直接接住上集局面](references/script-craft.md#71-开场直接接住上集局面))。 - 两难抉择、争议物证查验、限定次数/轮次、精确倒计时仅在大纲将其作为核心戏眼时启用(见下节参考指南),寻常决定、普通道具和笼统的“赶时间”不硬拔高成精密机关。 - 前文核心硬代价、关键道具归属、知情范围与连戏状态到集尾前后对得上;制作标记使用固定方括号语法由脚本校验,而 `[连续性]` 只交接前文已演出、后续分镜易漏的状态变化(不单靠备注断言镜头外“从未发生某事”)属写作与审稿把关的 `SCR-05` 语义要求。`end_on_peak` 为 `true` 时直接卡在高潮点收尾(见[项目节奏设定](references/script-craft.md#64-项目节奏设定))。 - 按目标时长压稿时,先砍过场水分、重复查验与嘴碎解释;爽剧对抗高潮推荐保留爆发台词、一锤定音的决绝话与收场动作这组配合(`SCR-23`),不拿固定字数、镜头数或节拍数硬套填空模板。 ## 分场景参考指南 平时只看本说明和手头材料即可;遇到以下情况再翻阅对应文档: - 本环节职责边界与规则分级:[阶段职责与规则](references/stage-contract.md) - 场景标题、对白与制作标记语法,或把现成剧本[整理成标准格式](references/screenplay-format.md#7-现成剧本整理成标准格式):[剧本格式规范](references/screenplay-format.md) - 三角符号等剧组来稿排版转换:[片场制作稿格式](references/production-format-dialect.md) - [两难抉择](references/script-craft.md#33-写两难抉择时两条路都得有得有失)、[限定次数或轮次](references/script-craft.md#63-限定次数与轮次按演完结果算数)、[精确倒计时](references/script-craft.md#62-倒计时先算动作不要只写数字)、[争议物证查验](references/script-craft.md#52-证据先改变判断再改变关系)、[实用声音叙事与留白](references/script-craft.md#65-实用声音叙事与留白)或[低成本视听替代与备选拍法](references/script-craft.md#82-低成本视听替代与备选拍法):[剧作方法](references/script-craft.md) - 借对白带出往事、拉开人物口吻与潜台词,或写[外语台词](references/dialogue-craft.md#62-外语台词英语先亮结论日韩语切忌套用英语语序):[对白写法](references/dialogue-craft.md) - 使用 `[VO]`、把小说心理描写外化成动作或拍实人物痛点:[能演的不说](references/script-craft.md#44-能演的不说vo内心独白与痛点) - `short-drama.json` 中 `creator_authority.rhythm_profile` 状态为 `accepted`:[项目节奏设定](references/script-craft.md#64-项目节奏设定) ## 时长估算(按需) 用户问起时长、压稿核对篇幅,或需查看 `[VO]` 占比与漫剧 `speech_share` 时,直接对单集剧本运行内存解析估时(无需提前生成索引文件或备份旧稿;Windows 可用 `py -3`): ```text python3 {技能目录}/scripts/duration_estimate.py --script 剧集//剧本.md ``` 有 `short-drama.json` 时可追加 `--project short-drama.json` 读取项目语速与节奏设定;本集单独设了目标时长时可追加 `--target-seconds <秒数>`;若罕见单次角色名触发 `incomplete`,可追加 `--extra-speaker <角色名>`(可重复传入,在自动识别、篇首/场首 `人物:` 声明或已有索引说话人之上补充;`--speaker <角色名>` 则覆盖说话人白名单,`--script` 与 `--index` 模式均支持)。 统计说明: - `dialogue_characters`(含标点)用来算 `vo_share`(`[VO]` 占全部台词字数比例;`[OS]` 计入分母、不计入分子);`voiced_characters`(去标点实读字)与空格分词外语 `voiced_words` 分别按字数/词数语速折算秒数,未配置语速的单位列在 `untimed_speech`。 - 全部台词都有语速配置时输出 `speech_seconds` 与 `speech_share`,漫剧参考见[漫剧靠声音往前推](references/script-craft.md#45-漫剧靠声音往前推)。 - `[画面文字]`、`[SFX]`、`[转场]` 行数列在 `untimed`;配置了 `on_screen_text_characters_per_second` 时,`[画面文字]` 计入 `on_screen_text_seconds`。未配置语速或动作速率时,只报实打实的字数与段落计数,不瞎猜秒数。 ## 完成 用户指定的集场范围已写进 `剧本.md`,前后因果顺畅,对白与动作演得出来,集尾落到预定位置即算完稿。视觉设定、分镜、审查与素材生产只在用户点名时才启动;写完后可交 `$short-drama` 做局部格式与引用核对。 ## 安装维护 仅在安装、升级或排查故障时运行 `python3 {技能目录}/scripts/selftest.py`。