编写或修订可拍摄的中文短剧、漫剧单集 Markdown 剧本，也负责保留作者原文并规范化现成剧本。用户提出“写/改一集短剧”“把大纲写成剧本”“优化场景/对白”“去模板感”“去 AI 味润色”“续写下一集”或提供剧本要求进入后续制作时使用；不负责资产、分镜、媒体提示词或终审。
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add zenstory-ai/drama-skills --skill short-drama-write -a cursor -y
编写或修订可拍摄的中文短剧、漫剧单集 Markdown 剧本，也负责保留作者原文并规范化现成剧本。用户提出“写/改一集短剧”“把大纲写成剧本”“优化场景/对白”“去模板感”“去 AI 味润色”“续写下一集”或提供剧本要求进入后续制作时使用；不负责资产、分镜、媒体提示词或终审。
把单集意图写成可表演、可拍摄、会改变故事状态的 剧集/<EP>/剧本.md。
只维护一份剧本 Markdown，不另建 episode card、beats、block index、录音表、QA 或接受记录。
一级标题使用 # EP001 集名，场景标题使用 ## EP001-SC001 内 · 地点 · 时间/天气。
对白写 角色（可选表演提示）：台词；生产标签使用 [VO]、[OS]、[SFX]、[画面文字]、
[连续性]、[转场]。不要把含冒号的动作叙述误写成对白。
开发大纲和长篇分析都是可选上游；当前材料足够时直接写。
必须/禁止、题材观看契约和退出状态；本技能的审查项与手艺默认只帮助实现这些要求，不能反过来补造题面没有的精确数字、记录、资源、程序、关系或机关。end_on_peak 为 true 时，停在峰值上，不接余韵（见项目节奏档案）。[连续性] 只交接由前文动作已经建立、又容易在下游丢失的状态；不能用作者标签证明镜头外从未发生某事，也不复述正文已清楚呈现的结果。默认只读本 SKILL 和直接输入。出现下列明确信号时，在写正文前读取对应知识；同一输入有多个不同问题 可以分别读取，但不遍历无关引用：
[VO] 或内心独白交代信息，或有痛点要交代：能演的不说short-drama.json 里有 status 为 accepted 的 creator_authority.rhythm_profile：项目节奏档案用户问时长，或项目已接受节奏档案、需要核对 VO 占比时，才把索引写入系统临时目录。先用 Python 查询跨平台临时目录，把第一条命令打印的完整
路径原样替换进后两条命令的引号内。以下每条都是一行完整命令，不依赖 shell 变量或续行符；Windows
没有 python3 命令时使用 py -3。--speaker 的示例值必须替换为本集实际说话者。
项目配置存在时，可在第三条命令末尾加 --project short-drama.json。只有
duration_estimate.py 接受这个参数，第二条索引命令不接受：
python3 -c "from pathlib import Path; import tempfile, uuid; print(Path(tempfile.gettempdir()) / ('short-drama-' + uuid.uuid4().hex + '.jsonl'))"
python3 "{技能目录}/scripts/screenplay_index.py" "剧集/EP001/剧本.md" --output "粘贴第一条命令输出的完整路径" --speaker "本集角色一" --speaker "本集角色二"
python3 "{技能目录}/scripts/duration_estimate.py" "剧集/EP001/剧本.md" --index "粘贴第一条命令输出的完整路径"
改稿后重跑：第二条命令写过一次的输出路径不能直接再写一次，会以 already holds an index 失败。
要保留原有块 ID，改稿前先保存旧剧本快照，重跑第二条命令时同时加
--previous-index <同一路径> 和 --previous-source <旧剧本快照路径>。没有旧快照或要从头重编号时，
加 --no-previous，也可以回到第一条命令另取一个临时路径。
估时前区分计数口径：dialogue_characters 包含标点，视频提示词中的参考语速按可发声字数计算。
按语速换算时排除标点，并按实际读法处理数字和缩写；不把两个计数混用。
项目已接受节奏档案、上限有效且本集有台词时，输出增加 vo_share：[VO] 字数占全部台词字数的比例、档案上限，以及是否超过。[OS] 计入全部台词，不计入 [VO]。
估算是参考，不是门禁；没有语速或动作段速率时只报告可数事实，不猜秒数。但任务已给目标时长时， 写作者仍须用真实朗读和动作通读判断能否容纳，并直接压缩重复节拍。
用户点名的范围已写入，场景因果连贯，对白与行动可表演，承诺得到兑现或有意延迟，结尾完成本集预定的戏剧或情绪功能，即完成。最后一拍按本集结尾功能判断，不以新增事件作为完成条件。
资产、分镜、审查与生产只有用户点名时开始。
五份创作文档齐备后，可转 $short-drama 对跨文档结构做一次机械核对；内容质量仍由创作者审查。
只有安装、升级或排障时运行 python3 scripts/selftest.py。