Drama Skills

Drama Skills

面向编剧、漫剧工作室和编导的 AI 短剧创作工作流：十二个技能，从一个点子或一部原著做到分集剧本、分镜、图片/视频提示词和成片。

项目主页  ·  安装  ·  看看它的输出  ·  English

https://github.com/user-attachments/assets/640db65d-bd57-4924-83de-9c5852c1db26

上面这段 68 秒竖屏样片是《让你管账号》第 1 集开头：从一部 20 章的原著改编，分镜 20 镜，逐镜生成后剪成成片， 字幕、系统面板与音效在剪辑时叠加。视频生成成本约 40 元。

更多样片：打戏、群戏、水墨漫剧

https://github.com/user-attachments/assets/f67e2e04-52e7-42a9-a4a0-e2864ff0f51e

这是什么

Drama Skills 覆盖 AI 短剧 / 漫剧从点子或原著到成片的全流程：原著分析 → 分集剧本 → 视觉设定 → 图片提示词与分镜 → 视频提示词 → 确认后生产 → 剪辑成片 → 审查。 它以 12 个 skill 的形式装进你已经在用的编程 Agent（Claude Code、Codex 及其他支持 Agent Skill 规范的环境）， 写作用的模型就是该 Agent 的模型。

• 五份 Markdown 分别记录创作决定 — 按阶段维护 剧本.md、视觉设定.md、分镜.md、图片提示词.md、 视频提示词.md，剪成片时增加 剪辑单.md；只做部分阶段就交付对应文档。创作决定以这些文档为准。
• 用可核对的文件事实约束跨镜一致性 — 需要跨镜保持的造型写成一条能原样贴进提示词的短语（连续性锁）； 每个关键帧都写明视觉依据；检查脚本核对已声明的引用与连续性锁，报错示例见下文。
• 先预览、确认，再生产 — 任何图片、视频、配音或音乐任务，都先在文件里看到这一批准确的内容和参数， 明确确认后才调用外部接口花钱。
• 成片也在套件里 — 剪辑技能逐段写下入点、出点为什么选在那里，字幕逐字取自剧本，统一响度后渲染； 核对和测量脚本只回报事实，不下判断。

由来

这套技能来自我们自己的漫剧工作室产线：2025 年至今累计上千个 AI 短剧 / 漫剧项目， 中间换过几轮自建和开源工具。前后端加起来近 8 万行代码，在模型能力和需求的迭代速度 面前逐渐维护不动了。

后来干脆抛开自建的一体化图形工具，把历史项目工程和图片 / 视频提示词蒸馏成这套技能， 让制作人直接用 agent CLI 加文件维护工程、生成提示词，确认之后再送去生成——结果意外地顺手。 现在留在自建工具里的，只剩排队抽卡。

刻意把确认放在生产之前：提示词先落进文件，生产 skill 展示本次准确数量、内容、参考、 参数、输出和 adapter；用户看到预览并明确确认后才执行。供应商凭据不进入项目， 项目文件和其他 Skill 都不绑定供应商。

安装

从 GitHub 安装

前提：你已经在用 Claude Code、Codex 或其他支持 Agent Skill 规范的编程 Agent；下面这条命令需要终端里能运行 npx（Node.js）。

npx skills add zenstory-ai/drama-skills -y -g

-g 全局安装，所有目录可用；去掉 -g 则只装到当前目录。更新时重新执行同一条命令即可。 脚本需要 Python 3.9 或更新版本，请先检查本机版本；剪辑成片另需 ffmpeg / ffprobe 在 PATH 上。

支持导入 GitHub 仓库或 skill 的平台（例如 WorkBuddy，见社区写的完整用法），也可以直接对 Agent 说：

安装这些技能 https://github.com/zenstory-ai/drama-skills

git clone https://github.com/zenstory-ai/drama-skills.git && cd drama-skills

# Claude Code
mkdir -p "$HOME/.claude/skills"
for skill in skills/*; do
  ln -s "$PWD/$skill" "$HOME/.claude/skills/$(basename "$skill")"
done

# Codex
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
for skill in skills/*; do
  ln -s "$PWD/$skill" "${CODEX_HOME:-$HOME/.codex}/skills/$(basename "$skill")"
done

ClawHub 分发条目由显式发布清单管理，可在 ClawHub 中查找。

调用写法随运行环境而变：Claude Code 用 /short-drama，Codex 用 $short-drama， 也可以直接用自然语言说明任务。下文以 $ 为例，Claude Code 用户按环境改用 /。

变更见 CHANGELOG.md 与 Releases； 升级既有项目要做什么，见常见问题「升级到新版本后要做什么」。

快速开始

按实际项目修改下面的请求即可使用：

# 0. 有原著时（可选）：先抽样快评，再决定要不要全量拆
用 $short-drama-novel-analyze 快评 输入/这本小说.txt，先告诉我值不值得拆

# 已有多集完整剧本时（可选）：按文件实际结构索引，每次只读当前集，断点续做分集地图
用 $short-drama-develop 从 输入/剧本完整版.txt 生成分集地图；先识别这份文件的分集方式，不要整稿塞进上下文

# 1. 新建项目
用 $short-drama 初始化一个都市打脸题材的短剧项目，竖屏 9:16

# 2. 写第一集
用 $short-drama-write 写第 1 集：外卖员在高档餐厅被经理羞辱，亮出集团董事身份

# 3. 拆资产，写提示词与分镜（可在同一请求内连续完成）
用 $short-drama-assets 从第 1 集拆人物/场景/道具
需要统一视觉语言时，可选用 $short-drama 做 Look Development
用 $short-drama-image-prompts 为已接受的资产写参考图提示词
用 $short-drama-storyboard 给第 1 集做正式分镜与冻结关键帧
用 $short-drama-video-prompts 把分镜逐镜翻译成视频提示词
# 指定目标视频模型、并且要人物/场景/道具跨镜一致时，把参考图的事也说清楚：
用 $short-drama-video-prompts 按 MiniMax H3 写第 1 集视频提示词；先在项目里找已有的角色图、场景图、道具图和本镜起始帧绑成参考，缺哪张就列出来，不要改成文生视频
# 参考图在自己的界面里出、不进项目时，让技能写出逐镜挂图计划，视频提示词照常产出：
用 $short-drama-video-prompts 按 MiniMax H3 写第 1 集视频提示词；参考图我自己挂，逐镜告诉我挂哪几张、什么顺序、每张管什么

# 4. 明确确认后投产
用 $short-drama-produce 预览第 1 集已接受的图片、视频、TTS 或时间线音乐任务；等我确认后再执行

# 5. 把生产出来的素材剪成成片
用 $short-drama-edit 把第 1 集已生产的镜头剪成成片，逐段写清入出点理由

# 6. 需要时再审查
用 $short-drama-review 审查第 1 集的剧本与提示词

从原著出发、第一轮只要文本交接的写法：

用我有权改编的 输入/故事.txt，先列出必须保留的事实、人物动机与暂不可揭示的信息，再提出分集方案；章节数不要直接当集数。只写第一集，并交接其中三个镜头的起止动作、双手、持物和视线。区分 IMG-*、待提供的 PLAN-* 与已实际检查的 REF-*，止步于文本，不生成图片、视频、配音或音乐。

看看它的输出

下面节选来自仓库里的文件或一次真实运行，省略处以「……」标出。完整版（原著快评的回填对照、改编契约、 剪辑实测与模型行为观察）在真实产出节选。

一集写出来是什么样

公开样例 《让你管账号》EP001 里，同一个镜头在四份文档里各管一层。剧本只写发生了什么：

[OS] 其他军团的人：火箭军？四个号，加起来四个粉吧。

笔记本的扬声器里一片哄笑。桌后，周薄森对着屏幕坐得笔直，脸绷着。桌前，江晨双手撑着桌沿，猛地回神。

视觉设定.md 给需要跨镜保持的造型上「连续性锁」，锁面是一条能原样贴进提示词的短语：

- 连续性锁：LOCK-JIANGCHEN-DRESS《江晨松枝绿常服》（镜头：SHOT-EP001-002、SHOT-EP001-003、SHOT-EP001-007、……；
  图片提示词项：IMG-JIANGCHEN-SHEET）· 锁面：pine-green lapel service jacket

分镜.md 写这一镜的起点和终点、运镜为什么这样动，冻结关键帧只画起点那一格，锁面原样出现在里面：

## SHOT-EP001-002 · 四个号，四个粉
- 运镜：缓推，哄笑声最响时开始，越过笔记本背面推向桌后，停在周薄森绷紧的脸；这阵笑是冲他去的。
- 起点：周薄森面对笔记本坐得笔直，右手搭在茶杯旁；江晨双手掌心朝下撑在玻璃桌沿，眼神涣散。
- 终点：画面停在周薄森绷紧的脸与屏幕冷光；江晨仍撑着桌沿，留在画右边缘。

### 冻结关键帧提示词
> 9:16 vertical two-person medium shot in a present-day army arts-troupe office, framed at chest height: Jiangchen, a lean
> young man in a pine-green lapel service jacket, stands mid-ground on frame right …… with both palms flat on the glass and a
> dazed, unfocused look; Zhoubosen, a broad square-faced middle-aged officer, sits bolt upright behind the desk …… facing a
> thin silver laptop whose lid faces the camera, …… his right hand beside a double-walled glass tea tumbler on a dark round
> coaster; …… no text, no logo.

视频提示词.md 只写起点到终点之间模型要执行的动作，整段复制进生成界面就能用：

## MOTION-EP001-002 · 四个号，四个粉
### 可复制提示词
> …… Laughter keeps pouring out of the laptop's small speaker. The seated officer's jaw tightens and his back straightens a
> little more. The young man blinks once and his eyes snap into focus. At the loudest point of the laughter, the camera moves
> steadily forward past the back of the laptop and stops when the seated officer's tight face fills the middle of the frame,
> the young man remaining at the right edge. ……

四份原文：剧本.md · 视觉设定.md · 分镜.md · 视频提示词.md。

写漏了会被指出来

creator_markdown_check.py 核对五份文档之间的引用。把样例故意改坏两处——删掉 SHOT-002 视觉依据里的周薄森、 把 MOTION-003 的时长从 2s 改成 3s——报错会指出对应镜头和原因：

ERROR: SHOT-EP001-002: 冻结关键帧提示词写到人物「周薄森」，视觉依据没有覆盖；本镜确实看不见时在视觉依据末尾加「；画外：人物「周薄森」」，正文里这个名字不可靠时在《视觉设定.md》写「画面代称：无」
ERROR: SHOT-EP001-003: 分镜时长 2 秒与视频提示词 3 秒不一致；视频提示词只能原样照抄已接受的镜头时长

十二个技能

各阶段按请求调用：文本交付在所需阶段完成，审查可针对任一已有产物；静态漫剧从关键帧与配音进入生产和剪辑。

flowchart LR
    classDef phase fill:#e8f4fd,color:#1a1a2e,stroke:#4a9be8,stroke-width:1px
    classDef final fill:#fce4ec,color:#333,stroke:#e57373,stroke-width:1px

    nva["原著分析<br/>$short-drama-novel-analyze"]:::phase
    brk["对标拆解<br/>$short-drama-breakdown"]:::phase
    dev["故事开发<br/>$short-drama-develop"]:::phase
    write["分集剧本<br/>$short-drama-write"]:::phase
    assets["资产决策<br/>$short-drama-assets"]:::phase
    img["图片提示词<br/>$short-drama-image-prompts"]:::phase
    sb["分镜/关键帧<br/>$short-drama-storyboard"]:::phase
    vid["视频提示词<br/>$short-drama-video-prompts"]:::phase
    prod["确认后生产<br/>$short-drama-produce"]:::phase
    cut["剪辑成片<br/>$short-drama-edit"]:::phase
    rev["审查<br/>$short-drama-review"]:::final
    pkg["文本交付包"]:::final

    nva -.有原著时.-> dev
    brk -.有对标剧时.-> dev
    cut -.成片对照.-> brk
    dev -.可选.-> write --> assets
    assets --> img
    assets --> sb --> vid
    img --> prod
    vid --> prod
    prod --> cut --> rev --> pkg

本地短剧创作台

在智能体里一句话启动（Codex 写作 $short-drama dashboard）：

/short-drama dashboard

macOS、Linux、WSL 与 Windows 原生都可运行。创作台以 --detach 独立进程运行，链接在整个创作期间 保持有效；--status 打印当前链接，--stop 关闭。服务只监听本机，项目内容不上传。

全部跑完后导出交付：$short-drama 用 project_tool.py export <project> --out <项目外目录> 把每集现有的五份创作文档、剪辑单.md 和 制作成果/ 复制成带清单和校验和的交付目录。 只交文本时加 --no-media；缺少哪些创作文档会记在清单里。

常见问题

MiniMax H3 的提示词有六段，全部复制还是只复制第一段？

全部复制。六段属于同一条正文、一次提交：retention_analysis 引用的 <Subject N> 在 subject_definitions 里定义， <Picture N> 按本镜「输入参考图」的顺序编号，拆开提交后面几段就没有指代对象了。从 ### 可复制提示词 下第一行到最后一行 整段贴进那一次生成，下一镜换它自己那条。见五份创作文档与 MiniMax H3 方言。

参考图我在自己的界面里出、不想放进项目，还能拿到图生视频提示词吗？

能，这就是默认做法。项目里找不到图时，分镜把这一镜要挂的图写成 PLAN-* 槽位（定位符是 IMG-* 板子或本镜 SHOT-* 冻结关键帧，顺序 就是挂图次序， 每张写用途），视频提示词照常按图生视频产出，并逐镜列出挂哪几张、什么顺序、每张管什么；只有让套件实际调用接口生成时才需要真实文件。 REF-* 留给项目里确实存在并检查过的图片。

指定了目标视频模型，为什么收到的是文生视频提示词？

点名模型不等于选择文生视频。先把模型写进 short-drama.json 的 production_profile，再让分镜按可见人物、地点、道具和起始帧 去项目里找已有的图绑成带用途的 REF-*；仍缺的图默认写成 PLAN-* 挂图计划、照常产出图生视频提示词，不改成文生视频。见 漫剧创作全流程指引 · 常见卡点。

H3 视频里对白赶读或被截断怎么办？

分镜阶段先估对白时长再定镜长：H3 中文小样本约 4.1 个可发声字/秒，较密的输入会赶词或不报错直接截断。分镜把估时依据写在本镜「声音」里， 放不下就延长镜头或拆镜；视频提示词只能原样照抄已接受的时长。见对白估时。

说话的是 A，口型却落在画里 B 的脸上？

先检查说话人绑定：小样本中出现过口型落在更显眼正脸上的情况。说话人第一次出现时在 <d> 外交代画内画外与音色，台词紧跟他的动作句； 台词期间画里还有别的正脸时，把那个人明写成闭嘴不说话，分镜能安排时先让他出画或背身。见 MiniMax H3 方言 · 说话人绑定；样本小，生成后仍核对。

视频任务提交后进程断了，要重投吗？

先恢复原任务。异步任务提交后可能已产生费用，内置 adapter 拿到供应商任务 ID 就会立刻写入本地文件。中断后让生产技能运行 audit； 它会把带任务 ID 的未完成尝试报成 orphaned_provider_job，再用 collect 取回既有结果，不提交新生成任务。 确认原任务已终态失败、无需继续取回后，再为重投重新预览和确认；暂时无法轮询或下载时先排查取回路径。见 确认后生产。

需要 GPU 或自己部署模型吗？生成媒体的钱从哪出？

不需要 GPU。写作、分镜和提示词由你正在用的编程 Agent 的模型完成，本地脚本负责索引、检查、生产任务交接与剪辑渲染。生成媒体走 $short-drama-produce 的外部 adapter，用你在项目外配置的供应商凭据、按供应商计费，每个任务预览并明确确认后才执行。剪辑成片需要本机有 ffmpeg / ffprobe。

能在 Codex 里用吗？Windows 能用吗？

能。Claude Code 用 /short-drama，Codex 用 $short-drama，其他支持 Agent Skill 规范的环境按各自写法调用。 创作台在 macOS、Linux、WSL 与 Windows 原生都能跑；CI 在 Windows 上单独回归安装、分集导入与创作台。

静态漫剧（关键帧切换 + 配音）也要写视频提示词吗？

不用。分镜关键帧与图片提示词直接进入生产预览，跳过视频提示词那一层。见漫剧创作全流程指引。

升级到新版本后要做什么？

重跑同一条安装命令；既有项目对每集跑一次 creator_markdown_check.py，收紧过的规则会在这里报出来（例如 v0.7.0 起， 分镜「来源」引文点到的人物或道具没进视觉依据、也没声明画外会报错，视频提示词与分镜时长不一致会报错），文档规则的改法见 CHANGELOG.md 里的《升级》段。剪过片的再跑一次 edit_tool.py check：v0.7.1 起「未采用镜头」要逐个写镜号和理由， 「001 至 009」这种范围写法不再被接受。

延伸阅读

• 示例：examples/，公开完整样例是 《让你管账号》EP001；其余目录是仓库校验器的回归夹具。
• 真实产出节选：一镜穿过四份文档、检查器报错、剪辑单与实测、原著快评回填、改编契约、模型行为观察。
• 评估：按文档实跑一次的完整产物、发布前的回归闸门与主工作流实跑方法。
• 漫剧创作全流程指引：把十二个技能按漫剧产线从头串一遍，每步命令、产物与卡点。
• 跨镜一致性怎么做：跨镜、跨集角色一致性，三视图之外的三层文件事实。
• 短剧剧本格式模板：场景标题、动作、对白和制作标签怎么分，用 AI 整理旧稿后查什么。
• 分镜脚本怎么写：短剧分镜表模板，把剧本逐镜拆开。
• 角色三视图提示词怎么写：三视图模板、范例与常见失误。
• Seedance 提示词怎么写：起点、动作顺序、终点，以及 2.5 与 2.0 的写法差别。
• 开源 AI 短剧 / 漫剧工具怎么选：9 个项目按使用方式、许可证、覆盖环节与跨镜一致性做法对比（含利益相关说明）。
• 小说改短剧指南：从有权改编的原著出发，形成分集决策、单集剧本与小范围分镜交接。
• 角色跨镜一致性指南：分开人物身份、本场造型与逐镜变化的双手、持物、视线；区分 IMG-*、PLAN-* 与 REF-*。
• An open-source AI short-drama pipeline：英文读者的分阶段说明。

交流

• Telegram 群：https://t.me/+CZmsmvWIhb4zZTNl —— 日常交流、踩坑、用法分享与新功能讨论。
• GitHub Issues：Bug、输出质量 Case、功能请求，请按结构化表单附上复现材料或具体输出。

贡献

修改原则与必跑测试见 CONTRIBUTING.md。

致谢

LINUX DO - The New Ideal Community — 社区支持

ZenStory AI 项目

本项目由 ZenStory AI 维护——一套开源的 AI 故事创作、改编与制作工具（GitHub 组织：zenstory-ai）。同组织项目：