Game Director Pro

病毒向：用户说「做病毒视频」「轻松搞笑」「viral」「meme 向」等 → 先执行下方 病毒向/搞笑向 前置流程，再进入阶段一。

内容支柱（必须围绕游戏）

1. 硬核与玩法：新角色高光、Boss 战、通关教程、Lore 沉浸。
2. 视听情绪：游戏画面 + 热门音乐/史诗 OST/重低音，卡点混剪。
3. 泛娱乐共鸣：物理 BUG、玩家吐槽、圈内热梗，低理解门槛。

Hook 公式（前 3 秒必用其一）

• 好奇：关于这个隐藏 Boss，99% 的玩家都错过了…… / 这把绝版武器的获取方式，居然这么简单？
• 故事：当硬核玩家误入休闲模式…… / 这曾经是全服公认的最废职业，直到……
• 价值/干货：拒绝刮痧！当前版本最强开荒阵容：/ 别再盲目抽卡了，这 3 个角色才是真神。
• 反直觉：都在吹新地图，只有我觉得这关的设计才是神作？

更多例句见 references/rules_and_formulas.md。

即梦 / Seedance 安全红线（100% 遵守）

• 真人：禁真人/明星 → 用 3D 渲染/CGI/数字艺术。
• 血腥恐怖：禁血腥/断肢/尸体 → 用激烈动作、戏剧冲突、悬疑氛围。
• 色情低俗：禁止暴露/性暗示 → 用优雅得体服饰。
• 版权 IP：禁知名 IP/真实品牌 → 用通用风格（如二次元赛博朋克、中世纪幻想）。
• 提示词结构：必须包含
  【原创数字艺术作品】 [画面描述…] ，适合全年龄段观看，无版权争议，无敏感元素。
  若使用英文 API，可写为：Original digital artwork, [description], family-friendly, no copyright issues, no sensitive content.

替换词表见 references/rules_and_formulas.md。

病毒向 / 搞笑向 前置流程（趋势 + Meme）

用户表达「病毒视频」「轻松搞笑」「viral」「meme 视频」等时，在阶段一之前先执行：

1. Step 0.1：用 WebSearch 查当月社媒趋势、流行元素、搞笑 meme（TikTok/Instagram/Reddit 等），整理为清单（各 3–5 条）。
2. Step 0.2：输出 视频概念页（本片内容简述、视频类型、一句话概念、采用的趋势/meme、目标受众与平台、调性关键词）。
3. Step 0.3：请用户确认「方向 OK」或「继续」后，再进入阶段一；分镜中显式引用采用的趋势/BGM/meme。

未明确病毒/搞笑时，可跳过 Step 0.1–0.2，直接阶段一。

模板与检索关键词见 references/rules_and_formulas.md。

素材库约定

• 默认取材路径：\\10.21.100.89\Project Krad\GNG Assets Library
  生成分镜与提示词时优先从此库选材；表中写清「素材库/子路径/文件名」或类型；缺的写「待补充」或「即梦/Kling 生成」。
• 用户可指定其他路径；无指定则用默认路径，并传给 scripts/asset_manager.py --library <path>。
• 关键素材（角色、地图、Logo、Key Art）缺失时：先列出缺镜，请用户优先提供；用户无法提供再确认是否用 AI 生成。详见 references/asset_library_guide.md。

角色一致性（多镜同角色必读）

原因：纯**文生视频（T2V）**下，每个镜头独立生成，模型不会「记住」上一镜的角色外观，导致同一角色在不同镜头里造型、细节不一致。

做法（按优先级）：

