@aswless_854771076/ai_short_studio_cli 0.1.32 → 0.1.34

package/skills/short-drama/README.md

@@ -0,0 +1,508 @@
+# 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 编程助手后输入 `/start`，如果出现选题引导界面，说明安装成功。
+
+---
+
+## 快速上手
+
+一个典型的短剧创作流程：
+
+```
+/start          → 选择题材、受众、调性、集数
+/plan      → 生成完整故事骨架
+/characters      → 设计角色档案和关系图
+/outline          → 生成分集目录（含钩子和标记）
+/episode 1        → 撰写第1集剧本
+/review 1        → 对第1集进行质量审查
+/episode 2-5      → 批量撰写第2-5集
+/review all      → 全集质量审查
+/compliance          → 合规审核
+/export          → 导出完整剧本
+```
+
+### 海外模式
+
+如果目标市场在海外：
+
+```
+/overseas          → 切换为英文 + 好莱坞格式
+/episode 1        → 按 INT./EXT. 格式撰写
+```
+
+---
+
+## 命令手册
+
+### `/start` — 选题立项
+
+启动新项目的创作流程，配置基础参数。
+
+**交互内容：**
+
+| 配置项 | 可选值 | 说明 |
+|--------|--------|------|
+| 题材 | 13种（可组合最多2个） | 霸道总裁、甜宠、复仇、穿越、重生、悬疑、宫斗、都市、玄幻、末日、校园、职场、古装言情 |
+| 受众 | 女频 / 男频 / 全龄 | 目标观众定位 |
+| 调性 | 甜 / 虐 / 甜虐 / 爽 / 燃 / 搞笑 | 整体风格基调 |
+| 结局 | HE(好结局) / BE(坏结局) / OE(开放结局) | 故事走向 |
+| 集数 | 40 / 60 / 80 / 100 / 自定义 | 总集数 |
+| 语言 | zh-CN / en-US | 创作语言 |
+| 模式 | domestic / overseas | 国内格式或海外格式 |
+
+**状态追踪：** 配置完成后生成 `.drama-state.json` 文件，后续命令自动读取。
+
+---
+
+### `/plan` — 创作方案
+
+生成完整的故事骨架，包含8个核心板块。
+
+**前置条件：** 已执行 `/start`
+
+**输出文件：** `creative-plan.md`
+
+**包含板块：**
+
+1. **人物名单** — 主角、反派、配角的姓名和身份
+2. **故事背景** — 时代、地点、社会环境
+3. **故事线** — 主线 + A/B副线，一句话概括
+4. **三幕结构** — 入局/纠缠/决战与团圆，各幕的核心事件
+5. **节奏曲线** — 起势段/攀升段/风暴段/决战段的集数配比
+6. **付费卡点** — 付费墙位置规划（占比10-15%）
+7. **爽感矩阵** — 8类爽感要素的配比（打脸/逆袭/甜宠/虐心/悬疑/燃/搞笑/感动）
+8. **结局设计** — 结局类型和关键场景
+
+---
+
+### `/characters` — 角色设计
+
+创建完整的角色档案体系。
+
+**前置条件：** 已执行 `/plan`
+
+**输出文件：** `characters.md`
+
+**包含内容：**
+
+- **角色档案** — 年龄、身份、性格关键词、核心驱动、人物弧光、标志特征、口头禅、背景故事
+- **角色关系图** — Mermaid 格式的关系网络图
+- **弧光设计** — 角色成长轨迹
+- **感情线** — 男女主的情感发展节点
+- **重点场景** — 角色高光时刻
+- **四层反派体系** — 每层反派的身份、动机、行为模式、击败/揭露过程
+
+**四层反派体系说明：**
+
+| 层级 | 定位 | 活跃时段 | 示例 |
+|------|------|----------|------|
+| 第一层 | 小反派·日常对抗 | 前1/4 | 刁难女主的表妹/同事 |
+| 第二层 | 中反派·阶段威胁 | 前2/3 | 商业对手、情敌 |
+| 第三层 | 大反派·核心对抗 | 中后期 | 幕后黑手、家族敌人 |
+| 第四层 | 隐藏反派·终极反转 | 后1/3揭露 | 身边最信任的人 |
+
+---
+
+### `/outline` — 分集目录
+
+生成完整的分集目录表。
+
+**前置条件：** 已执行 `/characters`
+
+**输出文件：** `episode-directory.md`
+
+**包含内容：**
+
+- 按幕/段落分组的集数列表
+- 每集：集数、标题、一句话梗概、钩子类型、标记
+- 标记说明：🔥 重点集（25-35%）、💰 付费卡点（10-15%）
+- 统计信息：钩子类型分布、节奏段落分布、标记占比
+
+**覆盖要求：**
+
+| 钩子类型 | 参考占比 |
+|----------|----------|
+| 情绪钩 | 30-40%（甜宠类主钩子） |
+| 悬念钩 | 20-30% |
+| 危机钩 | 10-20% |
+| 信息钩 | 10-20% |
+| 反转钩 | 5-15% |
+
+---
+
+### `/episode {N}` — 分集撰写
+
+撰写具体集数的剧本。
+
+**前置条件：** 已执行 `/outline`
+
+**输出文件：** `episodes/ep{NNN}.md`
+
+**参数格式：**
+
+```
+/episode 1          → 撰写第1集
+/episode 3-5        → 批量撰写第3、4、5集
+/episode next       → 撰写下一集（自动检测进度）
+```
+
+**剧本格式（国内 domestic 模式）：**
+
+```
+## 场景一：地点·内/外·日/夜
+
+♪ 配乐描述
+
+△ 全景/中景/近景/特写：画面描述
+
+**角色名**：（动作/表情）台词内容
+```
+
+**镜头类型说明：**
+
+| 标记 | 含义 | 用途 |
+|------|------|------|
+| △ 全景 | 展示整体环境 | 场景开头建立空间感 |
+| △ 中景 | 展示人物上半身和部分环境 | 对话、互动 |
+| △ 近景 | 展示人物面部和上身 | 情绪表达 |
+| △ 特写 | 展示局部细节 | 关键道具、表情、动作 |
+
+**每集结构：**
+
+- 顶部元信息：所属段落、钩子类型、标记、时长参考、情绪曲线
+- 2-5个场景（视时长而定）
+- 结尾钩子（🎣 本集钩子）
+- 下集预告（📺 下集预告）
+
+---
+
+### `/review {N}` — 质量审查
+
+对已撰写的剧集进行五维度质量评分。
+
+**前置条件：** 对应集数已撰写
+
+**输出文件：** `reviews/ep{NNN}-review.md`
+
+**参数格式：**
+
+```
+/review 1          → 审查第1集
+/review 3-5        → 批量审查第3-5集
+/review all        → 审查所有已写集数
+```
+
+**评分维度：** 见下方[质量评分体系](#质量评分体系)。
+
+---
+
+### `/export` — 导出剧本
+
+将所有创作内容整合为专业排版的完整剧本。
+
+**前置条件：** 至少已撰写部分集数
+
+**输出目录：** `export/`
+
+**导出内容：**
+
+- 完整剧本（按集排列）
+- 角色表
+- 场景清单
+- 配乐提示表
+
+---
+
+### `/overseas` — 海外模式
+
+将创作切换为英文 + 好莱坞标准格式。
+
+**格式变化：**
+
+| 元素 | 国内格式 | 海外格式 |
+|------|----------|----------|
+| 场景头 | `## 场景一：客厅·内·日` | `## Scene 1: INT. LIVING ROOM - DAY` |
+| 镜头 | `△ 全景：` | `WIDE SHOT:` |
+| 配乐 | `♪ 轻快的钢琴` | `♪ Upbeat piano melody` |
+| 对话 | `**苏念**：（微笑）你好` | `**SU NIAN**: (smiling) Hello` |
+
+**文化适配：**
+
+- 角色名转为拼音/英文名
+- 场景描述适配西方观众认知
+- 剧情节奏适配海外观看习惯
+- 法律/文化敏感内容自动调整
+
+---
+
+### `/compliance` — 合规审核
+
+对全剧进行合规审查，检测潜在风险。
+
+**前置条件：** 已有创作方案或分集内容
+
+**输出文件：** `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 | 红线清单、高风险内容识别、合规修改建议 |
+
+---
+
+## 质量评分体系
+
+`/review` 命令使用五维度评分，每个维度 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 规则文件，无需安装额外包
+- **按需加载：** 参考文档按命令触发条件动态加载，不会全部注入上下文
+
+### 参考文档加载机制
+
+| 命令 | 加载的参考文档 |
+|------|----------------|
+| `/start` | genre-guide.md |
+| `/plan` | genre-guide.md, rhythm-curve.md, paywall-design.md, satisfaction-matrix.md |
+| `/characters` | villain-design.md |
+| `/outline` | rhythm-curve.md, hook-design.md, paywall-design.md |
+| `/episode {N}` | opening-rules.md（第1-3集时）, hook-design.md |
+| `/review {N}` | rhythm-curve.md, hook-design.md, satisfaction-matrix.md |
+| `/compliance` | compliance-checklist.md |
+| `/overseas` | — |
+| `/export` | — |
+
+### 兼容性
+
+- 兼容任何支持 Skills 目录结构的 AI 编程助手（Claude Code、Codex CLI、Gemini CLI 等）
+
+---
+
+## 致谢
+
+本技能的创作方法论和行业知识参考了短剧编剧领域的专业实践，包括：
+
+- 微短剧行业的钩子设计理论
+- 网络文学的节奏曲线公式
+- 影视编剧的四层反派递进体系
+- 国内广电总局内容审查相关规范
+
+感谢 [binghe](https://x.com/binghe) 在 AI 辅助编剧方向的探索和分享，为本项目提供了灵感来源。
+
+---
+
+## 许可协议
+
+本项目采用 [MIT License](LICENSE) 开源协议。
+
+你可以自由使用、修改和分发本技能包，但请保留原始许可声明。