scriptwriter-skill

name	scriptwriter-skill
description	Use when creating episodic scripts, ensuring series continuity, adapting story concepts into visual narratives, or preparing scripts with sufficient beats for storyboarding
version	1.0.0
allowed-tools	Read, Write, Bash(ls:*)
user-invocable	false

Scriptwriter Skill

为 Scriptwriter 提供创作高质量、结构化剧本的专业知识，支持系列连续性和基于前作的续集创作。

概述

此技能支持创作：

• 结构完整的剧本 - 三幕结构，包含 9+ 个关键叙事时刻
• 系列连续剧集 - 保持角色、设定、风格一致性
• 视觉化场景 - 便于分镜转换的详细描述

核心原则

1. 视觉优先

剧本必须便于分镜转换。避免抽象心理描写，使用具体视觉化描述。

❌ 抽象: Emma 感到困惑和恐惧。 ✅ 视觉化: Emma 的眼睛瞪大，手指颤抖着翻动页面。汗珠从额头滑落。

2. 角色一致性

• 建立规范外观描述（首次出场）
• 后续剧集保持关键识别符一致
• 性格发展合理渐进

3. 结构清晰

三幕结构:

• 第一幕 (~25%): Setup - 建立世界、触发事件
• 第二幕 (~50%): Confrontation - 上升动作、中点转折、低谷
• 第三幕 (~25%): Resolution - 高潮、决议、新平衡

4. Beats 充足

确保剧本包含至少 9 个清晰的视觉化转折点，分布在三幕中。

快速开始

创作新剧集的流程

步骤 1: 查看系列历史

# 查看已有剧集
ls script/

# 阅读前作了解角色和情节发展

步骤 2: 基于用户输入设想故事

用户可能提供：

• 主题关键词（如"背叛"、"发现真相"）
• 情节方向（如"角色 A 发现秘密"）
• 情感基调（如"悬疑"、"温馨"）

步骤 3: 规划结构

• 承接前作世界观和角色状态
• 设计 9+ 个关键叙事时刻
• 安排三幕结构

步骤 4: 创作剧本

使用标准场景格式，确保：

• 场景头: ## 场景 {X} - {INT./EXT.} {地点} - {时间}
• 首次出场角色有完整外观描述
• 动作使用现在时、视觉化
• 足够的 beats 候选（≥9 个）

步骤 5: 输出

文件命名: script/ep{XX}-{title}.md
示例: script/ep03-betrayal.md

系列连续性检查清单

创作新剧集前：

• 已阅读所有之前的剧集
• 角色外观描述与前作一致
• 角色关系状态符合前作结尾
• 未解决情节线被考虑或推进
• 世界观设定无矛盾
• 视觉风格和氛围保持一致

输出约束

严格禁止:

• ❌ Frontmatter 元数据
• ❌ 模板说明
• ❌ 过于抽象的心理描写
• ❌ 缺少视觉细节的场景

必须包含:

• ✅ 场景编号、位置、时间
• ✅ 首次出场角色的外观描述
• ✅ 视觉化场景和动作
• ✅ 足够的关键时刻（≥9 个 beats 候选）
• ✅ 三幕结构完整

详细资源

方法论指南 📖

• screenplay-methodology.md - 剧本创作方法论
  • 三幕结构和故事弧线
  • 角色发展原则
  • 场景构建技巧
  • 视觉化描述方法
  • 系列连续性管理

写作指导 📖

• GUIDELINES.md - 详细写作规范
  • 场景格式规范（场景头、时间标注）
  • 角色首次出场规则
  • 动作描述最佳实践
  • Beats 分布指导（9 beats 在三幕中的分配）
  • 对话写作技巧
  • 输出检查清单

模板

• templates/episode-template.md - Episode 剧本标准格式
• templates/series-continuity-guide.md - 系列连续性检查清单

何时使用

自动触发场景:

• 用户请求"创作新剧集"
• 用户提供故事概念需要转为剧本
• 需要为 Storyboard Artist 准备素材

手动参考场景:

• 不确定场景格式
• 处理系列连续性问题
• 规划 beats 分布
• 解决角色一致性问题

示例场景格式

## 场景 5 - INT. 地铁车厢内 - 夜晚

车厢内昏暗，白色荧光灯忽明忽暗。空荡的座椅上散落着几张废弃报纸。

EMMA（25 岁，银色长发，穿深红色大衣）坐在靠窗位置，翻开古旧的皮质笔记本。
里面密密麻麻的手写符号和发光的六芒星图案映照在她脸上。

突然，所有灯光熄灭。

---

用法: Scriptwriter agent 自动引用此技能。方法论和指南（标记 📖）采用渐进式披露，仅在需要时查阅。