中文 | English

Drama Skills

面向编剧、漫剧工作室和编导的 AI 短剧创作工作流。八个技能把一个点子或一部长篇材料， 一路做成分集剧本、资产设定、图片提示词、分镜关键帧、视频提示词和独立审查记录， 全程用同一套创作者决策、来源引用与连续性契约衔接。适配 Claude Code、Codex 和其他 支持 Agent Skill 规范的运行环境。

产出是文本：剧本、设定、提示词、审查记录。

演示

《孤身入魔》演示含项目设定、两集剧本和十二板分镜；下方 15 秒宣传样片为临时展示，非默认产物。

https://github.com/user-attachments/assets/ae88b444-06e5-4964-856c-91e619020f12

由来

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

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

刻意不含生图与生视频：为防止未经确认的提示词误触发生成、造成预算浪费，本项目 不调用真正的图片、视频或音频生成服务。提示词先落进文件、由人确认，再进入生成环节。

安装

需要 Python 3.10 或更新版本（macOS 自带的 3.9 不够）。直接告诉 Claude Code、 Codex 等支持导入 GitHub 仓库的智能体：

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

git clone https://github.com/worldwonderer/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， 也可以不写前缀、直接用自然语言说明要做什么。两种写法在下文示例中可以互换。

快速开始

# 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-image-prompts 为已接受的资产写参考图提示词
用 $short-drama-storyboard 给关键场次比较导演方案、接受场次视觉计划，再做正式分镜
用 $short-drama-video-prompts 把分镜逐镜翻译成视频提示词

# 4. 独立审查
用 $short-drama-review 审查第 1 集的剧本与提示词

一集完整的摘录链条见 demo/：剧本 → 资产设定 → 分镜 → 视频提示词。

八个技能

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

    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
    rev["独立审查<br/>$short-drama-review"]:::final
    pkg["文本交付包"]:::final

    dev -.可选.-> write --> assets
    assets --> img
    assets --> sb --> vid
    img --> rev
    vid --> rev --> pkg

$short-drama 是入口路由，负责初始化、继续、恢复和交付，把具体工作转给对应技能。 现成剧本可以直接进入规范化或资产拆解，点子与长篇材料则从故事开发进入。

三条单帧提示词路径职责不同：项目级 lookdev_frame 检验已接受视觉方向；资产提示词固定人物、 地点、道具的可复用事实；storyboard 的关键帧只投影本镜 start（执行方式需要时可增加只投影 end_boundary 的 end 帧）。三者都只交付文本，不调用图片模型。

关键场次可以在正式 shots 前增加一层稀疏导演决策：先比较真正不同的信息时机、观看位置与 表演空间，再接受场次视觉计划，让构图、空间、摄影和声音共同完成一个转向。普通场景跳过， 不规定宫格、方案数或镜头数。

本地短剧创作台

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

/short-drama dashboard

创作台仅支持 macOS/Linux 本机运行。界面只有一个页面：左侧是按项目和剧集整理的 内容目录，右侧始终直接显示当前正文；打开项目后会自动载入剧本，不再切页或弹出浮层。 待办与导出只在正文下方给出简短提示，工程文件、路径和生命周期由系统内部维护。

致谢

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