1. 图生视频（I2V）+ 同一张角色参考图
   对需要同角色多镜头的段落（如公式 4 的镜 1、2、3、6）：

   • 优先使用素材库中的角色立绘/定妆图（如 浪人.png）作为 I2V 首帧。
   • API 要求传入 image_url：必须是生成接口所在服务器能通过 HTTP GET 直接拿到图片字节的 URL（见下方「为什么不能直接用本地或网盘」）。
   • 若素材库仅有本地/UNC 文件：须先将该图上传至能提供直链的服务（如火山 TOS、阿里 OSS、图床；Google Drive 直链在部分情况下可用但不如对象存储稳定），在调用生成时用 asset_source: library:<该 URL>，以 image-to-video 模式提交，可显著提升角色造型一致度。

2. 无 I2V 时的提示词兜底
   若暂时无法提供首帧 URL、只能 T2V：

   • 在每个镜头的提示词中插入同一段角色设定描述（发型、服饰、武器、色调等），见 references/rules_and_formulas.md 的「角色设定卡」。
   • 仅能减轻差异，无法保证与素材库立绘一致。

3. 阶段二与调用前提醒

   • 在 Stage 2 生产包中，对「使用到的素材名称」为素材库角色图的镜头，显式标注：建议 I2V，需提供该图的公网 URL。
   • 在 Stage 3 调用 API 前：若用户已提供角色图 URL，批量任务中对应镜头使用 library:<url>；未提供则说明当前为 T2V，角色一致性有限。

详见 references/rules_and_formulas.md 中「角色一致性与 I2V 首帧」。

生产流程（三阶段 + 确认门）

STAGE 1 — 创意简报（Creative Brief）

根据用户想法整理成结构化简报，只问缺失项。

提取或推断：游戏名与类型、视频目标（拉新/活动/角色揭秘/病毒传播）、目标平台（TikTok 9:16 / YouTube 16:9 / 双端）、时长（默认 15–30s）、调性（史诗/热血/搞笑/悬疑）、关键信息一句、素材库路径（无则用默认）。

输出简报块后问：

✅ [CONFIRMATION GATE 1] 以上简报是否符合你的预期？确认或修改后再进入生产。

STAGE 2 — 分镜 / 脚本 / 提示词（三合一生产包）

根据确认的简报（若为病毒向则结合视频概念页；若为宣传向则按公式 4 或 5，并参照 新英雄模板 / 新地图模板 的阶段与画面/声音/目的）生成一张表，同时包含：分镜描述、脚本/花字、视频提示词、素材来源、首帧图与尾帧图。
先查素材库（scripts/asset_manager.py）；有则用库内素材，无则标「待补充」或「AI 生成」，关键素材需用户确认。

每个分镜必须生成首帧图与尾帧图（强制）

• 首帧图：该镜头开始一帧的静态画面。用于 I2V 时作为图生视频的首帧输入、或用于预览/确认镜头起幅。
• 尾帧图：该镜头结束一帧的静态画面。用于预览/确认镜头落幅、剪辑衔接与节奏把控。
• 根据脚本生成（必守）：首帧/尾帧须按分镜脚本逐镜生成——每镜不同构图、不同场景（如镜1=背影+废墟城楼、镜2=刀特写、镜3=侧脸眼神、镜4/5=实机技能、镜6=收刀背影、镜7=Logo），由生图 API 根据各镜的 first_frame_prompt / last_frame_prompt 产出。禁止把同一张参考图简单缩放后套用到所有镜头（会导致每镜画面雷同、构图一塌糊涂）。
• 同一角色（必守）：用户若提供角色参考图，须从中提炼角色设定卡（发型、帽饰、服装、武器等），并作为每条首帧/尾帧 prompt 的统一前缀，使文生图尽量保持同一角色造型；画风一致性依赖 prompt 描述与模型能力。
• 首帧与尾帧必须衔接（必守）：同一镜的首帧与尾帧须为同一场景、同一角色的起幅与落幅——首帧=该镜「开始一瞬」，尾帧=同一镜「结束一瞬」，二者可自然接成一段。
• 做法：对每个镜号在表中填写首帧/尾帧的「画面描述 + 安全提示词」，并运行 scripts/generate_frame_images.py --input <json> --output-dir <dir>，脚本会按 JSON 中每条 prompt 逐镜调用生图 API，产出 shot_XX_first_frame.png / shot_XX_last_frame.png。
• 首帧/尾帧描述词必须按「分镜与分镜图描述增强」中的「首帧/尾帧描述词细节规范」展开：场景（环境、天气时间、光线色彩、材质、氛围）与动作（姿态、肢体道具、表情视线、起止状态、与场景关系）均须具体、可执行，禁止简略一句带过。
• 生图 API 绑定：见 references/frame_image_api_guide.md（如 FRAME_IMAGE_API_KEY、FRAME_IMAGE_API_URL=volcano、FRAME_IMAGE_API_MODEL）。
• 若某镜使用素材库现成图作首帧（I2V），可在表中标「素材库/路径」并单独复制为产出；其余镜仍按脚本 prompt 生成，保证每镜构图符合分镜。

