script-writing

剧本写作 Skill

用于 text 节点的 fields.content。这一份承接剧本正文；图片 prompt、分镜构图和视频 prompt 由对应模块 skill 承接。

内容范围

剧本正文聚焦故事情节、人物动作、对白前后情境、人物关系、情绪变化和因果推进。15 秒短片也写成完整故事，有清楚的开端、变化和落点。

用户只给主题时，可以根据风格和时长补出一个简单可执行概念，并把假设写进正文。已有剧本节点时，沿着原节点内容局部补全或改写。

写法原则

先写清“谁在什么地方、为什么行动、遇到什么变化、最后落到什么画面或情绪”。正文以可拍摄的动作和反应推进故事，少写抽象评价，多写能被人物图、场景图、分镜和视频 prompt 继续使用的具体信息。

每段剧情包含：

• 入口状态：人物、地点、关系、当前目标。
• 触发事件：让人物开始行动或情绪变化的原因。
• 动作推进：人物具体做什么，环境或对手如何回应。
• 情绪转折：人物从一种状态变到另一种状态。
• 落点画面：最后停在一个清楚的动作、表情、关系变化或悬念。

短片剧本保持紧凑。15 秒通常写 3-5 个连续节拍：建立人物和场景、触发动作、动作升级、结果或反转、结尾停留。30-60 秒可以写成 5-8 个节拍。多段或多集项目按段落写清每段的目标、冲突、结尾衔接。

对白服务动作和情绪。对白前后写明说话时的动作、表情或关系变化，让后续分镜知道这句台词发生在什么画面里。

风格写进叙事质感和动作选择，例如悬疑、热血、轻喜、国漫、写实、广告感；风格不替代剧情因果。

字段格式

写入 fields.content：

# 故事剧本：《标题》

## 故事正文
（连续自然段，写入口状态、触发事件、动作推进、情绪转折和落点画面。）

## 对白
- 人物：「台词」

对白缺省时，## 对白 下写 无明确对白。

节点字段

• fields.purpose: script
• fields.stage: story
• fields.content: 完整剧本正文
• fields.references: 可指向用户提供的文本、参考图说明或上游设定，role 使用 context

用户只要求在聊天里整理或改写剧本时，直接返回正文，不创建节点。用户明确要求把长剧本保存到画布时，Agent 先创建占位节点：

{
  "type": "text",
  "fields": {
    "title": "整理后的剧本",
    "purpose": "script",
    "stage": "story",
    "generation": {
      "instruction": "把上面的素材整理成标准剧本，只输出完整剧本正文。",
      "source_message_count": 2
    }
  }
}

source_message_count 要覆盖素材消息和当前保存要求；“上一轮给素材、本轮要求保存”时通常填 2。随后调用 node.run。原始素材和生成后的长正文不放进 Agent 的工具参数；runner 从创建时捕获的用户消息读取素材，并且只在正文完整生成后写入 fields.content。成功返回已经代表原子写入完成，不再用 node.get 读取长正文做重复验证。之后需要查看或分析正文时使用 node.get；正文只在 content_page 返回一次，默认窗口最多 8000 字符，按 content_page.next_offset 继续分页，content_limit=0 只读正文元数据。

检查点

• 故事能被后续人物图、场景图、分镜和视频提示词继续使用。
• 人物、地点、关键动作和情绪转折足够具体。
• 开端、触发、变化和落点完整。
• 对白与动作、表情或关系变化有关联。
• 字段内容和节点标题一致。