| 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 候选）
- ✅ 三幕结构完整
详细资源
方法论指南 📖
写作指导 📖
- GUIDELINES.md - 详细写作规范
- 场景格式规范（场景头、时间标注）
- 角色首次出场规则
- 动作描述最佳实践
- Beats 分布指导（9 beats 在三幕中的分配）
- 对话写作技巧
- 输出检查清单
模板
何时使用
自动触发场景:
- 用户请求"创作新剧集"
- 用户提供故事概念需要转为剧本
- 需要为 Storyboard Artist 准备素材
手动参考场景:
- 不确定场景格式
- 处理系列连续性问题
- 规划 beats 分布
- 解决角色一致性问题
示例场景格式
## 场景 5 - INT. 地铁车厢内 - 夜晚
车厢内昏暗，白色荧光灯忽明忽暗。空荡的座椅上散落着几张废弃报纸。
EMMA（25 岁，银色长发，穿深红色大衣）坐在靠窗位置，翻开古旧的皮质笔记本。
里面密密麻麻的手写符号和发光的六芒星图案映照在她脸上。
突然，所有灯光熄灭。
用法: Scriptwriter agent 自动引用此技能。方法论和指南（标记 📖）采用渐进式披露，仅在需要时查阅。
