编写或修订可拍摄的中文短剧/漫剧单集 Markdown…

当需要把单集大纲或想法写成可表演、可拍摄的短剧剧本，或对已有中文剧本做定点修订、去 AI 味、续写与规范化时使用。

适用场景

解决思路

1. 只维护一份剧本 Markdown，不另建 episode card、beats、block index、录音表、QA 或接受记录。
2. 一级标题使用 `# EP001 集名`，场景标题使用 `## EP001-SC001 内 · 地点 · 时间/天气`。
3. 对白写 `角色（可选表演提示）：台词`；生产标签使用 `[VO]`、`[OS]`、`[SFX]`、`[画面文字]`、`[连续性]`、`[转场]`；不要把含冒号的动作叙述误写成对白。
4. 入口判断：有分集规划时，读取本集进入状态、目标、转折、回报和交接事实。
5. 入口判断：只有想法/大纲时，在上下文形成最小单集契约和因果节拍，再直接写剧本。
6. 入口判断：已有剧本时，保留作者语言，只做用户点名的定点修订。
7. 入口判断：非规范文本要进入制作时，保留原文，只做必要的场景、动作、对白和生产标签规范化。
8. 开发大纲和长篇分析都是可选上游；当前材料足够时直接写。
9. 锁定本集承诺的观看体验、谁现在要什么、阻力、当集兑现和退出状态。
10. 只识别本集实际存在的发动机：若主打艰难选择，检查两边价值；若判断转折依赖争议证据，检查证明边界；若前景化精确死线，检查动作容量；若题面限定次数、轮次、呼吸或节拍，检查每个单位是否在边界内完成所需状态。没有时不强行补齐；输入已经以它为主发动机时，要让它真正改变行动、关系或结果，不只在台词中点名。
11. 在上下文排“因为—行动—结果—下一股压力”，不落盘节拍表；让物件、对白、沉默、空间或声音按本集题材承担必要工作，不预设某一种载体。
12. 逐场确定不可替代的功能、可见变化与场尾状态；由争取或冲突组织的场景再明确焦点议程与阻力。
13. 承担主要戏剧功能的配角要有自己的策略，事务性或环境性角色保持简洁即可。
14. 把动作、对白、画外音、声音事实和画面文字写入同一份剧本。
15. 用户要求整集就写完整集，场景批次自动续跑。
16. 交稿前静默反查：只看剧本能否接收到本集承诺、人物行动是否有因果、题材语气是否一致；再对本集确实使用的选择、证据、有限单位或精确死线做专项检查。若自检让剧本长出输入没有要求的机关，撤掉机关而不是替它找理由。
17. 局部修订保留无关段落；明确问题直接修正，只把真实剧情分叉交给用户。
18. 先服从输入已经给出的事实、`必须/禁止`、题材观看契约和退出状态；本技能的审查项与手艺默认只帮助实现这些要求，不能反过来补造题面没有的精确数字、记录、资源、程序、关系或机关。
19. 每场改变信息、权力、关系、情绪、物理状态或风险；无变化的场删掉或合并。核心阻力的转向要有可追溯的事实、筹码、权限、代价或人物行动，不能只靠对手停止反应。
20. 对白必须在争取、回避、试探、逼迫或重新定义关系；用可见、可听、可触的行为表现状态，不用解释替代行动，也不把已经演清的机制再说一遍。
21. 观众理解当前行动所必需的赌注要进入剧本，但载体服从题材；选择、证据、有限单位、精确死线等专项规则只在输入真正以它为发动机时启用，并按需读取[剧作手艺](references/script-craft.md)，普通决定、普通物件和模糊时间压力不升级成同一套机关。
22. 压缩过程时只保留会改变策略、关系、风险或结果的节点。资源与外部反应必须来自输入或前文建立，且不能替人物完成最难的戏剧行动。
23. 承担主要冲突的角色要保持相称的目标、判断或策略；事务性、环境性角色保持简洁，不为检查表硬加秘密、反转或人物弧。
24. 已建立的代价、不可逆后果、关键持物、空间和知识状态要进入可追溯的退出状态；结尾可推进、留白、反讽、安静收束或形成余韵，不强制追加外部事件。
25. `[连续性]` 只交接由前文动作已经建立、又容易在下游丢失的状态；不能用作者标签证明镜头外从未发生某事，也不复述正文已清楚呈现的结果。
26. 交稿前静默做一次经济性检查：是否增加了输入没有要求的精确数字或记录链；是否用标签/对白重复动作；是否在回报后堆了多个同方向后果。没有新作用的内容删掉，knowhow 本身不删。
27. 输入给出目标时长时按真实表演、动作和停顿通读压稿，先删重复验证、解释和同义收尾；不用统一字数、镜头数或节拍数填模板。
28. 用户原文优先；“去 AI 味”是定点修订，不抹平作者个性。
29. 按需知识：默认只读本 SKILL 和直接输入；出现明确信号时，在写正文前读取对应知识；同一输入有多个不同问题可以分别读取，但不遍历无关引用。
30. 阶段边界与规则分级读 references/stage-contract.md。
31. 场景标题、对白和生产标签语法，或把创作者带来的现成剧本规范化读 references/screenplay-format.md#7-现有文本的规范化入口。
32. 项目特有的制作稿方言读 references/production-format-dialect.md。
33. 输入含核心选择、有限次数/轮次/呼吸/节拍、精确倒计时或会改变人物判断的关键物证时读 references/script-craft.md。
34. 过去关系必须通过对白进入，或关键人物容易只剩说明功能时读 references/dialogue-craft.md。
35. 声源、留白与 sound bridge 读 references/scene-sound-dramaturgy.md。
36. 同一故事义务的不同可拍实现读 references/substitutable-realization.md。
37. 长单集跨上下文时的最小交接读 references/scene-handoff-capsule.md，且只留在上下文。
38. 时长估算只在用户问时长时做：把索引写入系统临时目录；先用 Python 查询跨平台临时目录，把第一条命令打印的完整路径原样替换进后两条命令的引号内；以下每条都是一行完整命令，不依赖 shell 变量或续行符；Windows 没有 `python3` 命令时使用 `py -3`。
39. `--speaker` 的示例值必须替换为本集实际说话者；`--project short-drama.json` 只加在第三条命令上（`duration_estimate.py` 才接受它，`screenplay_index.py` 没有这个参数，加上去会直接报 `unrecognized arguments`），且只在项目配置确实存在时加。
40. 第一条命令：`python3 -c "from pathlib import Path; import tempfile, uuid; print(Path(tempfile.gettempdir()) / ('short-drama-' + uuid.uuid4().hex + '.jsonl'))"`。
41. 第二条命令：`python3 "{技能目录}/scripts/screenplay_index.py" "剧集/EP001/剧本.md" --output "粘贴第一条命令输出的完整路径" --speaker "本集角色一" --speaker "本集角色二"`。
42. 第三条命令：`python3 "{技能目录}/scripts/duration_estimate.py" "剧集/EP001/剧本.md" --index "粘贴第一条命令输出的完整路径"`。
43. 改稿后重跑：第二条命令写过一次的输出路径不能直接再写一次，会以 `already holds an index` 失败；要保留原有块 ID 就加 `--previous-index <同一路径>`，要从头重编号就加 `--no-previous`；或者干脆回到第一条命令另取一个临时路径。
44. 估时前区分计数口径：`dialogue_characters` 包含标点，视频提示词中的参考语速按可发声字数计算。
45. 按语速换算时排除标点，并按实际读法处理数字和缩写；不把两个计数混用。
46. 估算是参考，不是门禁；没有语速或动作段速率时只报告可数事实，不猜秒数。但任务已给目标时长时，写作者仍须用真实朗读和动作通读判断能否容纳，并直接压缩重复节拍；“不能精确估秒”不是忽略目标的理由。
47. 完成标准：点名范围已写入、场景因果连贯、对白与行动可表演、承诺有兑现或有意延迟、结尾完成本集预定的戏剧或情绪功能，即完成；最后一拍可以推进，也可以安静收束、形成余韵或让既有动作变义，判断它是否有效不用“是否又发生一件事”代替。
48. 资产、分镜、审查与生产只有用户点名时才开始。
49. 五份创作文档齐备后，可转 `$short-drama` 对跨文档结构做一次机械核对；内容质量仍由创作者审查。
50. 只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

适用边界 · 注意事项

• 不负责资产、分镜、媒体提示词或终审，这些只有用户点名时才开始或交给下游。
• 用户未问时长时不做时长估算，也不写入临时索引。
• 输入材料足够且没有明确信号时，不遍历无关引用，也不强行补造题面没有的机关或精确数字。