zenstory-ai/drama-skills

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

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

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

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

• 五份 Markdown 就是创作事实 — 每集只维护 剧本.md、视觉设定.md、分镜.md、图片提示词.md、 视频提示词.md，剪成片时多一份 剪辑单.md。没有并行的数据库，改哪份文件就是改哪一层决定。
• 人物和造型跨镜不走样，靠的是写进文件、脚本能核对的事实 — 需要跨镜保持的造型写成一条能原样贴进提示词的短语（连续性锁）； 每一镜写完关键帧后要说明它依据了哪些条目；漏了的，检查脚本会指出来，真实报错见下文。
• 先预览、确认，再生产 — 任何图片、视频、配音或音乐任务，都先在文件里看到这一批准确的内容和参数， 明确确认后才调用外部接口花钱。
• 成片也在套件里 — 剪辑技能逐段写下入点、出点为什么选在那里，字幕逐字取自剧本，统一响度后渲染； 核对和测量脚本只回报事实，不下判断。

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

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

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

ClawHub 分发由仓库中的 显式发布清单 管理，并通过 ClawHub 提供发现入口。具体 skill 链接只有在发布者、版本和匿名访问均验证后才会写入本文档，避免把尚不存在的条目当成已上架。

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

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

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

也可以直接对 Agent 说一句话（支持导入 GitHub 仓库 / skill 的平台都适用）：

安装这些技能 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

调用写法随运行环境而变：Claude Code 用 /short-drama，Codex 用 $short-drama， 也可以不写前缀、直接用自然语言说明要做什么。两种写法在下文示例中可以互换。

变更见 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
    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
    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 <项目外目录> 把每集现有的五份 Markdown 和 制作成果/ 复制成一份带清单和校验和的交付目录。

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

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

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

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

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

不要。任务在提交那一刻就已计费，内置 adapter 拿到供应商任务 ID 就落盘。中断后跑 audit，它把这次尝试报成 orphaned_provider_job； 再用 collect --job-id <id> 取回结果，取回不花钱、不走确认闸门。只有 collect 也确认那边确实失败，才重新确认与重投。见 确认后生产。

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

能。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；其余目录是仓库校验器的回归夹具。
• 真实产出节选：一镜穿过四份文档、检查器报错、剪辑单与实测、原著快评回填、改编契约、模型行为观察。
• 评估：按文档实跑一次的完整产物、发布前的回归闸门与主工作流实跑方法。
• 漫剧创作全流程指引：把十一个技能按漫剧产线从头串一遍，每步命令、产物与卡点。
• 跨镜一致性怎么做：跨镜、跨集角色一致性，三视图之外的三层文件事实。
• 小说改短剧指南：从有权改编的原著出发，形成分集决策、单集剧本与小范围分镜交接。
• 角色跨镜一致性指南：分开人物身份、本场造型与逐镜变化的双手、持物、视线；区分 IMG-*、PLAN-* 与 REF-*。
• An open-source AI short-drama pipeline：英文读者的分阶段说明。

欢迎提交 Bug、输出质量 Case 与功能请求到 Issues，请按结构化表单附上复现材料或具体输出。修改原则与必跑测试见 CONTRIBUTING.md。

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

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