# Short Drama Storyboard

把中文短剧剧本和视觉设定写成有戏剧职责、连续性边界与冻结关键帧提示词的分镜...

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

## Install

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

## Description

把中文短剧剧本和视觉设定写成有戏剧职责、连续性边界与冻结关键帧提示词的分镜 Markdown。用户提出“拆分镜/设计镜头/做镜头表”“场次视觉计划/调度故事板”“比较导演方案”“写首帧/关键帧提示词”或检查轴线、站位、视线、持物连续性时使用；不生成媒体。

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

# 短剧分镜与冻结关键帧

把剧本和视觉事实转成有镜头职责、空间连续性和可冻结起点的 `剧集/<EP>/分镜.md`。
每镜使用二级标题 `## SHOT-...`，同镜下用 `### 冻结关键帧提示词` 写起始帧正文；
需要时另加 `### 收尾关键帧提示词` 写终点正文。

## Quick Start

```text
用 $short-drama-storyboard 完成 EP001 的正式分镜和每镜冻结关键帧
```

## 入口

当前剧本加必要视觉事实即可直接进入。资产图片提示词与分镜是兄弟分支，不互相等待。只有关键场次
真的存在多个成立导演方案时，才在上下文比较覆盖方案；普通场次直接设计。

创作者可读说明跟随项目语言；冻结关键帧的可复制正文跟随
`short-drama.json#/format/prompt_language`。没有 `short-drama.json` 时正文默认使用 `en`。
分配镜头时长前读取
`short-drama.json#/creator_authority/production_profile/choices/native_duration_seconds`。已声明目标模型但
没有原生时长时先补这一个选择；目标模型也未声明时照常按叙事节奏设计，不猜供应商限制。
同时读取 `short-drama.json#/creator_authority/rhythm_profile`：`status` 为 `accepted` 时，镜长按
[镜长从哪来](references/shot-craft.md#镜长从哪来-sht-28) 由声音事件与 `target_avg_shot_seconds` 推出，
全集近景类镜头占比不低于 `close_shot_share_min`；档案缺失或未接受时不核对这些数值。

冻结关键帧成稿后，再按画面中的可见内容填写视觉依据、图片提示词项和输入参考图，
避免只按镜头意图列资产而漏掉实际入画的人物或物件。

用户没有手工点名参考图，不等于选择文生视频。冻结关键帧后先根据本镜可见人物、地点、关键道具与
起始构图判断一致性需求，再检查项目中已有的真实图片。只有当前可读、内容与用途可核对的图片才能自动绑定；
文件名像某个角色但内容未核对时，仍视为未准备好。

项目里没有所需图片时，默认按创作者会在自己的工具里出图、生成时自行挂载处理：把缺的图写成
`PLAN-...` 挂图计划，本镜照常就绪，不停下来等图。报告里一并说明另外两条路：把已有图片放进项目绑成
`REF-...`（用本套件的生产技能出图也走这条，需要项目外的 adapter 与凭据，且只有 `REF-...` 能投产），
或者明确改走文生视频。创作者说过要先等图进项目时才写「待补参考图」。

开始分镜前读 `剧集/<EP>/剧本.md` 的当前内容。创作者说「剧本已确认采用」指的是那个文件，
不是对话里更早的草稿；两者不一致时以文件为准，并把差异说出来。

## 工作流

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