mcpField
S
screenwriter

screenwriter

github.com/rfxlamia创意与媒体10376 次安装31 周前更新
代码仓库

关于 screenwriter

将故事构想转为短片剧本的编剧技能，面向 AI 视频制作流程。它结合标准剧本格式、丰富的视觉描写和便于解析的 XML 场景元数据。

主要功能

  1. 01逐场拆分故事
  2. 02标准剧本格式
  3. 03丰富的视觉动作描写
  4. 04保持角色与地点连贯
  5. 05XML 标记的场景元数据
  6. 06短片节奏指导

适用场景

  1. 01将初步构想写成短片剧本
  2. 02为图像生成准备场景
  3. 03为视频流程整理剧本
  4. 04规划场景时长与发展

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rfxlamia/skillkit --skill screenwriter

安装后在 Claude Code 中输入/screenwriter确认已加载。

附带文件references/advanced-techniques.mdreferences/pipeline-integration.md

详细介绍

编剧技能

概述

此技能可将创意构想转化为专业剧本文档，适用于 AI 视频制作流水线。它通过生成结构化、视觉丰富的叙事，采用行业标准的剧本格式，弥合原始故事创意与可投入制作的剧本之间的差距。

流水线位置： diverse-content-gen → 编剧 → imagine → arch-v

核心能力：

  • 将原始创意转化为按场景组织的结构化叙事
  • 生成适用于图像生成的丰富视觉描述
  • 采用专业剧本格式（场景标题、动作描述、对白）
  • 输出带 XML 标签的 Markdown，便于解析
  • 为 5-10 分钟的短片优化节奏（通常为 8-15 个场景）

核心工作流程

1. 分析输入构想
  • 从原始创意中提取关键故事节拍
  • 确定角色、地点和情感弧线
  • 确定故事结构（开端、中段、结尾）
2. 生成场景拆解
  • 将故事节拍转化为独立场景
  • 确定场景数量（5-10 分钟的影片以 8-15 个场景为目标）
  • 明确场景目的和情感推进
3. 撰写专业剧本
  • 采用行业标准格式
  • 撰写视觉丰富的动作描述
  • 在叙事必不可少时加入对白
  • 保持角色描述一致
4. 输出带 XML 标签的 Markdown
  • 使用带元数据的 XML 标签包裹每个场景
  • 包含场景编号、地点和关键视觉元素
  • 设置格式，便于流水线解析

剧本格式标准

场景结构（主场景标题）

场景标题格式：

INT/EXT. LOCATION - TIME

组成部分：

  • INT/EXT： 室内或室外
  • LOCATION： 具体地点（描述清晰但简洁）
  • TIME： DAY、NIGHT、DAWN、DUSK、CONTINUOUS

示例：

EXT. WASTELAND - DAWN
INT. ABANDONED SUBWAY STATION - NIGHT
EXT. ROOFTOP GARDEN - GOLDEN HOUR

指南：

  • 场景标题始终使用全大写
  • 使用连字符分隔各项
  • 地点要具体（有助于生成视觉内容）
  • 时间应体现光线和氛围
动作描述（视觉描述）

目的： 描述观众在屏幕上看到的内容。这对图像生成至关重要。

视觉丰富的写作原则：

  1. 展示，而非讲述： 描写可见内容，而非内心想法
  2. 感官细节： 包含光线、氛围、质感和色彩
  3. 现在时： 始终使用现在时写作
  4. 主动语态： 使用有力、主动的动词
  5. 具体道具： 点明具有视觉意义的物品
  6. 氛围： 通过环境细节营造情绪

示例——较弱：

A robot walks through the city. It's sad.

示例——较强：

A BOXY ROBOT (Unit-7, weathered chrome with a single blue optical sensor) rolls through fog-shrouded streets. Neon signs flicker overhead, casting pink and cyan reflections on wet pavement. The robot's movements are slow, deliberate—almost hesitant.

视觉增强检查清单：

  • 描述光线（自然光/人造光、质感、颜色）
  • 营造氛围/情绪（雾、雨、灰尘、清晰度）
  • 详细描述角色外观（仅首次出场时）
  • 明确道具/物品（重要的视觉元素）
  • 提示构图（不使用技术性镜头指示）
  • 适时提及颜色/质感
角色介绍

首次出场——详细描述：

SARAH (28, sharp eyes, wearing a weathered leather jacket over faded jeans) enters the frame. Her dark hair is pulled back, revealing a small scar above her left eyebrow.

后续出场——简要描述：

Sarah checks her watch.

指南：

  • 角色首次出场时，名字使用全大写
  • 包含：年龄（如相关）、关键外形特征、服装
  • 注重视觉识别特征，确保图像生成的一致性
  • 避免过多细节——只需足以保持视觉一致性