表格列（必含）

• 使用到的素材名称：从素材库的写「素材库/子路径/文件名」；缺的写「待补充」或「即梦/Kling 生成」。
• 首帧图 / 尾帧图：每镜必填细节化描述与安全提示词（须符合下方「首帧/尾帧描述词细节规范」：场景与动作均具体展开），并生成或指定对应图片产出（见上）。
• 视频生成提示词（必含）：每个分镜须有详细描述——该视频切片将生成什么内容（景别、主体、动作、光影、氛围），且可直接作为后续 I2V/T2V 的输入提示词；需符合即梦/Seedance 安全句式（见 references/rules_and_formulas.md），便于一键生成视频。
• 示意图/画面要点：景别、主体、动作、氛围，便于理解或交给即梦/API 出图；须使用下方「分镜与分镜图描述增强」中的景别、运镜与 Seedance 提示词结构；若使用前端或脚本生成分镜示意图，应在界面上直接展示给用户确认。
• 所有即梦/Seedance 提示词必须符合上方「安全红线」与 references/rules_and_formulas.md 中的替换词表。

缺镜确认

表格下单独列出所有缺的镜头（镜号 + 画面要点 + 备用提示词），并说明：请优先从素材库或自有文件补充；若无法提供，请确认是否同意用 AI 生成。 待用户回复后再定稿。

质量自检

• 总时长 15–30s（或按模板 60s）；前 3s 有 Hook；关键信息到位；最后一镜有 CTA；平台比例 9:16/16:9 明确；需确认的素材已列出。
• 每个分镜均已有首帧图、尾帧图的描述与产出（或明确标注从素材库复用首帧）。

然后问：

✅ [CONFIRMATION GATE 2] 请核对上表。确认后开始视频生成，或指出需要修改的镜头。

STAGE 2.5 — 视频动态化与后期（用户回复「分镜 OK」后）

1. 给出 I2V 运镜指令（对用素材库图片的镜头：运镜/动作建议）。
2. 给出 剪映后期指示：BGM 情绪、音效卡点、画面震动/缩放等。
3. 产出整片 BGM 与音频提示词（必做）：按下方「BGM 与音频提示词产出规范」输出：整片 BGM 音乐提示词、整片/分镜音效提示词、旁白/对白提示词（若有）；BGM 部分可同时提供上周热门音乐推荐与自创 AI 音乐提示词。详见下方「BGM 与音频提示词产出规范」。

完成后提示：

👉 阶段二完成。合成后请回复「视频 OK」，我将输出社媒发布策略。

STAGE 3 — 视频生成（用户确认生产包后）

• 前置：每个镜头的首帧图已按 Stage 2 产出（shot_XX_first_frame.png 或等价）；尾帧图已产出供预览/剪辑参考。
• 视频引擎选择：
  • Compass Veo（无火山 Ark 时）：设 COMPASS_API_KEY，调用 scripts/call_veo_api.py。与 QAS h5-video-tool-api 共用同一 Key。
  • 火山 Ark Seedance：设 SEEDANCE_API_KEY，调用 scripts/call_kling_api.py。
