# Short Drama

基于文件系统初始化和继续短剧或漫剧项目，提供 creator-first 五文档路由、本地 Dashboard、制作形态与 Look Development...

- Repository: https://github.com/zenstory-ai/drama-skills (3625 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add zenstory-ai/drama-skills --skill short-drama -g -a claude-code -y`
Codex: `npx skills add zenstory-ai/drama-skills --skill short-drama -g -a codex -y`
Cursor: `npx skills add zenstory-ai/drama-skills --skill short-drama -g -a cursor -y`
Gemini CLI: `npx skills add zenstory-ai/drama-skills --skill short-drama -g -a gemini-cli -y`

## Description

基于文件系统初始化和继续短剧或漫剧项目，提供 creator-first 五文档路由、本地 Dashboard、制作形态与 Look Development 决策。用户提出“创建/继续短剧项目”“看进度/下一步”“做 Look Development”“打开 dashboard/短剧创作台”“导出制作资料”，或任务跨多个创作阶段时使用；明确的写作、资产、提示词、分镜、剪辑或审查请求由对应子 skill 直接处理。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 短剧创作路由

本技能负责项目初始化、跨阶段路由、制作形态与 Dashboard。各阶段正文由对应技能完成。

## Quick Start

当前创作统一使用 [creator-first 工作流](references/creator-workflow.md)：每集按需维护
`剧本.md`、`视觉设定.md`、`分镜.md`、`图片提示词.md`、`视频提示词.md`，不建立并行的结构化创作真相。
具体写法见 [五份创作文档](references/creator-documents.md)。

## 路由

| 用户要做什么 | owner / 行为 |
|---|---|
| 开发点子、系列承诺、改编和分集地图 | `$short-drama-develop`，仅在用户需要时 |
| 已有多集完整剧本/散稿识别分集 | `$short-drama-develop` 按实际边界建立临时索引 |
| 分析长篇原著 | `$short-drama-novel-analyze`，仅在用户需要时 |
| 写或改单集剧本 | `$short-drama-write` → `剧本.md` |
| 拆人物、造型、地点、道具 | `$short-drama-assets` → `视觉设定.md` |
| 写资产图片提示词 | `$short-drama-image-prompts` → `图片提示词.md` |
| 做镜头和冻结关键帧 | `$short-drama-storyboard` → `分镜.md` |
| 写视频/时间线音乐提示词 | `$short-drama-video-prompts` → `视频提示词.md` |
| 实际生成媒体 | `$short-drama-produce`，先预览，再显式确认，最后运行 |
| 把已生产的素材剪成成片 | `$short-drama-edit` → `剪辑单.md` 与 `制作成果/成片/` |
| 审稿或校验 | `$short-drama-review`，仅在用户点名时 |
| 初始化、Dashboard、归档点名文档 | 本技能 |

`项目开发/` 中的长材料分析与分集索引是可选分析工作区，不参与单集布局判定；写任何一集仍只维护
该集的五份 creator-first Markdown。

现成剧本可直接拆资产；已有视觉事实可直接写图片提示词或分镜；已有分镜可直接写视频提示词。
不要为补齐名义流水线伪造上游。

五份创作文档记录剧本、视觉与提示词；剪辑单在素材生产后记录取舍和后期处理。
修改故事、镜头职责或上游时长声明时，回到负责该内容的文档。

## 执行请求

1. 定位用户给出的项目或资料，只读当前任务的直接输入。
2. 把用户点名的完整范围交给相应技能；批次只控制上下文，自动续跑。
3. 只有真实创作分叉才询问；不要拿 schema、目录、事务或检查器询问创作者。
4. 范围完成后一次回报完成内容、关键决定、真实未决项和可选下一步。
5. 不自动开始用户没点名的审查、归档或生产。
6. 请求横跨视觉设定、图片提示词、分镜或视频提示词时，结束前核对当前已有文档的视觉依赖；
   图片提示词和分镜并行完成时，也要同步两支的引用。每写完一份文档就带 `--partial` 运行跨文档检查，只核对已有文档；五份齐备后再运行完整检查。不为检查补造文件。
7. 视频提示词请求遇到「输入参考图：无」或仍带「待补参考图」时，先路由分镜 owner 检查项目已有图片并刷新绑定。有匹配图就同请求续跑；仍有必要图缺失、
   创作者也没另作选择时，让分镜 owner 把缺的图写成 `PLAN-...` 挂图计划，照常产出视频提示词，不停下等图。
   回报时附逐镜挂图清单，并说明另外两条路：把图放进项目绑成 `REF-...`（本套件投产只认这种，用本套件生产参考图
   需要项目外的 adapter 与凭据），或者明确改走文生视频。创作者说过要先等图进项目时才列表停下。
   不把“没有手工指定”当成明确选择文生视频。这一轮如果镜头还缺「视觉依据」，
   同时按已成稿的冻结关键帧回填；两条依据描述同一格画面，不要只补一条。
8. 用户在会话里点名目标视频模型（“按 MiniMax H3 写”“用 Seedance 2.5”）而 `short-drama.json` 的
   `production_profile` 还是 `unset` 时，先把这个选择连同它带来的原生时长、参考方式和正文语言写进档案，
   再继续下游阶段。把已确认选择写入档案，后续请求才能沿用同一方言、语言和时长边界。

## 初始化与 Dashboard

需要项目配置时运行：

The rest: https://github.com/zenstory-ai/drama-skills/blob/HEAD/skills/short-drama/SKILL.md