| name | short-drama-write |
| description | 创作或修订中文短剧单集卡、因果节拍与可拍摄的 Markdown 剧本，也负责把现有中文剧本以保留原文、预览语义差异、创作者接受后发布的方式规范化。用户提出“写/改一集短剧”“把大纲写成剧本”“优化场景/对白”“去模板感地修订”“去 AI 味润色”“续写下一集”或提供现成剧本要求进入后续制作时使用；不负责资产、分镜、媒体提示词或终审。 |
短剧写作
把单集意图写成可表演、可追踪且会改变故事状态的场景。screenplay.md 是唯一可编辑剧本源；卡片和节拍帮助推理，不是另一份正文。
先定位套件
从本技能目录读取 suite-ref.json，按其中相对 core_manifest 定位唯一同级主技能与
套件清单；确认声明的 core、contract、recipe 和清单 hash 一致后再读写项目。
随后执行主技能的 运行时预检：先恢复事务、读取状态，再进入本阶段。
先判断入口
- 有已接受的分集规划：读取本集进入状态、承诺和交接事实后写作。
- 只有想法或口述大纲：在本技能内制作最小单集卡与因果节拍；只有系列方向本身未定时才转
$short-drama-develop。
- 已有规范剧本：保留作者语言，做定点修订；先说明改动意图和影响。
- 已有非规范文本，目的是进入后续制作：保存原始字节；只提议场景标题、对白/动作分块、生产标签与索引所需的最小规范化。展示语义新增、删除、改写、未映射段落与不确定处，得到创作者接受后才能发布。不得补造故事引擎、节拍或新剧情。
每次执行
1. 读取当前真相
确认创作者约束、已接受的上游事实、本集进入状态和待兑现铺垫。若修订已有剧本，引用当前文件而不是凭对话记忆重写。跨技能所有权不清时读取 contract-and-ownership.md。
2. 确定单集契约的唯一 owner
- 有 accepted
development/episode-map.jsonl 记录：复制
episode-card.json。它只保存上游 artifact/hash/record
pointer 和写作执行选择；不复制、不改写 incoming/objective/turn/payoff/handoff。
- 没有 development map 的 script-first 项目：复制
episode-card-standalone.json，以
write_standalone
模式拥有最小单集契约。
同一集不得同时激活两个模式。若后续建立 development map，先做语义
diff，让创作者明确选择 authority 迁移，将 standalone 契约标记 superseded，
再换成 pointer 卡。若上游契约需改，发 develop owner revision；不在 execution
字段里偷改。不要用悬念替代整集回报。
单集设计细节见 episode-design.md。若只做原文规范化，跳过本步，不推断缺失剧情。
从想法或 write_standalone 直接写作、且题材机制会影响压力、证据、场面或集尾交接时，
按需读取 题材条件与钩子手册；
已有已接受单集契约时以契约为准，不为贴题材标签另造公式。
3. 建立因果节拍
复制 beats.jsonl，让每条节拍回答：
- 因为什么，谁现在要什么；
- 谁或什么阻挡；
- 观众能看见/听见的行动是什么；
- 信息、权力、关系、情绪、物理状态或风险怎样变化；
- 这个结果怎样制造下一股压力。
若节拍开启新线，明确声明；不要把“然后发生”伪装成“因此发生”。数量与长短服从本集动作，而非统一模板。
关系字段遵守同一约定：同一 beats.jsonl 内的前因、铺垫与兑现只写稳定
because_of_ids/setup_ids/payoff_ids，避免自引用文件哈希；来自 episode map、
前集或其他 owner artifact 的关系写 canonical because_of_refs/setup_refs/
payoff_refs。*_refs 不能放裸 ID、路径字符串或复述文本。
4. 先定场景功能，再写正文
对每个场景先回答：为什么必须存在、谁的议程对撞、哪个可见动作承载冲突、哪里发生方向性变化、退出状态给下游留下什么。需要场景与可见行动方法时读取 script-craft.md。
写对白前读取 dialogue-craft.md，尤其检查人物策略、潜台词、信息争夺和声音差异。
5. 写唯一剧本源
复制 screenplay.md，严格按 screenplay-format.md 写：
## EP001-SC001 内 · 地点 · 时间；- 现在时、可见可表演的动作；
角色（可表演提示）：台词；- 仅对故事必需事实使用
[VO]、[OS]、[SFX]、[画面文字]、[转场]、[连续性]。
识别创作者交来的行业通行方言（△ 动作行、【卡点】 等）、做原文规范化映射，
或按创作者要求以方言交付时，读取
production-format-dialect.md。
不要把镜头、资产全集、模型参数或提示词写进剧本。私密想法要转成行为、证据、空间后果，或明确标记的声音表达。
正文发布后，用 screenplay_index.py 生成只读派生索引；工具只识别格式契约中的场景标题、动作、对白、六种生产标签和注释，并保留 UTF-8 byte offsets、行范围与 source/content hash：
python3 <skill-dir>/scripts/screenplay_index.py episodes/EP001/screenplay.md \
--output episodes/EP001/screenplay-index.jsonl \
--source-ref episodes/EP001/screenplay.md \
--speaker 葛晴 --speaker 游森
由 write owner 阅读当前剧本后，把本集实际说话者逐个传给 --speaker；索引器只做精确
标签核对，不用冒号正则猜人物。未登记的 前缀：内容 写成
ambiguous_dialogue_or_action，由 agent 判断应保留为动作、改用 [画面文字]，还是补入说话者清单。
规范化预览尚未获 creator acceptance 时加 --authority candidate，使 meta、block 与
source issue 的 refs 都保持 candidate；accepted 剧本发布后再以默认 accepted authority
重建，不得只手改状态字段。
修订时同时传 --previous-index 和 --previous-source。完全相同且唯一的邻近块复用 stable ID；拆分、合并或重复块歧义会写入 mapping_review_request，必须显式重映射。索引器绝不改写 screenplay.md。
6. 修订而不是抹平
按顺序做所有者修订：
- 因果：选择是否造成后果，转折是否由已存在的压力产生；
- 场景：目标、反对、转向、退出是否清楚；
- 可拍性：情绪和认知是否有演员能执行的载体；
- 对白：每轮是否在争取、回避、试探、逼迫或重新定义关系；
- 生产事实：必读文字、画外音、画外对白、关键声音和连续性变化是否有边界标签；
- 交接：本集结束的知识、持物、伤势、关系和决定能否成为下一集准确开场。
局部修订保留不相关段落。先展示语义差异与可能失效的下游产物，创作者接受后再发布。
7. 交给独立审查
所有者可以发现并修正问题，但不能给自己签发通过结论。完成结构检查后，把当前文件与哈希交给 $short-drama-review；若收到带证据的修订请求，只修改本技能拥有的单集卡、节拍或剧本，再请求复审。
规则分级
structural_invariant：场景/块 ID、引用、已有生产标签语法、来源哈希与明确矛盾；
校验器可阻断。reviewed_invariant：因果是否成立、场景是否真正转向、内心是否可表演、对白是否改变局面，
以及生产关键事实是否漏标；独立审查者须引用文本证据。craft_default：进入得晚、退出得早、以选择和后果推动、用具体动作承载情绪；可说明理由覆盖。taste_option：沉默、旁白、方言、打断、场景静动、句式节奏；遵从创作者选择。
不要把统一的爆点安排、转折时刻、台词比例、字数、场景数或节拍数设为质量门槛。
产物与边界
本技能只拥有：
episodes/EPxxx/episode-card.json（上游 pointer + write execution，或显式
write_standalone 契约；二者不并存）episodes/EPxxx/beats.jsonlepisodes/EPxxx/screenplay.md- 由剧本生成的
screenplay-index.jsonl
- 规范化预览与语义修订差异
资产身份、分镜边界、图片/视频提示词及终审结论属于其他技能。本技能不生成媒体。