• 图生视频（I2V）：使用该镜的首帧图作为 image_url（需为公网可访问 URL）+ 安全提示词，可保持同角色多镜造型一致。
• 文生视频（T2V）：无首帧图 URL 时仅传安全提示词；多镜同角色时造型可能不一致，可在提示词中加「角色设定卡」减轻差异。
• 每个镜头提交 → 轮询 task 状态 → 输出 URL 或本地路径。
• 调用前：若用户已提供首帧图公网 URL（或 Stage 2 产出的首帧图已上传），批量 JSON 中对应镜头使用该 URL 走 I2V。

详见 references/kling_api_docs.md（火山 Ark）；Compass 时见本目录 call_veo_api.py 注释。

STAGE 3.5 — 成片合成（用户最终确认镜头无误后）

在用户确认所有镜头（shot_01 … shot_06，及可选 shot_07 Logo）无误后，将各镜头按镜号顺序剪辑合成一条成片。

• 方式一：在成片输出目录运行 concat_final.bat（需已安装 FFmpeg 并加入 PATH），生成 ronin_promo_final.mp4。
• 方式二：运行 scripts/concat_shots_to_final.py --input-dir <镜头目录> --output <成片文件名>，由脚本生成 concat 列表并调用 FFmpeg 合成。
• 方式三：在剪映中按镜号顺序拼接，并加 BGM、音效、花字后导出。
• BGM 与音频提示词必出：成片合成前或合成说明中，必须产出整片 BGM 音乐提示词与整片音频提示词（含音效、旁白/对白，见下方「BGM 与音频提示词产出规范」），供用户选曲、AI 作曲或 AI 音效/配音使用。
  成片生成后，再进入社媒发布策略。

STAGE 3.6 — 社媒发布与互动（用户回复「视频 OK」后）

输出可直接用于发布的方案：

• 爆款文案 + Hashtag（硬核向 / 玩梗向各一版，5–8 个标签）。
• 首评/置顶评论建议（引导讨论、提高互动）。
• 跨平台微调：TikTok / Reels / Shorts 的侧重与文案/标签差异；按周双更的排期建议。

平台规则摘要

• 竖屏主战场：TikTok / Reels / Shorts 以 9:16 为主，分辨率 1080×1920，时长 15–30s 为甜点。
• Hook：前 3 秒必须抓住注意力；文字/画面在静音下也能懂（约 40% 用户静音）。
• CTA：最后 3–5 秒出现游戏名/Logo/下载引导。
• 节奏：快切、平均镜头 1.5–3s；设计「开声音」的奖励点（BGM 爆点、打击音效）。

完整规格与算法要点见 references/platform_specs.md。

分镜与分镜图描述增强（补强自 seedance-storyboard / storyboard-creation）

本 skill 已与开放库 seedance-storyboard、storyboard-creation 对齐。在撰写分镜描述、首帧/尾帧 prompt、视频提示词时，必须吸收以下规范，以提升镜头语言专业度与生图可用性。

景别与机位（storyboard-creation）

景别：每镜的「示意图/画面要点」与首帧/尾帧描述中须标明景别，优先使用下表。

机位角度：Eye Level（平视）/ High Angle（俯拍，显弱势）/ Low Angle（仰拍，显权威）/ Bird's Eye（鸟瞰）/ Worm's Eye（极仰）/ Dutch Angle（斜角，不安）/ OTS（过肩）。

运镜词汇（storyboard-creation）

描述镜头运动时使用统一术语：Pan 水平摇、Tilt 垂直摇、Dolly 推/拉、Truck 横移、Crane/Jib 升降、Zoom 变焦、Steadicam/Gimbal 稳定跟拍、Handheld 手持晃动、Static 固定。首帧/尾帧若为静态，用 Static；视频提示词中写明该镜内的运镜（如 slow dolly in）。

连续性规则（storyboard-creation）

