Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/zenstory-ai/drama-skills --skill short-drama-storyboardAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
短剧分镜与首尾帧提示词
把定稿剧本和视觉设定拆成切镜有据、空间连戏、起止画面清楚的 剧集/<EP>/分镜.md。 每镜使用二级标题 ## SHOT-... · <名称>(SHOT- 编号后缀仅使用大写字母、数字与连字符 A-Z0-9-;依次列出「来源、时长、目的、景别/机位、运镜、起点、动作、终点、画面文字(可选)、图片提示词项(可选)、输入参考图、出场设定、声音」,其中 - 来源: 直接以 <场景 ID> 开头,如 EP001-SC001「…」),同镜下用 ### 首帧提示词 写起始帧画面(小节内只放顶格以 > 开头的引用块,不夹普通列表或 --- 分隔线;确需锁定收尾构图时另加 ### 尾帧提示词 写终点画面)。
快速开始
用 $short-drama-storyboard 完成 EP001 的正式分镜和每镜首帧提示词入口与语言配置
- 有定稿剧本与必要视觉设定即可直接动笔(先读磁盘最新
剧集/<EP>/剧本.md,与早期对话草稿有出入时以文件为准)。美术设定图提示词与分镜可并行推进,仅当创作者明确要求比选重头戏拍法时才先给备选方案等拍板,常规整集或单场拆镜直接一气呵成。 - 创作者可读说明跟随项目语言;首尾帧的可复制提示词正文跟随
short-drama.json#/format/prompt_language(没有short-drama.json时按已有提示词或项目文档语种推断,未指定时可用用户当前语言)。 - 分配镜长前参考
short-drama.json#/creator_authority/production_profile/choices/native_duration_seconds与rhythm_profile:已确认模型秒数区间时贴合单镜上下限(短于下限的快切可提议多镜合生或演完稳住终点画面);未填写秒数或未定模型时,直接按对白与动作体量给常规秒数(如 2–6s),不因此停工追问。target_avg_shot_seconds与close_shot_share_min作为全集节奏与近景占比的参考区间弹性把握。
工作流
- 排定戏剧落点与悬念时机:顺场理清动作、对白、音效、画面文字与转折落点(若立项或剧本限定了“后半段 / 最后 N 秒首次露面”,按全集目标时长换算到具体秒数位置再排镜)。
- 逐镜写清起止、运镜与声音:顺着
起点 → 动作 → 终点交代人物站位、姿态与持物交接,单镜动作量贴合秒数(见 镜头设计方法):
运镜:运动镜头写清动法与起止落点(开场强钩子或高潮反转可用急推),固定镜头直接写固定即可,无需强凑不动理由;声音:排镜时按台词与停顿估准秒数,文档「声音」行清爽写明对白/VO/OS、关键音效与留白即可,免写读秒算术账。
- 按需标注空间站位与轴线:三人以上群戏、复杂空间换位或跨轴调度时,按需在该场开头写一段
场景站位标尺(简单双人场直接在各镜起止点写清即可),见 场面调度手册;动作打斗戏拆法见 打戏与动作分镜。 - 编写首尾帧提示词:
### 首帧提示词只定格镜头起点瞬间画面(带连戏锁的条目在生效范围内原字保留锁定词),需要锁收尾构图时另补### 尾帧提示词。全集保持统一画风与同场主光方向——明确标出的回忆闪回、梦境幻觉或主观视角镜头可按剧情意图切换色调质感或画风表现。同机位切景或微调表情动作时,允许基于已确认的上一镜首帧配合指令改图模型派生下一镜首帧以锁死连戏(见 首尾帧构图与写法)。 - 补齐关联字段并核对整集:确认
- 来源:直接以<场景 ID>开头(如EP001-SC001「…」),含[画面文字]的镜头填写可选- 画面文字:;首尾帧写定后,按画面实际入画主体填好必填的出场设定、输入参考图及可选的图片提示词项(语法见下节)。剧本每个场次都须有镜头覆盖,确需整场略过时在文档开头(首个## SHOT-...之前)写- 未拍场次:<场景 ID>(理由:……),多个未拍场次之间用全角分号;分隔;全集总时长与待拍板事项在回复中说明,或放在文档末尾独立的## 整集汇总二级标题下(切勿不加##标题直接附在最后一镜### 首帧提示词引用块下方)。
出场设定与参考图写法
用户没有手工点名参考图,不等于选择文生视频。首尾帧成稿后,对照提示词正文里实际入画的人物、造型、场景与道具核对填写关联字段(每项 控制: 只写本镜景别实际可见的部位,不照搬上一镜全身范围):
- 出场设定(必填):写成
《视觉设定.md》·<人物|造型|地点|道具>「<名称>」(控制:<范围>),多项用;连接,名称与《视觉设定.md》条目标题完全一致。入画人物身着《视觉设定.md》单独建档的 `## 造型 · <名称>` 且衣服在本镜可见时,须同时列出 `造型「<名称>」`,以便触发挂在造型条目下镜头:入画的服装连戏锁;手部或眼部特写看不到衣服时不列造型「…」。校验只核对首尾帧入画主体,不扫描- 来源:引文;若首尾帧正文因归属物或字样提到了本镜未入画的条目,在行尾加;画外:<人物|造型|地点|道具>「<名称>」(多项用;连接)。远景需认出身份的角色照常列入,完全无设定条目入画时写无;尚未建档的连戏物件先在提示词稳住描写,并在汇总里请$short-drama-assets补建。 - 图片提示词项(可选):有对应设定图条目时填写《图片提示词.md》已有的
IMG-...《<名称>》(控制:…)(《…》内名称须与标题一致);尚无对应条目时可写无或省略该行。 - 输入参考图(必填):自动在用户提供的输入、
剧集/<EP>/制作成果/和文档已指向的可见媒体中核对真实图片—— - 已有真实可读图片(支持
.png/.jpg/.jpeg/.webp)绑定REF-...,外部工具自挂图片预留PLAN-...(REF-与PLAN-槽位后缀仅使用大写字母、数字与连字符A-Z0-9-;PLAN-...将路径位置换为IMG-...或SHOT-...,指向IMG-...时《…》内名称须与《图片提示词.md》标题一致,支持正反打等跨镜复用已有镜头首帧),两者可混排并从1连续编号:REF-<slot>(顺序:<n>)· <项目相对路径>《<名称>》(用途:<用途>;控制:<范围>;不得控制:<范围>)。注意全角冒号与路径前的中点·,不得用/代替字段分隔符,多图之间只用中文分号;连接。 用途从外貌、主体、造型状态、空间布局、构图、尺度、效果、起始帧、结束帧、风格十项选填唯一主作用(一图兼顾两事时次要作用写进控制:;每镜最多一张起始帧和一张结束帧,挂结束帧必同时挂起始帧;参考图位超模型上限时按「起始帧 → 核心动作/开口角色 → 关键道具 → 场景 → 其余角色 → 风格」取舍)。- 创作者要求等实图到位时写
无(待补参考图:<缺项>)或在已有图位后接;待补参考图:<缺项>(缺项用、分隔);确认不垫参考图时写无(文生视频)。或简写无(只有真实REF-...可直接交$short-drama-produce图生投产)。
修订原则
返修分镜时按戏剧职责维护 SHOT-... 镜号稳定:
- 调顺序或同镜微调(改景别、走位或起止细节)→ 保留原
SHOT-...镜号,同步修好相邻镜衔接; - 新插独立镜头(补反应特写或道具插入镜)→ 新开
SHOT-...镜号,后续老镜号不顺延改号; - 一镜拆多镜 → 承接原起点与已生成首帧的主半镜可保留原
SHOT-...镜号,仅给新拆出的子镜开新号; - 多镜并一镜或整镜推翻重拍 → 停用旧号换新号,已停用废号绝不重用,并在回复中点明需同步更新的下游
MOTION-.../GROUP-...。
按需查阅
- 阶段边界与规则分级:阶段规则
- 节拍拆镜、机位焦段、运镜、时长推算、首尾成对与重头戏构思比选:镜头设计方法
- 竖屏多人纵深、按需站位块、正反打与画外视线例外:场面调度手册
- 多招回合与单招落定、受击借位与多人围攻调度:打戏与动作分镜
- 首尾帧五步写法、同机位首帧派生、实景受光与漫剧专属词条:首尾帧构图与写法
- 从剧本片段拆到英文首帧提示词与关联字段的端到端示范:剧本到首帧完整示例
完成标准
同轮同时修改《图片提示词.md》与《分镜.md》时当场同步引用,不另建场次核对表文件。单场试拆或上下游其余文档尚未齐备时,可用 $short-drama 的 creator_markdown_check.py 剧集/<EP> --project-root . --partial 做局部校验;整集齐备后可跑完整校验。视频提示词、生成投产与独立审查只在创作者点名时启动。