# Short Drama Screenplay Skill

> 专业的短剧剧本创作 AI 技能包，适用于各类 AI 编程助手的一站式微短剧编剧工具。

从选题立项到分集撰写、质量自检、合规审核、海外出海，覆盖短剧剧本生产全流程。

---

## 目录

- [功能概览](#功能概览)
- [安装方式](#安装方式)
- [快速上手](#快速上手)
- [命令手册](#命令手册)
- [工作目录结构](#工作目录结构)
- [参考知识库](#参考知识库)
- [质量评分体系](#质量评分体系)
- [示例输出](#示例输出)
- [技术细节](#技术细节)
- [致谢](#致谢)
- [许可协议](#许可协议)

---

## 功能概览

| 能力 | 说明 |
|------|------|
| 13种题材模板 | 霸道总裁、甜宠、复仇、穿越、重生、悬疑、宫斗、都市、玄幻、末日、校园、职场、古装言情 |
| 四层反派体系 | 小反派 → 中反派 → 大反派 → 隐藏反派，递进式对抗设计 |
| 五种钩子类型 | 悬念钩、反转钩、情绪钩、信息钩、危机钩，每集结尾抓住观众 |
| 节奏曲线系统 | 起势段(15%) → 攀升段(30%) → 风暴段(35%) → 决战段(20%) |
| 付费卡点设计 | 科学布局付费墙，10-15%的集数设为付费卡点 |
| 爽感矩阵 | 8类爽感要素配比，匹配不同题材的观众期待 |
| 双语支持 | 国内格式（△镜头 + ♪配乐）和海外格式（INT./EXT. + WIDE SHOT） |
| 合规审查 | 红线检测、高风险内容扫描、正能量价值观校验 |

---

## 安装方式

### 全局安装（推荐）

将本仓库克隆到 AI 编程助手的技能目录：

```bash
# macOS / Linux
git clone https://github.com/0xsline/short-drama.git ~/.claude/skills/short-drama

# Windows (Git Bash)
git clone https://github.com/0xsline/short-drama.git "$USERPROFILE/.claude/skills/short-drama"
```

安装完成后，在任意目录启动你的 AI 编程助手即可使用。

### 项目级安装

如果只想在特定项目中使用：

```bash
cd your-project
git clone https://github.com/0xsline/short-drama.git .claude/skills/short-drama
```

### 验证安装

启动 AI 编程助手后输入 `/开始`，如果出现选题引导界面，说明安装成功。

---

## 快速上手

一个典型的短剧创作流程：

```
/开始          → 选择题材、受众、调性、集数
/创作方案      → 生成完整故事骨架
/角色开发      → 设计角色档案和关系图
/目录          → 生成分集目录（含钩子和标记）
/分集 1        → 撰写第1集剧本
/自检 1        → 对第1集进行质量审查
/分集 2-5      → 批量撰写第2-5集
/自检 all      → 全集质量审查
/合规          → 合规审核
/导出          → 导出完整剧本
```

### 海外模式

如果目标市场在海外：

```
/出海          → 切换为英文 + 好莱坞格式
/分集 1        → 按 INT./EXT. 格式撰写
```

---

## 命令手册

### `/开始` — 选题立项

启动新项目的创作流程，配置基础参数。

**交互内容：**

| 配置项 | 可选值 | 说明 |
|--------|--------|------|
| 题材 | 13种（可组合最多2个） | 霸道总裁、甜宠、复仇、穿越、重生、悬疑、宫斗、都市、玄幻、末日、校园、职场、古装言情 |
| 受众 | 女频 / 男频 / 全龄 | 目标观众定位 |
| 调性 | 甜 / 虐 / 甜虐 / 爽 / 燃 / 搞笑 | 整体风格基调 |
| 结局 | HE(好结局) / BE(坏结局) / OE(开放结局) | 故事走向 |
| 集数 | 40 / 60 / 80 / 100 / 自定义 | 总集数 |
| 语言 | zh-CN / en-US | 创作语言 |
| 模式 | domestic / overseas | 国内格式或海外格式 |

**状态追踪：** 配置完成后生成 `.drama-state.json` 文件，后续命令自动读取。

---

### `/创作方案` — 创作方案

生成完整的故事骨架，包含8个核心板块。

**前置条件：** 已执行 `/开始`

**输出文件：** `creative-plan.md`

**包含板块：**

1. **人物名单** — 主角、反派、配角的姓名和身份
2. **故事背景** — 时代、地点、社会环境
3. **故事线** — 主线 + A/B副线，一句话概括
4. **三幕结构** — 入局/纠缠/决战与团圆，各幕的核心事件
5. **节奏曲线** — 起势段/攀升段/风暴段/决战段的集数配比
6. **付费卡点** — 付费墙位置规划（占比10-15%）
7. **爽感矩阵** — 8类爽感要素的配比（打脸/逆袭/甜宠/虐心/悬疑/燃/搞笑/感动）
8. **结局设计** — 结局类型和关键场景

---

### `/角色开发` — 角色设计

创建完整的角色档案体系。

**前置条件：** 已执行 `/创作方案`

**输出文件：** `characters.md`

**包含内容：**

- **角色档案** — 年龄、身份、性格关键词、核心驱动、人物弧光、标志特征、口头禅、背景故事
- **角色关系图** — Mermaid 格式的关系网络图
- **弧光设计** — 角色成长轨迹
- **感情线** — 男女主的情感发展节点
- **重点场景** — 角色高光时刻
- **四层反派体系** — 每层反派的身份、动机、行为模式、击败/揭露过程

**四层反派体系说明：**

| 层级 | 定位 | 活跃时段 | 示例 |
|------|------|----------|------|
| 第一层 | 小反派·日常对抗 | 前1/4 | 刁难女主的表妹/同事 |
| 第二层 | 中反派·阶段威胁 | 前2/3 | 商业对手、情敌 |
| 第三层 | 大反派·核心对抗 | 中后期 | 幕后黑手、家族敌人 |
| 第四层 | 隐藏反派·终极反转 | 后1/3揭露 | 身边最信任的人 |

---

### `/目录` — 分集目录

生成完整的分集目录表。

**前置条件：** 已执行 `/角色开发`

**输出文件：** `episode-directory.md`

**包含内容：**

- 按幕/段落分组的集数列表
- 每集：集数、标题、一句话梗概、钩子类型、标记
- 标记说明：🔥 重点集（25-35%）、💰 付费卡点（10-15%）
- 统计信息：钩子类型分布、节奏段落分布、标记占比

**覆盖要求：**

| 钩子类型 | 参考占比 |
|----------|----------|
| 情绪钩 | 30-40%（甜宠类主钩子） |
| 悬念钩 | 20-30% |
| 危机钩 | 10-20% |
| 信息钩 | 10-20% |
| 反转钩 | 5-15% |

---

### `/分集 {N}` — 分集撰写

撰写具体集数的剧本。

**前置条件：** 已执行 `/目录`

**输出文件：** `episodes/ep{NNN}.md`

**参数格式：**

```
/分集 1          → 撰写第1集
/分集 3-5        → 批量撰写第3、4、5集
/分集 next       → 撰写下一集（自动检测进度）
```

**剧本格式（国内 domestic 模式）：**

```
## 场景一：地点·内/外·日/夜

♪ 配乐描述

△ 全景/中景/近景/特写：画面描述

**角色名**：（动作/表情）台词内容
```

**镜头类型说明：**

| 标记 | 含义 | 用途 |
|------|------|------|
| △ 全景 | 展示整体环境 | 场景开头建立空间感 |
| △ 中景 | 展示人物上半身和部分环境 | 对话、互动 |
| △ 近景 | 展示人物面部和上身 | 情绪表达 |
| △ 特写 | 展示局部细节 | 关键道具、表情、动作 |

**每集结构：**

- 顶部元信息：所属段落、钩子类型、标记、时长参考、情绪曲线
- 2-5个场景（视时长而定）
- 结尾钩子（🎣 本集钩子）
- 下集预告（📺 下集预告）

---

### `/自检 {N}` — 质量审查

对已撰写的剧集进行五维度质量评分。

**前置条件：** 对应集数已撰写

**输出文件：** `reviews/ep{NNN}-review.md`

**参数格式：**

```
/自检 1          → 审查第1集
/自检 3-5        → 批量审查第3-5集
/自检 all        → 审查所有已写集数
```

**评分维度：** 见下方[质量评分体系](#质量评分体系)。

---

### `/导出` — 导出剧本

将所有创作内容整合为专业排版的完整剧本。

**前置条件：** 至少已撰写部分集数

**输出目录：** `export/`

**导出内容：**

- 完整剧本（按集排列）
- 角色表
- 场景清单
- 配乐提示表

---

### `/出海` — 海外模式

将创作切换为英文 + 好莱坞标准格式。

**格式变化：**

| 元素 | 国内格式 | 海外格式 |
|------|----------|----------|
| 场景头 | `## 场景一：客厅·内·日` | `## Scene 1: INT. LIVING ROOM - DAY` |
| 镜头 | `△ 全景：` | `WIDE SHOT:` |
| 配乐 | `♪ 轻快的钢琴` | `♪ Upbeat piano melody` |
| 对话 | `**苏念**：（微笑）你好` | `**SU NIAN**: (smiling) Hello` |

**文化适配：**

- 角色名转为拼音/英文名
- 场景描述适配西方观众认知
- 剧情节奏适配海外观看习惯
- 法律/文化敏感内容自动调整

---

### `/合规` — 合规审核

对全剧进行合规审查，检测潜在风险。

**前置条件：** 已有创作方案或分集内容

**输出文件：** `compliance-report.md`

**检查维度：**

| 维度 | 检查内容 |
|------|----------|
| 红线检测 | 政治敏感、违法犯罪美化、色情暴力、歧视侮辱 |
| 高风险内容 | 未成年人相关、宗教民族、历史事件、医疗法律 |
| 正能量校验 | 价值观导向、社会影响、教育意义 |
| 广告植入 | 软广合规性、品牌露出方式 |

---

## 工作目录结构

执行创作流程后，工作目录下会生成以下文件：

```
your-project/
├── .drama-state.json        # 状态追踪文件（自动生成）
├── creative-plan.md          # 创作方案
├── characters.md             # 角色设计
├── episode-directory.md      # 分集目录
├── episodes/                 # 分集剧本目录
│   ├── ep001.md
│   ├── ep002.md
│   └── ...
├── reviews/                  # 审查报告目录
│   ├── ep001-review.md
│   └── ...
├── compliance-report.md      # 合规报告
└── export/                   # 导出目录
    └── ...
```

**`.drama-state.json` 状态文件示例：**

```json
{
  "currentStep": "episodes",
  "genre": ["霸道总裁", "甜宠"],
  "audience": "女频",
  "tone": "甜虐",
  "totalEpisodes": 60,
  "completedEpisodes": [1, 2],
  "language": "zh-CN",
  "mode": "domestic",
  "dramaTitle": "偏偏宠你入骨"
}
```

---

## 参考知识库

技能内置8份专业参考文档，覆盖短剧创作的核心知识：

| 文件 | 行数 | 内容 |
|------|------|------|
| `genre-guide.md` | 195 | 13种题材的核心要素、标志性桥段、节奏模板、台词风格 |
| `opening-rules.md` | 205 | 开篇黄金30秒法则、5种开场模式、前3集结构公式 |
| `rhythm-curve.md` | 263 | 四段式节奏曲线、集数配比公式、情绪波形设计 |
| `hook-design.md` | 310 | 5种钩子类型的设计方法、组合策略、使用频率参考 |
| `paywall-design.md` | 220 | 付费卡点选择策略、情绪阈值设计、不同位置的转化率分析 |
| `satisfaction-matrix.md` | 319 | 8类爽感要素定义、题材配比建议、爽感密度计算 |
| `villain-design.md` | 319 | 四层反派递进体系、伏笔设计技巧、揭露节奏控制 |
| `compliance-checklist.md` | 295 | 红线清单、高风险内容识别、合规修改建议 |

---

## 质量评分体系

`/自检` 命令使用五维度评分，每个维度 1-10 分，总分 50 分。

### 评分维度

| 维度 | 权重 | 评价标准 |
|------|------|----------|
| 节奏 | 10分 | 场景切换节奏、信息密度、前30秒入戏、末尾钩子 |
| 爽点 | 10分 | 爽感要素密度、情绪高潮设计、观众满足感 |
| 台词 | 10分 | 人物语言个性化、金句设计、画外音使用 |
| 格式 | 10分 | 镜头语言规范、配乐提示、场景头标注、角色标注 |
| 连贯性 | 10分 | 与角色档案一致、与前后集衔接、伏笔回收 |

### 评级标准

| 总分 | 评级 | 说明 |
|------|------|------|
| 45-50 | 卓越 | 可直接投入拍摄 |
| 38-44 | 优良 | 微调后可用 |
| 30-37 | 合格 | 需要修改特定问题 |
| 25-29 | 需改进 | 存在结构性问题 |
| <25 | 需重写 | 不达标，建议重新创作 |

### 审查报告内容

- 五维度评分表（含每项详细评语）
- 亮点列表（3-5个值得保留的设计）
- 问题清单（分级：⛔ 阻断 / ⚠️ 建议 / ℹ️ 微调）
- 全剧节奏适配度分析（ASCII 情绪波形图）
- 修订建议优先级排序

---

## 示例输出

以下是使用本技能创作的示例片段（摘自测试项目《偏偏宠你入骨》）：

### 分集剧本片段

```markdown
## 场景一：念念甜品屋·内·日

♪ 轻快的钢琴配乐，带一点法式小调的慵懒

△ 全景：一间不大但布置温馨的社区甜品店，暖黄色灯光，
墙上贴满顾客留言的便利贴，玻璃柜台里摆着各色精致甜品。

△ 中景：**苏念**（26岁，马尾，围裙上沾着面粉）正弯腰
把一盘刚出炉的柠檬挞摆进柜台，动作轻柔。

**苏念**：（自言自语，满意地看着柠檬挞）
今天这批酸度刚好，老陈头肯定又要买三个。
```

### 质量审查片段

```
| 维度    | 得分  | 评价 |
|---------|-------|------|
| 节奏    | 8/10  | 四场戏节奏分配合理 |
| 爽点    | 7/10  | 铺垫集定位准确 |
| 台词    | 9/10  | 台词贴合人物性格 |
| 格式    | 9/10  | 镜头语言规范完整 |
| 连贯性  | 9/10  | 与角色档案高度一致 |

总分：42/50 ⭐⭐⭐⭐ 优良
```

---

## 技术细节

### 技能架构

```
short-drama/
├── SKILL.md              # 技能入口文件（520行）
└── references/           # 参考知识库（8个文件）
    ├── compliance-checklist.md
    ├── genre-guide.md
    ├── hook-design.md
    ├── opening-rules.md
    ├── paywall-design.md
    ├── rhythm-curve.md
    ├── satisfaction-matrix.md
    └── villain-design.md
```

- **总计：** 9个文件，2646行，约93KB
- **零依赖：** 纯 Markdown 规则文件，无需安装额外包
- **按需加载：** 参考文档按命令触发条件动态加载，不会全部注入上下文

### 参考文档加载机制

| 命令 | 加载的参考文档 |
|------|----------------|
| `/开始` | genre-guide.md |
| `/创作方案` | genre-guide.md, rhythm-curve.md, paywall-design.md, satisfaction-matrix.md |
| `/角色开发` | villain-design.md |
| `/目录` | rhythm-curve.md, hook-design.md, paywall-design.md |
| `/分集 {N}` | opening-rules.md（第1-3集时）, hook-design.md |
| `/自检 {N}` | rhythm-curve.md, hook-design.md, satisfaction-matrix.md |
| `/合规` | compliance-checklist.md |
| `/出海` | — |
| `/导出` | — |

### 兼容性

- 兼容任何支持 Skills 目录结构的 AI 编程助手（Claude Code、Codex CLI、Gemini CLI 等）

---

## 致谢

本技能的创作方法论和行业知识参考了短剧编剧领域的专业实践，包括：

- 微短剧行业的钩子设计理论
- 网络文学的节奏曲线公式
- 影视编剧的四层反派递进体系
- 国内广电总局内容审查相关规范

感谢 [binghe](https://x.com/binghe) 在 AI 辅助编剧方向的探索和分享，为本项目提供了灵感来源。

---

## 许可协议

本项目采用 [MIT License](LICENSE) 开源协议。

你可以自由使用、修改和分发本技能包，但请保留原始许可声明。