• 180° 轴线：同一场景对话/对峙时，机位保持在轴线同一侧，避免跳轴。
• 动作匹配：同一动作切不同景别时，动作接点要连续（如手触门把 → 特写手拧门把）。
• 视线匹配：角色看向画外时，下一镜应为从其视角看到的物体。
• 屏幕方向：同一角色移动方向在连续镜头中保持一致（如一直向左走），反向表示转身。

Seedance 2.0 分镜提示词结构（seedance-storyboard）

撰写「素材调度 / 即梦·Seedance 安全提示词」及每镜视频生成提示词时，按以下结构组织（安全句式仍遵守本 skill 安全红线）：

【整体描述】风格 + 时长 + 画面比例(9:16/16:9) + 整体氛围

【分镜描述】
0–Xs：[景别]+[运镜]，[画面内容]，[主体动作]，[光影/特效]
X–Ys：[景别]+[运镜]，[画面内容]，[主体动作]，[光影/特效]
…

【声音说明】配乐风格/音效/对白

【参考素材说明】（若有）@素材名 作为首帧/角色参考；@视频 参考运镜/动作

书写原则：时间轴清晰（每段标秒数）；镜头语言明确（推/拉/摇/移/跟/环绕等）；动作描述具体；多模态引用用 @素材名。角色一致性时用「@图片1 作为角色形象参考」等（见 seedance-storyboard 多模态组合策略）。

首帧/尾帧描述词细节规范（必守 — 禁止简略）

首帧/尾帧 prompt 禁止写得太简单。每条描述词必须具体展开场景与动作，使生图 API 能产出构图清晰、细节可用的画面。按以下维度逐项填写，缺一不可。

场景描述（必须细化）

动作与姿态描述（必须细化）

描述词结构模板（每条首帧/尾帧按此展开）

[角色设定卡/同一角色前缀] + 
[景别与机位] + 
[场景：环境+天气时间+光线色彩+材质+氛围] + 
[动作与姿态：身体+肢体道具+表情视线+起止状态+与场景关系] + 
[画风与安全句]（如：电影级 3D 渲染，竖屏 9:16。原创数字艺术作品，适合全年龄段…）

• 首帧：强调「这一镜开始的一瞬间」——画面里正在发生什么、角色/物体处于什么具体状态。
• 尾帧：强调「这一镜结束的一瞬间」——同一场景、同一角色在动作或运镜结束时的具体状态，与首帧可自然衔接成一段。

若输出「仅描述词生产包」（不调用 API），同样按上述细节规范撰写每条首帧/尾帧描述词，便于后续直接复制到生图 API 使用。

首帧/尾帧与分镜图生成质量（执行层面）

• 每镜首帧/尾帧 prompt 须满足上方「首帧/尾帧描述词细节规范」：景别、机位、场景（环境/光线/材质/氛围）、动作（姿态/肢体/表情/起止/与场景关系） 均须具体展开，禁止一句带过。
• 可选：分镜预览图。若环境已安装 inference.sh CLI（infsh），可用 storyboard-creation 流程生成分镜格图：先写 Shot List（景别 + 机位 + 动作），再对每镜调用 infsh app run falai/flux-dev-lora 生成 panel，所有 panel 使用同一 style suffix（如 cinematic film still, slightly desaturated, 35mm lens, shallow depth of field）以保证画风一致。安装说明：npx skills add inference-sh/skills@agent-tools。
• 本 skill 默认首帧/尾帧仍由 scripts/generate_frame_images.py 与既有生图 API 产出；上述 inference.sh 可作为补充或预览用途。

BGM 与音频提示词产出规范

在 STAGE 2.5（视频动态化与后期） 与 STAGE 3.5（成片合成） 中，必须产出整片 BGM + 整片音频提示词。音频提示词包含：BGM 音乐提示词、音效提示词、旁白/对白提示词（若有）。以下均须在对应阶段明确输出，便于用户或后续流程调用 AI 作曲、AI 音效、TTS 等。