对白（谨慎使用）

格式：

CHARACTER NAME
(parenthetical - optional)
Dialogue goes here.

短片对白指南：

  • 仅在故事必不可少时使用对白
  • 优先通过视觉叙事，而非对话
  • 台词保持简洁（每段最多 3-4 行）
  • 仅在语气/动作至关重要时使用括号说明
  • 角色名字居中，使用全大写

示例：

UNIT-7 (robotic voice, soft)
Organic life form detected.
Probability of survival: low.
转场（尽量少用）

常见转场：

  • FADE IN: - 仅用于剧本开场
  • CUT TO: - 场景切换（通常可省略，需要强调时再使用）
  • SMASH CUT TO: - 突兀、强烈的转场
  • DISSOLVE TO: - 表现时间流逝
  • FADE OUT. - 剧本结尾

现代最佳实践： 大多数转场都可以隐含表达。应谨慎使用，仅在需要特定叙事效果时使用。

XML 输出格式

场景标签结构

每个场景都用带有供流水线处理的元数据的 XML 包裹：

<scene number="1" duration="30-45s">
  <slugline>EXT. WASTELAND - DAWN</slugline>
  <location>Wasteland</location>
  <time>Dawn</time>
  <characters>Unit-7</characters>
  <mood>desolate, lonely</mood>
  <key_visuals>
    <visual>post-apocalyptic wasteland with ruined skyscrapers</visual>
    <visual>boxy robot with single blue optical sensor</visual>
    <visual>dust and smog atmosphere, weak pale sun</visual>
  </key_visuals>
  <action>
Gray dust covers everything. Skeletal remains of skyscrapers pierce the horizon. The sun, pale and weak, struggles through thick smog.

A ROBOT (Unit-7, boxy frame with single blue optical sensor) rolls across cracked asphalt. Its treads leave marks in the dust—the only sign of life.

The robot stops at a pile of rubble, extending a mechanical arm to sort through debris. Methodical. Purposeful. Lonely.
  </action>
</scene>
元数据字段
  • number：场景顺序编号（1、2、3……）
  • duration：预计屏幕时长（总时长为 5-10 分钟）
  • slugline：主场景标题
  • location：提取出的地点名称
  • time：一天中的时间
  • characters：以逗号分隔的角色列表
  • mood：情绪基调／氛围
  • key_visuals：用于图像生成的具体视觉元素数组
  • action：完整的动作／描述文本
  • dialogue（可选）：角色对白（如有）

短片结构（5-10 分钟）

场景数量指南
  • 5 分钟： 6-10 个场景
  • 7 分钟： 10-12 个场景
  • 10 分钟： 12-15 个场景

平均时长： 每个场景约 30-60 秒

三幕结构（精简版）

第一幕 - 铺垫（20-25%）： 2-3 个场景

  • 展现世界、角色和情境
  • 引发事件

第二幕 - 冲突（50-60%）： 4-8 个场景

  • 情节发展、障碍、紧张感递增
  • 中点反转或升级

第三幕 - 收束（20-25%）： 2-3 个场景

  • 高潮与收尾
  • 情感回报
节奏提示
  • 强势开场： 在前 10-15 秒吸引观众
  • 视觉变化： 交替运用远景／近景、动作／静止
  • 情感节拍： 每个场景都应改变情绪状态
  • 逐步增强张力： 逐场提高利害程度
  • 令人满意的结尾： 明确收尾，即使结局带有苦涩

最佳实践

流水线集成
  • 命名一致： 始终使用相同的角色名称
  • 丰富的视觉元素： 每个场景都需要 3-5 个用于图像生成的 key_visuals
  • 可解析格式： 保持严格的 XML 结构
  • 时长估算： 帮助流水线规划视频总时长
输出质量
  • 视觉叙事： 通过动作而非对白展现情绪
  • 具体细节： “风化的铬金属”胜过“旧金属”
  • 氛围描写： 通过环境营造氛围
  • 精炼文字： 每个词都应服务于画面
应避免的常见问题
  • ❌ 描述模糊： “一个人走路” → ✅ “一位 50 多岁、饱经风霜的女人在雪地里艰难跋涉”
  • ❌ 直接说明情绪： “她感到悲伤” → ✅ “泪水划过她布满尘土的脸颊”
  • ❌ 镜头指示： “特写” → ✅ “玻璃上的裂纹不断蔓延”
  • ❌ 对白过多： 短片需要视觉叙事
  • ❌ 角色名称不一致： 每个角色只使用一个名称

更多资源

流水线集成指南

有关元数据标准、视觉优化以及与 imagine/arch-v 集成的详细指南：

高级技巧

有关复杂的编剧技巧、镜头运动提示和节奏优化的详细信息：

评论

支持 Markdown