mcpField
S
short-drama-assets

short-drama-assets

github.com/zenstory-aiCreative & media3.5k1.8k installsUpdated 1w ago
Repository

About short-drama-assets

A skill for extracting reusable visual facts from short-drama scripts and organizing them in a shared settings document. It is intended for creators preparing assets for storyboarding, generation, and continuity work, with explicit boundaries between asset identity, variations, and shot-level details.

Key features

  1. 01Extract characters, places, and props
  2. 02Separate asset identity from state variations
  3. 03Record cross-scene and episode states
  4. 04Maintain continuity locks for visible facts
  5. 05Check unresolved references and missing assets

Use cases

  1. 01Organize episode assets from a script
  2. 02Track costume, injury, and prop changes
  3. 03Preserve visual facts across shots

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zenstory-ai/drama-skills --skill short-drama-assets

After installing, type/short-drama-assetsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
asset-review-checklist.md
character-and-look.md
continuity-delta.md
continuity-lock.md
era-anchors.md
identity-vs-variant.md
location-and-view.md
occurrence-extraction.md
prop-and-state.md
stage-contract.md
voice-direction.md

Details

From the project README

短剧资产拆解

从剧本提取可复用、可持续的视觉事实,统一写入 剧集/<EP>/视觉设定.md;每次出场先判断身份 与状态,剧本语义、镜头走位和生成提示词由各负责技能处理。

Quick Start

用 $short-drama-assets 从 EP001 剧本拆完人物、造型、地点、道具和本集状态

入口与边界

现成剧本可以直接拆资产。先区分:

  • 身份:换一个就不再是同一个人、地或物;
  • 变体:身份不变,但服装、伤势、时段、天气、开合或持有状态改变;
  • 镜头瞬态:姿势、视线、左右手、站位和相机角度,由分镜拥有;
  • 故事语义:知识、目标、关系和情绪由写作/开发拥有,只引用可见后果。

工作流

  1. 只读当前范围的剧本和已决定的视觉方向;视觉方向还没有时代锚点时,按已提供的原著或剧本事实判断,证据不足则标为待决定。
  2. 逐场找实体、可见描述、状态变化和含混指代,先不创建资产。
  3. 对每项决定新建、复用、增加变体或标记未决;含混指代不猜。
  4. 写最小可识别设定:统一使用 识别锚点、本集状态和变化原因;会持续限制后续动作的身体—物件—空间关系写进有生效范围的状态,不当成一次姿势略过。
  5. 检查造型/伤势、持物/所有权、道具状态、地点时段/天气/光态与跨集结束状态。
  6. 给跨镜出现且观众看得出不一致的可见事实写一条连续性锁,其余保持识别锚点即可。此时还没有分镜,镜头范围写 入画,锁写在它所属的条目下(服装写在 造型 条目下),分镜写完后自动按「视觉依据」生效,见 连续性锁。
  7. 项目提示词语言不是中文时,给每个人物条目写一行 画面代称:<正文里的拼写>;正文从不点名它就写 画面代称:无。地点和道具按需。
  8. 整集请求自动处理完整集,末端一次回报关键身份决定和未决指代。

内容要求

  • 每项先写什么不变使它仍是同一资产,再写本集变化。
  • 识别锚点必须可见、可生成、可比较,不用空泛质量词替代事实。
  • 服装、伤势、湿污、道具开合和光态通常是变体,不是新身份。
  • 不复制剧情摘要,只保留下游生成、分镜或连续性真正需要的事实。
  • 文字、标识和敏感信息遵守项目政策,不擅自补造品牌或私密信息。
  • 多集状态写清生效与持续范围;镜头内瞬态留给分镜。
  • 已确认且持续限制动作空间的关系(身体依托、固定、负重、占位或与功能物件的接触)不是普通镜头姿势:可独立识别的物件仍建资产,关系写进状态并交给分镜逐镜投影;只有剧本明确改变时才结束。
  • 连续性锁只锁不随剧情改变的可见事实;锁面用提示词语言写成最小名词短语,会变的部分留给状态。
  • 「画面代称」把提示词正文里的名字对回本条目,供机械核对关键帧里点名的人物、地点或道具。未声明时,检查器使用条目名称; 显式声明后只匹配列出的代称,混合语言正文要把实际使用的中文名与其他语言拼写一并列出。提示词正文语言不是中文时, 人物条目必须给出结论:列出正文使用的拼写,或在正文从不点名时写 画面代称:无。同一个名字全集只用一个拼写, 大小写也一致;多个写法用 、 分隔。名字与常用词同形(道具「手机」 撞上「手机店」)时也写 画面代称:无,让核对不按名字找它。

按需知识

默认只读本 SKILL、当前剧本和视觉方向。遇到对应问题时只打开一份:

完成

所有明确出场都已复用、新建、变体化或标为真实未决;需要保持的视觉事实与状态变化已写入唯一 视觉设定文档,即完成。图片提示词、分镜、审查和生产不自动开始。 写完本阶段文档后,可转 $short-drama 做局部机械核对(只核对已有文档);五份齐备后再做完整核对。内容质量仍由创作者审查。

Comments

Markdown supported