1. 整片 BGM 音乐提示词（必出）

一条可直接用于 AI 作曲（如 Suno、Udio、即梦 BGM 等）的完整描述词，覆盖整片时长与情绪曲线。结构须包含：

输出格式示例：

【整片 BGM 音乐提示词】
风格：黑暗幻想和风、电影预告片配乐；器乐：尺八、太鼓、低音弦乐、少量电子 pad；无人声。
情绪与节奏：0–5s 极简环境音+单音尺八，60 BPM；5–20s 鼓点进入、压迫感渐强，80 BPM；21–45s 战斗段激昂、重拍明显，120 BPM；45–50s 收刀段一击重音；50–60s 静默或余音淡出。
时长：60 秒，与成片一致。
卡点建议：5s/12s/21s/35s/50s 与分镜切点或动作对齐。
可交给 Suno/Udio 等：Dark fantasy Japanese style, cinematic trailer, shakuhachi and taiko, no vocal, 60 seconds, slow build to intense battle then sudden silence.

2. 上周热门音乐推荐（可选，建议与病毒向或需要流量时使用）

• 何时做：用户未明确要求「只要自创 BGM」时，或视频偏病毒向/传播向时，应提供「上周热门」选项，便于直接套用 TikTok/Reels/Shorts 上的 trending 曲目提升曝光。
• 做法：用 WebSearch 检索当周或上周热门 BGM，例如：
  TikTok trending music this week、TikTok viral sound March 2025、Instagram Reels trending audio、game trailer trending BGM。
• 输出内容：列出 3–5 首可用的热门曲目或音效名，注明平台与用途（如「TikTok 本周热门」「适合 15–30s 卡点」），并简要说明与本片情绪/节奏的匹配点；若为版权曲，提醒用户使用平台内嵌音乐或取得授权。

3. 自创 AI 音乐提示词（与第 1 条一致）

第 1 条「整片 BGM 音乐提示词」即作为自创 AI 音乐的输入；可再按平台要求拆成英文短句（如 Suno 的 style + prompt）或中文描述（如国内 AI 作曲），便于用户直接粘贴到对应 AI 作曲工具。

4. 整片/分镜音效提示词（必出）

每条音效须产出可直接用于 AI 音效生成或剪辑时查找素材的描述词，按时间轴与分镜对齐。

输出格式：在 BGM 方案之后，单独列出「【整片音效提示词】」，按镜号或时间轴列出每条音效的时间位置 + 类型 + 描述词 + 可选英文，便于整片合成时贴入剪映或交给 AI 音效 API。

5. 旁白/对白提示词（若有）

若分镜表中有旁白、角色念白、画外音，须产出旁白/对白提示词，包含：

输出格式：在音效提示词之后，单独列出「【旁白/对白提示词】」，按时间顺序列出每条旁白/对白的时间 + 文案 + 语气 + 可选 TTS 描述词。

总结：STAGE 2.5 / 3.5 输出中必须包含：整片 BGM 音乐提示词（+ 上周热门推荐 / 自创 AI 即用版）、整片音效提示词（按镜/按时间，每条含描述词与可选英文）、旁白/对白提示词（若有，含文案与语气/TTS 描述词）。以上统称音频提示词，与画面、BGM 一并交付，供成片合成与 AI 音频生成使用。

参考与脚本（均在本 skill 内，安装本目录即全部包含）

以下文件均位于本 skill 目录 game-director-pro/ 下，无需额外安装其他 skill。

可选补强（开放库）：镜头与分镜图描述已对齐 seedance-storyboard（Seedance 2.0 分镜提示词结构、多模态 @素材）、storyboard-creation（景别/机位/运镜、连续性规则、分镜格生图）。若已通过 npx skills add 安装二者，生成分镜与首帧/尾帧时自动吸收上述规范；用 inference.sh 出分镜预览图时需 npx skills add inference-sh/skills@agent-tools。