专业的短剧剧本创作 AI 技能包，适用于各类 AI 编程助手的一站式微短剧编剧工具。
从选题立项到分集撰写、质量自检、合规审核、海外出海，覆盖短剧剧本生产全流程。
| 能力 | 说明 |
|---|---|
| 13种题材模板 | 霸道总裁、甜宠、复仇、穿越、重生、悬疑、宫斗、都市、玄幻、末日、校园、职场、古装言情 |
| 四层反派体系 | 小反派 → 中反派 → 大反派 → 隐藏反派，递进式对抗设计 |
| 五种钩子类型 | 悬念钩、反转钩、情绪钩、信息钩、危机钩，每集结尾抓住观众 |
| 节奏曲线系统 | 起势段(15%) → 攀升段(30%) → 风暴段(35%) → 决战段(20%) |
| 付费卡点设计 | 科学布局付费墙，10-15%的集数设为付费卡点 |
| 爽感矩阵 | 8类爽感要素配比，匹配不同题材的观众期待 |
| 双语支持 | 国内格式（△镜头 + ♪配乐）和海外格式（INT./EXT. + WIDE SHOT） |
| 合规审查 | 红线检测、高风险内容扫描、正能量价值观校验 |
将本仓库克隆到 AI 编程助手的技能目录：
# 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 编程助手即可使用。
如果只想在特定项目中使用：
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
包含板块：
- 人物名单 — 主角、反派、配角的姓名和身份
- 故事背景 — 时代、地点、社会环境
- 故事线 — 主线 + A/B副线，一句话概括
- 三幕结构 — 入局/纠缠/决战与团圆，各幕的核心事件
- 节奏曲线 — 起势段/攀升段/风暴段/决战段的集数配比
- 付费卡点 — 付费墙位置规划（占比10-15%）
- 爽感矩阵 — 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% |
撰写具体集数的剧本。
前置条件： 已执行 /目录
输出文件： episodes/ep{NNN}.md
参数格式：
/分集 1 → 撰写第1集
/分集 3-5 → 批量撰写第3、4、5集
/分集 next → 撰写下一集（自动检测进度）
剧本格式（国内 domestic 模式）：
## 场景一：地点·内/外·日/夜
♪ 配乐描述
△ 全景/中景/近景/特写：画面描述
**角色名**：（动作/表情）台词内容
镜头类型说明：
| 标记 | 含义 | 用途 |
|---|---|---|
| △ 全景 | 展示整体环境 | 场景开头建立空间感 |
| △ 中景 | 展示人物上半身和部分环境 | 对话、互动 |
| △ 近景 | 展示人物面部和上身 | 情绪表达 |
| △ 特写 | 展示局部细节 | 关键道具、表情、动作 |
每集结构：
- 顶部元信息：所属段落、钩子类型、标记、时长参考、情绪曲线
- 2-5个场景（视时长而定）
- 结尾钩子（🎣 本集钩子）
- 下集预告（📺 下集预告）
对已撰写的剧集进行五维度质量评分。
前置条件： 对应集数已撰写
输出文件： 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 状态文件示例：
{
"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 情绪波形图）
- 修订建议优先级排序
以下是使用本技能创作的示例片段（摘自测试项目《偏偏宠你入骨》）：
## 场景一：念念甜品屋·内·日
♪ 轻快的钢琴配乐，带一点法式小调的慵懒
△ 全景：一间不大但布置温馨的社区甜品店，暖黄色灯光，
墙上贴满顾客留言的便利贴，玻璃柜台里摆着各色精致甜品。
△ 中景：**苏念**（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 在 AI 辅助编剧方向的探索和分享，为本项目提供了灵感来源。
本项目采用 MIT License 开源协议。
你可以自由使用、修改和分发本技能包，但请保留原始许可声明。