LeoYeAI/agent-master-skills / skills/ai-drama-prompt-factory
ai-drama-prompt-factory
VerifiedAI短剧提示词工厂 - 端到端将小说/故事创意转化为结构化提示词包(角色立绘+场景+道具+分镜图片+视频+音频)的完整流水线。一个入口启动全流程,内部自动按阶段推进:策划→设计→剧本→诊断→提示词组装→API JSON输出。支持小说改编和原创短剧两条路径。触发词:AI短剧、短剧制作、小说转短剧、短剧提示词、提示词工厂、短剧全流程、小说改编短剧、生成短剧、AI视频剧本、短剧项目、分镜提示词、视频提示词、prompt factory。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 27.5 KB |
| _meta.json | config | 300 B |
| assets/negative-prompts.json | config | 2.4 KB |
| assets/project-template.json | config | 1.1 KB |
| references/api-schema.md | markdown | 11.0 KB |
| references/assembly-rules.md | markdown | 10.1 KB |
| references/continuity-guide.md | markdown | 1.9 KB |
| references/design-guide.md | markdown | 3.9 KB |
| references/diagnosis-guide.md | markdown | 3.0 KB |
| references/doc-reader-guide.md | markdown | 1.2 KB |
| references/manga-drama-guide.md | markdown | 2.4 KB |
| references/planning-guide.md | markdown | 2.3 KB |
| references/platform-adapters.md | markdown | 4.2 KB |
| references/prompt-examples.md | markdown | 3.7 KB |
| references/script-generation-guide.md | markdown | 3.3 KB |
| scripts/doc_fetch.py | script | 7.7 KB |
| scripts/doc_indexer.py | script | 14.9 KB |
| scripts/doc_search.py | script | 6.3 KB |
| scripts/doc_summarize.py | script | 7.8 KB |
references/api-schema.md
View on GitHub# API 输出 Schema
## 文件结构
```
output/
├── project-manifest.json # 项目级:角色库+场景库+道具库+风格
├── ep01-prompt-package.json # 第1集完整提示词包
├── ep02-prompt-package.json # 第2集
└── ...
```
---
## project-manifest.json
项目初始化时生成,角色/场景/道具增删时增量更新。
```json
{
"$schema": "drama-manifest-v1",
"project": {
"title": "项目名称",
"source_title": "原著名称",
"genre": "都市逆袭",
"era": "现代",
"total_episodes": 20,
"target_ratio": "9:16"
},
"style": {
"type": "电影写实",
"character_suffix": "电影写实风格,高质量,真实光影,电影级打光,8K分辨率,超高清细节",
"scene_suffix": "电影写实风格",
"storyboard_suffix": "写实风格,电影级打光,8K分辨率,超细节刻画"
},
"characters": {
"陈易": {
"gender": "男",
"age": 24,
"variants": {
"觉醒前": {
"prompt": "现代、24岁、男、短发凌乱/黑色、蓝白条纹病号服、病号裤、无、面色苍白,电影写实风格,高质量,真实光影,电影级打光,8K分辨率,超高清细节,全身,纯色背景,面向镜头",
"desc": "病号服,虚弱苍白"
},
"觉醒后": {
"prompt": "现代、24岁、男、短发利落/黑色、灰色运动外套、深蓝色运动裤、白色运动鞋、无配饰,电影写实风格,高质量,真实光影,电影级打光,8K分辨率,超高清细节,全身,纯色背景,面向镜头",
"desc": "运动装,精神焕发"
}
}
},
"张慧芬": {
"gender": "女",
"age": 48,
"variants": {
"默认": {
"prompt": "现代、48岁、女、短发烫卷/深棕色、浅蓝色护士上衣、白色裤子、白色护士鞋、无配饰、面容疲惫但温和,电影写实风格,高质量,真实光影,电影级打光,8K分辨率,超高清细节,全身,纯色背景,面向镜头",
"desc": "护士装"
}
}
}
},
"scenes": {
"医院普通病房": {
"variants": {
"白天": {
"prompt": "中国现代,电影写实风格,室内,白天,现代医院普通病房,白色墙面干净整洁,输液架立在病床旁,病床白色床单,窗户透入柔和自然光"
},
"深夜": {
"prompt": "中国现代,电影写实风格,室内,深夜,现代医院普通病房,白色墙面,走廊灯光透过门缝微弱照入,氛围安静压抑"
}
}
}
},
"props": {
"天机古卷": {
"prompt": "中国古代,电影写实风格,信物,泛黄卷边的线装书,封面为深蓝色布面,边角磨损严重,书页间夹有干枯的银杏叶书签,是主角被雷劈时的护身符,纸质(泛黄),封面深蓝色布面,书签枯黄色"
}
}
}
```
---
## ep{N}-prompt-package.json
单集完整提示词包。每个 shot 包含三个核心字段:`storyboard_prompt`(分镜图片)、`video_prompt`(视频)、`audio_spec`(音频)。
```json
{
"$schema": "drama-prompt-package-v1",
"episode": {
"number": 1,
"title": "天降奇才",
"shot_count": 15,
"characters_used": ["陈易", "张慧芬", "陈勇"],
"scenes_used": ["医院普通病房"]
},
"shots": [
{
"shot_id": "ep01_sh01",
"shot_number": 1,
"duration": "5s",
"script": {
"characters": [
{ "name": "陈勇", "variant": "默认" },
{ "name": "张慧芬", "variant": "默认" },
{ "name": "陈易", "variant": "觉醒前" }
],
"scene": "医院普通病房",
"scene_variant": "白天",
"shot_type": "近景",
"action": "画面右侧陈勇背影离去,张慧芬转身替病床上的陈易整理输液管,轻叹气",
"dialogue": {
"speaker": "张慧芬",
"text": "唉,陈易,你的医药费已经拖欠三天了...",
"emotion": "无奈叹息"
},
"source_anchor": "P-003"
},
"storyboard_prompt": "中国现代,医院普通病房,白色墙面,输液架,病床,柔和冷光,近景镜头(胸部以上),画面右侧陈勇背影离去,张慧芬转身替病床上的陈易(觉醒前)整理输液管,轻叹气,眼神略带无奈,写实风格,电影级打光,8K分辨率,超细节刻画",
"video_prompt": "场景为中国现代医院普通病房,白色墙面干净整洁,输液架立在病床旁,柔和冷光洒满房间。镜头从张慧芬(女)的近景开始,她站在病床边,目光望向画面右侧,陈勇(男)的背影正缓缓走出病房门口,写实风格,电影级打光。切镜到张慧芬(女)的近景(胸部以上),她收回目光转身面向病床上的陈易,双手轻柔整理输液管,轻叹气,嘴唇微动说着:\"唉,陈易,你的医药费已经拖欠三天了...\",眼神略带无奈,超细节刻画手部动作,8K分辨率。最后切镜到两人同框的中景,张慧芬(女)整理好输液管后低头看着陈易,病房里安静无声,氛围忧虑而沉重,无背景音乐。陈勇是男性,张慧芬是女性",
"audio_spec": {
"dialogue": {
"text": "唉,陈易,你的医药费已经拖欠三天了...",
"speaker": "张慧芬",
"speaker_gender": "female",
"emotion": "无奈叹息",
"voice_desc": "中年女性,声音疲惫温和,带叹息感,语速缓慢"
},
"sfx": [
{ "type": "脚步声远去", "timing": "陈勇离开时", "volume": "低" },
{ "type": "输液管碰撞", "timing": "张慧芬整理时", "volume": "轻微" }
],
"bgm": { "mood": "无", "note": "无背景音乐,安静压抑" }
}
},
{
"shot_id": "ep01_sh08",
"shot_number": 8,
"duration": "5s",
"script": {
"characters": [
{ "name": "林峰", "variant": "觉醒后" }
],
"scene": "世界杯决赛球场",
"scene_variant": "比赛中",
"shot_type": "近景",
"action": "林峰双手快速结印,张嘴向场内大吼,额头青筋暴起",
"dialogue": {
"speaker": "林峰",
"text": "赵小天!坎位七步,转身盲传!",
"emotion": "激动狂热"
},
"source_anchor": "P-042"
},
"storyboard_prompt": "中国现代,世界杯决赛球场,绿茵草地背景,球场灯光璀璨,观众席人山人海虚化,近景镜头,林峰(觉醒后),双手快速结印,张嘴向场内大吼,额头青筋暴起,眼神犀利望向球场中央,神情激动狂热,汗水飞溅,动态模糊感,高对比度光影,电影级质感,8K超高清,日系动漫风格,唯美画风",
"video_prompt": "场景为中国现代的世界杯决赛球场,绿茵草地在璀璨灯光下格外耀眼,背景中虚化的人山人海观众席沸腾喧嚣。镜头从林峰的中景开始,他觉醒后的神情狂热,猛地冲到球场边线,带起一阵破空呼啸声,汗水在剧烈运动中飞溅。切镜到林峰的面部特写,额头青筋暴起,眼神犀利如电死死盯着球场中央,双手快速结印,张嘴向场内大吼:\"赵小天!坎位七步,转身盲传!\"最后切镜到球场内视角的远景,林峰的身影在场边显得极具爆发力,高对比度光影下,整个画面充满紧张激烈的决战氛围。",
"audio_spec": {
"dialogue": {
"text": "赵小天!坎位七步,转身盲传!",
"speaker": "林峰",
"speaker_gender": "male",
"emotion": "激动狂热",
"voice_desc": "青年男性,嘶吼式呐喊,爆发力极强,带破音感"
},
"sfx": [
{ "type": "观众欢呼", "timing": "全程背景", "volume": "中" },
{ "type": "破空呼啸", "timing": "林峰冲到边线时", "volume": "强" }
],
"bgm": { "mood": "紧张激烈", "note": "快节奏电子鼓点,渐强到高潮" }
}
}
],
"diagnosis": {
"score": 87,
"passed": true
},
"continuity": {
"character_states": {
"陈易": { "variant_at_end": "觉醒前", "location": "医院病房" },
"林峰": { "variant_at_end": "觉醒后", "location": "球场" }
},
"next_episode_hook": "陈易在病床上突然睁开双眼,瞳孔中闪过金色光芒"
}
}
```
---
## 字段说明
### shot 核心三字段
| 字段 | 类型 | 说明 |
|------|------|------|
| `storyboard_prompt` | string | 分镜图片提示词。角色用名字引用。用于生成静态画面。 |
| `video_prompt` | string | 视频提示词。基于 storyboard_prompt 派生。包含动态描述+切镜+对白+性别。 |
| `audio_spec` | object | 音频描述。对白+音效+BGM。 |
### storyboard_prompt → video_prompt 的关系
```
storyboard_prompt: 静态画面描述
→ 角色用名字 → 生成工具匹配角色立绘 → 输出分镜图片
video_prompt: 动态叙事(基于 storyboard_prompt 派生)
→ 场景扩写 + 动作展开 + 切镜 + 对白 + 性别
→ 输入分镜图片 + video_prompt → 生成视频
两者的场景和角色必须完全对应。
```
---
## 外部消费示例
```python
import json
# 1. 加载项目清单
manifest = json.load(open("project-manifest.json"))
# 2. 生成角色参考图(项目初始化)
for name, char in manifest["characters"].items():
for variant, data in char["variants"].items():
img = generate_image(prompt=data["prompt"])
register_character(name=f"{name}({variant})", image=img)
# 3. 生成场景参考图
for name, scene in manifest["scenes"].items():
for variant, data in scene["variants"].items():
img = generate_image(prompt=data["prompt"])
register_scene(name=f"{name}_{variant}", image=img)
# 4. 生成道具参考图
for name, prop in manifest["props"].items():
img = generate_image(prompt=prop["prompt"])
register_prop(name=name, image=img)
# 5. 逐集逐镜头生成
package = json.load(open("ep01-prompt-package.json"))
for shot in package["shots"]:
# 5a. 用分镜提示词生成图片
# 提示词中的角色名字会匹配到已注册的角色参考图
storyboard_img = generate_image(
prompt=shot["storyboard_prompt"],
character_refs=get_refs(shot["script"]["characters"])
)
# 5b. 用分镜图片 + 视频提示词生成视频
# 分镜图片作为首帧,视频提示词指导动态展开
video = generate_video(
first_frame=storyboard_img,
prompt=shot["video_prompt"]
)
# 5c. 生成对白音频
if shot["audio_spec"]["dialogue"]:
d = shot["audio_spec"]["dialogue"]
audio = generate_tts(
text=d["text"],
voice_desc=d["voice_desc"],
emotion=d["emotion"]
)
# 5d. 合成
final = compose(video, audio, shot["audio_spec"]["sfx"], shot["audio_spec"]["bgm"])
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |