@gitruck/cli 1.0.1 → 1.0.2

package/skills/gtrk-ai-drama/SKILL.md

@@ -1,214 +1,221 @@
----
-name: gtrk-ai-drama
-description: AI 再现分镜稿生成器——把成片 SOP 第⑤步分到 AI_DRAMA 车道的 beat，逐个产**四段朴素描述（故事背景 / 角色 / 分镜 / 原文文稿）+ 独立视觉基调段 + 时长预算**，中英双版，可直接拿去任意外部 AI 漫剧管线（可灵 / 即梦 / Vidu / Veo / Runway / LTX / 本地开源，或 LibTV / OiiOii / TapNow 这类成片 agent 平台）上手用。这是**纯创作 skill、无 gtrk 命令**（产物即描述文本、出片在外部平台、用户手动拼回，同 /gtrk-style-maker）。当用户想「上 AI 再现 / 做 AI 分镜 / AI 动画描述 / 把这段做成 AI 视频 / 给这段配 AI 再现 / 弗洛伊德这段怎么做视频」时使用本 skill。通用拆镜 craft（蒙太奇段分层 / 四段描述结构 / 中英双语 / 时长预算）由本 skill 自持；栏目视觉 DNA（Style Lock）从栏目配置 style.skills 里 produces==AI_DRAMA 的条目解析注入，绝不硬编某栏目风格。凡把口播派单里 AI_DRAMA 段落转成可出片的描述稿，优先用本 skill，别手搓。
----
-
-# AI 再现分镜稿生成器（gtrk-ai-drama）
-
-把口播派单里分到 **`AI_DRAMA` 车道**的 beat，逐个拆成分镜、为每个 beat 产 **四段朴素描述 + 独立视觉基调 + 时长预算**（中英双版），落到 `<project>/ai-drama/<beat_id>.md`，再交棒用户拿去任意外部平台出片、手动拼回时间线。
-
-> **这是纯创作 skill、没有 gtrk 命令**——AI_DRAMA 车道的产物就是**描述文本本身**，出片在外部生成平台、拼回时间线由用户手动做，没有确定性机械尾巴可下沉成 CLI 命令（性质同 `/gtrk-style-maker`）。所以「脑」是你（拆镜 + 注入栏目风格 + 管用户交互），「手」在外部平台和用户手里，不是 gtrk。别去找 `gtrk ai-drama` 这条命令，它不存在也不该存在。
-
-## 为什么是「四段朴素描述」而不是「平台优化提示词」
-
-因为**责权利要清**：无论用户拿去哪个管线，一致性的可移植载体是**角色/场景描述**，不是某平台的提示词语法（"assets model-agnostic, prompts model-specific"）。而且下游 agent 成片平台（LibTV / OiiOii / TapNow 等）拿到分镜稿会**自己重拆分镜、重写 prompt**，角色圣经（三视图）也在那些产品里生成——所以本 skill **不产平台优化提示词、不产角色圣经、不产参考图、不产成片**，只产四段可移植描述 + 视觉基调 + 时长，把「怎么出片、怎么保角色一致」交给下游平台，把「拼回时间线」交给用户。
-
-## SOP 定位：第 ⑤ 步，最后上
-
-成片是**有序 SOP + 用户检查点**，不是并行一把铺。次序（有理由：越往后叠得越上层）：
-
-> ① oralcut 剪口播 → ② split 视觉拆分派单 → ③ **matrix 先铺 B-roll（定底层）** → 用户 opencut 调整/挑选确认 → ④ **mg 铺 MG（叠在 B-roll 之上）** → ⑤ **本 skill 上 AI 再现（叠在最上层）** → `gtrk render` 收口
-
-本 skill 是**第 ⑤ 步、最后一层视觉**。前面 B-roll、MG 都铺完、用户确认后才轮到它；它产完描述、用户拿去外部平台出片、AI 片段手动回铺齐，就该交给 `gtrk render` 出片——后面没有别的车道了。
-
-## 三条铁律（先记死）
-
-1. **业务分离：通用 craft 归本 skill，栏目风格从配置解析。** 本 skill 只持**对任何栏目都通用的拆镜工艺**（蒙太奇段分层、四段描述结构、中英双语、时长预算）。**栏目专属的视觉 DNA / Style Lock（底色、单点强调色、影视参考锚点、材质、禁令）从有效栏目配置解析注入**（见下节），**绝不硬编某栏目风格**——尤其别把《实在界漫游指南》那套「黑白二元 + 单点朱红」当默认塞给所有人，那是它的栏目资产，该从配置来。未绑 AI_DRAMA 风格资产的栏目 → 用本 skill 的**中性默认**兜底。
-2. **只产描述，不产成片、不产角色圣经、不产参考图。** 本 skill 的交付物是四段可移植描述文本。出片（渲染成视频片段）、角色三视图/角色圣经、参考图，全在下游平台或用户手里。不要假装能帮他渲染或建角色资产。
-3. **中英双版地位平等，不是主辅。** ①视觉基调、②故事背景、③角色、④分镜四段每一段都给完整的中文版 + 英文版（不是把中文翻一句了事）。中文喂可灵 / 即梦 / Vidu / 通义，英文喂 Veo / Runway / LTX / Luma，用户按目标平台选。**唯独 ⑤ 原文文稿是中文口播原文、不翻译**（它是源真相 + 手动拼接的对位锚，翻译反而失真）。
-
-> **产物落点纪律（MUST · 全文见随包 `AGENT.md` 同名一节）**：
-> 分镜稿只落**工程目录**（`<project>/ai-drama/<beat_id>.md`）或**用户显式指定处**；
-> **MUST NOT** 把用户媒体（毛片 / 成片 / 预览 / 外部平台出的片段）或任何大媒体文件复制到 agent 自有工作目录（如用户文档目录下 agent 产品自建的目录、agent 家目录缓存、会话工作区）——需要引用媒体时**用原路径引用**，不做副本；
-> 临时文件一律放系统 temp 且**用完即删**（含中断 / 失败路径）。违者后果 = 用户系统盘被静默吃满（真机事故，非假设）。
-
-## 业务分离：栏目 Style Lock 从哪来（关键）
-
-**视觉风格不是本 skill 预设的，是从栏目配置里解析出来的。** 解析链路（与 `gtrk-splitter` 的车道→生产 skill 解析同源）：
-
-1. **定位有效栏目**：用**与该工程 split 时相同的栏目**——用户 `--column <id>` 指定，或本地 config 的 `defaultColumn`；配置文件在 `~/.gitruck/columns/<id>.json`。本 skill 无 gtrk 命令，**直接读这个 JSON 文件**（同 `/gtrk-style-maker` 的做法）。
-2. **取 AI_DRAMA 生产条目**：读 `style.skills[]`，逐条把 `produces` **归一**（历史别名如 `RRV_MG→MG` 等按归一规则处理），取 `produces == "AI_DRAMA"` 的条目。
-   - 命中 → 拿它的 `ref`（指向一个 skill 目录/资源）→ **读该 skill 的 Style Lock / 风格资产**（通常是它 `references/` 下的 style-lock、theme-accent、影视参考锚点等），把其中的**底色 / 单点强调色 / 影视参考 / 材质 / 栏目禁令**当作本次生成的视觉 DNA，注入 ①视觉基调段与各描述。
-   - 条目声明 `routing:"none"` → 跳过（显式管线外）。
-   - **无 AI_DRAMA 匹配条目 = 该栏目没绑 AI 再现风格资产** → 用下面「中性默认」。
-3. **注入，不臆造**：读到什么风格资产就用什么；**没读到就用中性默认，绝不凭栏目名猜风格、绝不套用别的栏目的调性**。
-
-> 举例（仅示意解析机制，非硬编）：`real-roam-guide` 栏目配置里 `style.skills` 有一条 `{produces:"AI_DRAMA", ref:"…/ai-drama-prompter"}` → 解析到它 → 读它的 style-lock（黑白单红那套）注入。换个栏目、换个 ref，注入的就是另一套风格。**本 skill 正文里不写死任何一套具体风格。**
-
-## 前置与输入
-
-- **需要一个 split 落地过的工程目录**：里面有 `split/dispatch.json`（`gtrk split` 产物）。没有 → 先回 `/gtrk-splitter` 拆分派单。
-- **消费 `dispatch.ai_drama[]`**：读 `<project>/split/dispatch.json` 的 `ai_drama` 数组。每条形如 `{beat, narrative?, theme?, emotion_stage?, platform?, shot_count?, track_st, track_ed}`：
-  - `narrative / theme / emotion_stage / platform / shot_count` **全可选**，缺则按文稿内容与位置**推断**（推断出的值在元信息处标注「推断」）。
-  - `track_st / track_ed` = 该 beat 在时间线上的起止秒，**给你时长预算**（据此定区间总时长、蒙太奇段数、各镜建议秒数；本 skill 不改时码、只读）。
-- **也接单段直投**：用户直接甩一段文稿 + 「把这段做成 AI 视频」时，无需 dispatch，把这段当一个 beat 走同一套工艺即可（落用户指定处或 `<cwd>/ai-drama/<自拟标题>.md`）。
-- **文稿内容从哪读**：dispatch 条目带 `beat` id，对应文稿去投影视图 / transcript 里按该 beat 的 span 读原文（读懂内容拆镜、并抄进 ⑤ 原文文稿区块）。用户直投时用他给的文本。
-
-## 通用 craft（本 skill 自持，任何栏目通用）
-
-### A. 蒙太奇段分层拆镜
-
-1. **1 镜 = 1 情感颗粒**：同一个动作不切两镜；情绪转折必须切镜。
-2. **每镜 3–8 秒**：短于 3 秒观众来不及呼吸；长于 8 秒 AI 视频模型会塌（人物表情 / 手部漂移）。
-3. **长文段拆蒙太奇段**：一个 AI_DRAMA beat 可能覆盖很长一段文稿、含多个场景/情境。此时**先拆蒙太奇段**（每段锚一个场景/情境），**段内 3–6 镜**按情感颗粒切、**段间可换场**。镜数上限按**段级**判定，**不再因整段总镜数超 6 就回退 splitter**——长区间整段做 AI 再现是合法创作，不是拆分错误。
-4. **切分触发器**（任一出现才考虑切）：时间 / 空间改变、主体改变（例：理论家 → 当事人）、抽象概念登场（从「人物戏」切到「象征物戏」）、情绪转折（安静→刺点 / 爆发→凝滞）。**不要因一个句号、一个逗号就切。**
-5. **控整体不控单镜**：你对**区间总时长**负责（各镜建议秒数之和量级贴合 `track_st→track_ed`），但不必把每一镜的秒数抠死——AI 平台交付本就不保证逐帧准，最终由用户手动拼时对齐区间。
-
-### B. 视觉基调：独立成段 + 融入各描述（一源多处）
-
-视觉基调**既独立成段（作权威源），又融入各描述（防漂）**：
-
-- **① 独立段（权威源）**：把解析到的栏目 Style Lock 写成完整一段（底色 / 中性调 / 单点强调色 / 材质 / 影视参考 / 禁忌），60–120 字/词，CN + EN。这是权威源，供各分镜复述。
-- **融入 ② 故事背景**：末句锁整段色调（「整段以……色彩与质感呈现」）。
-- **融入 ③ 角色**：每角色一句质感落点（他在这套调子里长什么样、那点单点强调色落在哪个道具上——书脊 / 印章 / 丝带 / 封蜡，别做成环境光 / 滤镜 / 背景色）。
-- **融入 ④ 分镜**：**每镜前缀复述一句**视觉基调（AI 视频模型健忘，不复述必漂色）。
-
-### C. 中英双版结构（中英分离落盘 + EN 的强制调整）
-
-**中英分块、不逐段交错**：产物分成两大块——先一整块**中文稿**（元信息 + ①②③④ 中文 + ⑤ 原文文稿），再一整块 **English Storyboard**（① Style Lock + ②③④ 英文）。这样用户按目标平台**整块复制**：中文平台（可灵 / 即梦 / Vidu / 通义）拷中文稿、英文平台（Veo / Runway / LTX / Luma）拷英文稿，不用逐行挑出中/英。**别在每个小节里 `【中文】…【EN】…` 交错**（那样复制粘贴要一句句抠）。
-
-英文块不是直译，要做这些原生化：
-- **摄影术语用英文原生词**：push-in / dolly-in、pull-back、tilt-up、lateral pan、rack focus、chiaroscuro、key/fill/rim light、practical light；景别 extreme close-up … extreme wide；焦段 35mm anamorphic / 50mm spherical / 85mm portrait。
-- **年份用英文格式**：`Vienna, 1920`，不是 `1920 年维也纳`。
-- **人名用英文原名**：`Sigmund Freud` / `Lacan`，不是拼音。
-- **影视参考用英文片名**（斜体）。
-- **⑤ 原文文稿只在中文稿里、不翻译**：逐句列中文口播原文即可，英文块不含它。
-- **元信息只写一次**（放最前），中英两块不重复；每镜的「建议秒数 / 段 / 场景 / 角色 / 对应原文句」表头行在中/英两块各写各自语言的一份。
-
-### D. 时长预算
-
-- **元信息给区间总时长**：`track_ed - track_st`，据此定蒙太奇段数与建议分镜数。
-- **④ 每镜给建议秒数**：各镜秒数之和量级贴合区间总时长。
-- **定位：意图值，不是精确交付保证**。多数平台由参数控时且不保证逐帧精确（各平台 fps 也不一），提示里写死秒数无用；把时长放**元信息 + 每镜建议秒数**，最终对齐在用户手动拼接那一步完成。
-- **时码只读不改**：本 skill 不写回 dispatch / struct_meta，只读 `track_st/track_ed`。
-
-## 工作流
-
-**Step 1 · 通读该 beat 文稿**：判有无历史/时代锚点（年份 / 地点 / 人物 / 事件）、主体是谁、情感落点在哪、叙事功能与阶段。dispatch 缺的参数在此推断并标注「推断」。
-
-**Step 2 · 拆蒙太奇段与镜**：按 craft A 判是否长文段需分蒙太奇段，段内按情感颗粒切镜，定各段镜数（文稿长度 × track 时长双校准）。
-
-**Step 3 · 锁风格**：按「业务分离」节解析栏目 Style Lock（读配置 → 取 produces==AI_DRAMA 条目 → 读其风格资产）；无则取中性默认。组装成 60–120 字/词的 CN + EN 双语 ①视觉基调段。
-
-**Step 4 · 写四段描述（中英分块）**：先出**中文稿**（② 故事背景末句锁调 → ③ 角色结构化 + 禁变项 + 质感落点，复现理论家 pin 复用同段文字 → ④ 分镜每镜前缀复述基调 + 建议秒数 + 对应原文句 + 蒙太奇级意图 → ⑤ 原文文稿中文逐句不翻译），再整块出 **English Storyboard**（① Style Lock + ②③④ 英文原生化，不含 ⑤）。中英**分两大块、不逐段交错**（craft C）。
-
-**Step 5 · 落盘**：写到 `<project>/ai-drama/<beat_id>.md`（一 beat 一文件，靠 beat id 认得是哪段、互不覆盖）。用户直投单段时落到用户指定处或 `<cwd>/ai-drama/<自拟标题>.md`。
-
-## 输出契约（落盘 Markdown 结构 · 中英分块）
-
-顶部放一次责权利声明 + 元信息（不分语言）；然后 **`## 一、中文稿`** 一整块、**`## 二、English Storyboard`** 一整块，用户整块复制。
-
-```
-# AI 再现分镜稿 · [自动标题]（beat <beat_id>）
-
-> [责权利声明：本稿只描述意图与时长；角色一致性依赖下游角色资产机制；出片/拼回在用户手里]
-
-## 元信息
-- 区间总时长：track_st→track_ed ≈ X 秒
-- 建议分镜数：N 镜（含 M 个蒙太奇段）
-- 复现角色：<角色名>（栏目级·pin 复用 / 本片新建）…
-- 叙事功能 / 情感阶段：xxx（用户指定 / 推断）
-- 目标平台：xxx（缺省 = 通用）
-
-======================================================================
-## 一、中文稿（喂可灵 / 即梦 / Vidu / 通义）
-======================================================================
-
-### ① 视觉基调（Style Lock）
-> 权威源，供各分镜前缀复述。来源：<解析到的 ref skill> / 中性默认
-[底色 / 中性调 / 单点强调色 / 材质 / 影视参考，60–120 字]
-> 禁忌：[通用 AI slop 兜底 + 栏目专属禁令]
-
-### ② 故事背景描述
-[时代 / 地点 / 世界观 / 场景。末句锁调：整段以……色彩与质感呈现。]
-
-### ③ 角色描述
-#### <角色名>（栏目级·pin / 本片新建）
-脸型 / 发型 / 瞳色 / 服装 / 标志物 + 禁变项（不留长发、不换西装…）+ 一句质感落点。
-
-### ④ 分镜描述
-#### 分镜 01 · [标题] ｜建议 ≈Xs ｜段：<蒙太奇段名> ｜场景：xxx ｜角色：xxx ｜对应原文：第 a–b 句
-〔视觉基调前缀复述一句〕+ 主体在做什么具体动作 + 蒙太奇级镜头意图（不逐帧硬控）。
-#### 分镜 02 · …
-
-### ⑤ 原文文稿（本区间口播原文，不翻译）
-1. [第一句中文原文]
-2. [第二句中文原文]
-…
-
-======================================================================
-## 二、English Storyboard (for Veo / Runway / LTX / Luma)
-======================================================================
-
-### ① Visual Tone (Style Lock)
-> Authoritative source; restated as a prefix in every shot. Source: <resolved ref skill> / neutral default
-[palette / neutrals / single accent / texture / film references]
-> Avoid: [generic AI slop floor + column-specific bans]
-
-### ② Background
-[era / place / world / setting. Closing line locks palette & texture.]
-
-### ③ Characters
-#### <name> (column-pinned / new to this film)
-face / hair / eyes / wardrobe / signature prop + do-not-change + one line on how they render in the tone.
-
-### ④ Shots
-#### Shot 01 · [title] ｜≈Xs ｜segment: <montage segment> ｜scene: xxx ｜cast: xxx ｜source lines: a–b
-〔restate style prefix〕+ subject's concrete action + shot intent (montage-level, not frame-locked).
-#### Shot 02 · …
-```
-
-> ⑤ 原文文稿只在中文稿里；English 块到 ④ Shots 为止。
-
-## 中性默认（未绑 AI_DRAMA 风格资产时）
-
-栏目配置里**没有 produces==AI_DRAMA 的条目**时，别停、别硬套别的栏目，用这套克制、通用、不特化任何栏目的兜底写 ①视觉基调段：
-
-> **中性 Style Lock**：影视级自然主义画面，真实可信的光源（窗光 / 实用光 / 自然天光，不炫技），克制稳定的镜头语言（固定或缓慢推拉摇，无手持抖动 / 无广告级动态运镜 / 无无人机炫技），近单色到低饱和的克制调色（不追 HDR、不追霓虹），胶片颗粒质感。忌塑料 3D 渲染、忌动漫二次元、忌过度戏剧化打光。
-> **EN**: Cinematic naturalism, believable practical light sources (window / practical / natural daylight, no showing off), restrained stable camera language (locked or slow dolly/pan/tilt, no handheld shake, no ad-grade dynamic moves, no drone stunts), near-monochrome to low-saturation restrained grade (no HDR, no neon), visible film grain. Avoid plastic 3D render, anime, and over-dramatic lighting.
-
-中性默认下**不设单点强调色 / 不指定影视导演锚点**（那些是栏目资产）。用完顺带提醒用户：**想要这条栏目有自己的 AI 再现视觉 DNA，去 `/gtrk-style-maker` 沉淀一套 AI_DRAMA 风格资产并登记进 `style.skills`**，之后每次生成都会自动注入。
-
-**禁忌行**（写进 ①）分两层：
-- **通用 AI slop 兜底（本 skill 自带，任何栏目都写）**：glossy 3D render / plastic skin、HDR look / oversaturated、generic AI anime / saccharine、deformed face / extra fingers / mutated limbs、text overlay / captions / 字幕（字幕剪辑阶段另做）、heavy lens flare / chromatic aberration、cartoon / low-res / unfinished。
-- **栏目专属禁令（从 Style Lock 追加）**：栏目风格资产里写明的禁令（如某栏目「禁多个红点 / 禁渐变 / 禁霓虹」）追加进来。无风格资产则只留通用兜底。
-
-## 责权利边界声明（写进产物顶部或末尾）
-
-产物要**显式声明责权利**，让用户拿去任何管线都心里有数：
-
-> **本稿只描述意图与时长。** 角色一致性依赖**下游管线自带的角色资产 / 参考图机制**（角色圣经 / 三视图在下游产品里生成）——把本稿的角色描述喂给有角色资产库的平台（可灵主体库 / OiiOii 角色设定表 / LTX Elements / LibTV 三视图 等），一致性由它保。若喂给**没有角色资产机制的裸文生视频 API**，角色会逐镜漂脸——那是该管线的短板，不是本稿的责任。出片、拼回时间线，都在你手里。
-
-## 交付前自检
-
-- [ ] 五区块齐备（元信息 + ①视觉基调 + ②故事背景 + ③角色 + ④分镜 + ⑤原文文稿）？
-- [ ] 每镜有**明确主语 + 明确动作**？（没有就退回）
-- [ ] 是**真的按情感颗粒切镜**，不是按句号切？长文段拆了**蒙太奇段**、段内 3–6 镜、段划分合理？
-- [ ] 视觉基调**独立成段（权威源）**，且**每镜前缀都复述**、②末句锁调、③每角色一句质感落点？
-- [ ] 中英双版范围对：①②③④ 都双写、**⑤ 原文中文不翻译**？EN 做了原生化（术语 / 年份 / 人名 / 片名）？
-- [ ] 底色 / 强调色 / 影视参考**取自栏目 Style Lock**（或明确用了中性默认），**没有硬编某栏目风格**？强调色**是道具化**（不是环境光 / 滤镜）？
-- [ ] 时长预算入元信息（区间总时长 + 建议镜数）、每镜有**建议秒数**、各镜之和量级贴合区间？
-- [ ] 禁忌行含**通用 slop 兜底**（无论栏目）+ 栏目专属禁令（有资产才加）？分镜区块内没有每镜独立负面词组？
-- [ ] 复现的理论家标了 **pin·同段文字复用**、含**禁变项**？
-- [ ] 缺省参数都**标了「推断」**、落盘文件名带 beat id、责权利边界声明在？
-
-## 交棒下一步（SOP 收口，别停在交描述）
-
-描述稿落盘后**别收工**，把接力讲清（但这一步的「手」在外部平台和用户手里、必须停下等用户）：
-
-1. **交代出片**：让用户拿 `<project>/ai-drama/<beat_id>.md` 里的描述，去任意外部平台出片——中文版喂可灵 / 即梦 / Vidu；英文版喂 Veo / Runway / LTX / Luma；本地开源（Wan / Hunyuan 等）或成片 agent 平台（LibTV / OiiOii / TapNow）皆可，按下游平台的角色资产机制上传角色描述保一致。
-2. **回铺时间线**：出好的 AI 片段**由用户手动**拖回 opencut 的 **AI_DRAMA 车道**，对齐该 beat 的 `track_st→track_ed`（叠在 B-roll / MG 之上，最上层），按区间总时长裁齐。
-3. **停下等用户**：AI 出片与拼回是**外部异步、用户驱动**的——本 skill 在此停，等所有 AI_DRAMA beat 的片段都回铺齐。这是 SOP 里的用户检查点，别替他假装出片 / 回轨完成。
-4. **汇合后收口**：所有车道（B-roll / MG / AI 再现）铺齐、用户确认后，**交棒 `gtrk render`** 出成片——AI 再现是最后一层视觉，render 之后成片一条龙就到终点了。
-
-> 原则：**agent 替用户跑 CLI / 接力 skill，用户只对话**。但 AI_DRAMA 车道天然有「用户去外部平台出片 + 手动拼回」的手工环节——那部分是外部的手，无法替跑；除此之外的解析、生成、落盘、交代，全由你（脑）一次做完，别让用户自己去拼描述。
+---
+name: gtrk-ai-drama
+description: AI 再现分镜稿生成器——把成片 SOP 第③步（B-roll 底轨阶段）分到 AI_DRAMA 车道的 beat，逐个产**四段朴素描述（故事背景 / 角色 / 分镜 / 原文文稿）+ 独立视觉基调段 + 时长预算**，中英双版，可直接拿去任意外部 AI 漫剧管线（可灵 / 即梦 / Vidu / Veo / Runway / LTX / 本地开源，或 LibTV / OiiOii / TapNow 这类成片 agent 平台）上手用。这是**纯创作 skill、无 gtrk 命令**（产物即描述文本、出片在外部平台、用户手动拼回，同 /gtrk-style-maker）。当用户想「上 AI 再现 / 做 AI 分镜 / AI 动画描述 / 把这段做成 AI 视频 / 给这段配 AI 再现 / 弗洛伊德这段怎么做视频」时使用本 skill。通用拆镜 craft（蒙太奇段分层 / 四段描述结构 / 中英双语 / 时长预算）由本 skill 自持；栏目视觉 DNA（Style Lock）从栏目配置 style.skills 里 produces==AI_DRAMA 的条目解析注入，绝不硬编某栏目风格。凡把口播派单里 AI_DRAMA 段落转成可出片的描述稿，优先用本 skill，别手搓。
+---
+
+# AI 再现分镜稿生成器（gtrk-ai-drama）
+
+把口播派单里分到 **`AI_DRAMA` 车道**的 beat，逐个拆成分镜、为每个 beat 产 **四段朴素描述 + 独立视觉基调 + 时长预算**（中英双版），落到 `<project>/ai-drama/<beat_id>.md`，再交棒用户拿去任意外部平台出片、手动拼回时间线。
+
+> **这是纯创作 skill、没有 gtrk 命令**——AI_DRAMA 车道的产物就是**描述文本本身**，出片在外部生成平台、拼回时间线由用户手动做，没有确定性机械尾巴可下沉成 CLI 命令（性质同 `/gtrk-style-maker`）。所以「脑」是你（拆镜 + 注入栏目风格 + 管用户交互），「手」在外部平台和用户手里，不是 gtrk。别去找 `gtrk ai-drama` 这条命令，它不存在也不该存在。
+
+## 为什么是「四段朴素描述」而不是「平台优化提示词」
+
+因为**责权利要清**：无论用户拿去哪个管线，一致性的可移植载体是**角色/场景描述**，不是某平台的提示词语法（"assets model-agnostic, prompts model-specific"）。而且下游 agent 成片平台（LibTV / OiiOii / TapNow 等）拿到分镜稿会**自己重拆分镜、重写 prompt**，角色圣经（三视图）也在那些产品里生成——所以本 skill **不产平台优化提示词、不产角色圣经、不产参考图、不产成片**，只产四段可移植描述 + 视觉基调 + 时长，把「怎么出片、怎么保角色一致」交给下游平台，把「拼回时间线」交给用户。
+
+## SOP 定位：第 ③ 步 · B-roll 底轨阶段的 AI 情景片段腿（**不是最后**）
+
+成片是**有序 SOP + 用户检查点**，不是并行一把铺。次序：
+
+> ① oralcut 剪口播 → ② split 视觉拆分派单 → ③ **B-roll 底轨全铺齐**（`matrix` 铺影视/本地素材 + **本 skill 产稿→外部出片→用户手动回铺**，**两条腿同一阶段**）→ ④ **全局抽帧检查画面构图**（用户确认）→ ⑤ **mg 铺 MG（含 ov，最后叠上）** → `gtrk render` 收口
+
+**你与 `matrix` 同属第 ③ 步，MUST 在 MG 之前落位。** 理由：**AI 情景片段属于底轨 B-roll 画面家族，不是叠加层**——整条管线里唯一的叠加层是 MG（含 ov）。MG 的排版决策是「因势象形避主体」、**依赖底轨的最终画面构图**；若你的片段在 MG 之后才回铺，底轨构图就变了，先产的 MG 是对着「还没有 AI 画面的底轨」做的避让，你的片段落位后必然被避让错位、甚至被 MG 盖住画面主体。
+
+> ⚠️ **本节旧口径是错的，已于 2026-08-17 纠正**：旧文写「第 ⑤ 步、最后一层视觉，越往后叠得越上层」——**那是把「工序次序」误当成了「图层次序」**。工序上你必须先落位；图层上你本来就在底轨、从来不是「最上层」。若你在别处读到「AI 再现最后上」的表述，以本节为准。
+
+**异步等待的口子（你造成的那个）**：你产完描述后，用户要去外部平台出片、抽卡可能数天。严格串行会把 ④⑤ 无限期卡住，故约定：进 ⑤ 的硬门是「**AI 片段已回铺 ∨ 用户明示先跳过**」。走「明示跳过」时，下游 `/gtrk-mg` MUST 把与你的 beat 相邻/重叠区间的 MG 颗粒标记为「AI 回铺后待复查构图」并在收口时复述——**你在交代进度时也要把这个代价说清**，让用户知道跳过意味着将来可能返工那几颗。
+
+**你的下一步**：产完描述 → 用户拿去外部平台出片 → 手动回铺进工程 → 三源齐了进 **④ 全局抽帧检查构图**（对最终底轨抽帧、用户确认）→ 过了才交棒 ⑤ `/gtrk-mg`。**MUST NOT 直接从你这里跳到 `render`** ——后面还有构图检查与 MG 两步。
+
+## 三条铁律（先记死）
+
+1. **业务分离：通用 craft 归本 skill，栏目风格从配置解析。** 本 skill 只持**对任何栏目都通用的拆镜工艺**（蒙太奇段分层、四段描述结构、中英双语、时长预算）。**栏目专属的视觉 DNA / Style Lock（底色、单点强调色、影视参考锚点、材质、禁令）从有效栏目配置解析注入**（见下节），**绝不硬编某栏目风格**——尤其别把《实在界漫游指南》那套「黑白二元 + 单点朱红」当默认塞给所有人，那是它的栏目资产，该从配置来。未绑 AI_DRAMA 风格资产的栏目 → 用本 skill 的**中性默认**兜底。
+2. **只产描述，不产成片、不产角色圣经、不产参考图。** 本 skill 的交付物是四段可移植描述文本。出片（渲染成视频片段）、角色三视图/角色圣经、参考图，全在下游平台或用户手里。不要假装能帮他渲染或建角色资产。
+3. **中英双版地位平等，不是主辅。** ①视觉基调、②故事背景、③角色、④分镜四段每一段都给完整的中文版 + 英文版（不是把中文翻一句了事）。中文喂可灵 / 即梦 / Vidu / 通义，英文喂 Veo / Runway / LTX / Luma，用户按目标平台选。**唯独 ⑤ 原文文稿是中文口播原文、不翻译**（它是源真相 + 手动拼接的对位锚，翻译反而失真）。
+
+> **产物落点纪律（MUST · 全文见随包 `AGENT.md` 同名一节）**：
+> 分镜稿只落**工程目录**（`<project>/ai-drama/<beat_id>.md`）或**用户显式指定处**；
+> **MUST NOT** 把用户媒体（毛片 / 成片 / 预览 / 外部平台出的片段）或任何大媒体文件复制到 agent 自有工作目录（如用户文档目录下 agent 产品自建的目录、agent 家目录缓存、会话工作区）——需要引用媒体时**用原路径引用**，不做副本；
+> 临时文件一律放系统 temp 且**用完即删**（含中断 / 失败路径）。违者后果 = 用户系统盘被静默吃满（真机事故，非假设）。
+
+## 业务分离：栏目 Style Lock 从哪来（关键）
+
+**视觉风格不是本 skill 预设的，是从栏目配置里解析出来的。** 解析链路（与 `gtrk-splitter` 的车道→生产 skill 解析同源）：
+
+1. **定位有效栏目**：用**与该工程 split 时相同的栏目**——用户 `--column <id>` 指定，或本地 config 的 `defaultColumn`；配置文件在 `~/.gitruck/columns/<id>.json`。本 skill 无 gtrk 命令，**直接读这个 JSON 文件**（同 `/gtrk-style-maker` 的做法）。
+2. **取 AI_DRAMA 生产条目**：读 `style.skills[]`，逐条把 `produces` **归一**（历史别名如 `RRV_MG→MG` 等按归一规则处理），取 `produces == "AI_DRAMA"` 的条目。
+   - 命中 → 拿它的 `ref`（指向一个 skill 目录/资源）→ **读该 skill 的 Style Lock / 风格资产**（通常是它 `references/` 下的 style-lock、theme-accent、影视参考锚点等），把其中的**底色 / 单点强调色 / 影视参考 / 材质 / 栏目禁令**当作本次生成的视觉 DNA，注入 ①视觉基调段与各描述。
+   - 条目声明 `routing:"none"` → 跳过（显式管线外）。
+   - **无 AI_DRAMA 匹配条目 = 该栏目没绑 AI 再现风格资产** → 用下面「中性默认」。
+3. **注入，不臆造**：读到什么风格资产就用什么；**没读到就用中性默认，绝不凭栏目名猜风格、绝不套用别的栏目的调性**。
+
+> 举例（仅示意解析机制，非硬编）：`real-roam-guide` 栏目配置里 `style.skills` 有一条 `{produces:"AI_DRAMA", ref:"…/ai-drama-prompter"}` → 解析到它 → 读它的 style-lock（黑白单红那套）注入。换个栏目、换个 ref，注入的就是另一套风格。**本 skill 正文里不写死任何一套具体风格。**
+
+## 前置与输入
+
+- **需要一个 split 落地过的工程目录**：里面有 `split/dispatch.json`（`gtrk split` 产物）。没有 → 先回 `/gtrk-splitter` 拆分派单。
+- **消费 `dispatch.ai_drama[]`**：读 `<project>/split/dispatch.json` 的 `ai_drama` 数组。每条形如 `{beat, narrative?, theme?, emotion_stage?, platform?, shot_count?, track_st, track_ed}`：
+  - `narrative / theme / emotion_stage / platform / shot_count` **全可选**，缺则按文稿内容与位置**推断**（推断出的值在元信息处标注「推断」）。
+  - `track_st / track_ed` = 该 beat 在时间线上的起止秒，**给你时长预算**（据此定区间总时长、蒙太奇段数、各镜建议秒数；本 skill 不改时码、只读）。
+- **也接单段直投**：用户直接甩一段文稿 + 「把这段做成 AI 视频」时，无需 dispatch，把这段当一个 beat 走同一套工艺即可（落用户指定处或 `<cwd>/ai-drama/<自拟标题>.md`）。
+- **文稿内容从哪读**：dispatch 条目带 `beat` id，对应文稿去投影视图 / transcript 里按该 beat 的 span 读原文（读懂内容拆镜、并抄进 ⑤ 原文文稿区块）。用户直投时用他给的文本。
+
+## 通用 craft（本 skill 自持，任何栏目通用）
+
+### A. 蒙太奇段分层拆镜
+
+1. **1 镜 = 1 情感颗粒**：同一个动作不切两镜；情绪转折必须切镜。
+2. **每镜 3–8 秒**：短于 3 秒观众来不及呼吸；长于 8 秒 AI 视频模型会塌（人物表情 / 手部漂移）。
+3. **长文段拆蒙太奇段**：一个 AI_DRAMA beat 可能覆盖很长一段文稿、含多个场景/情境。此时**先拆蒙太奇段**（每段锚一个场景/情境），**段内 3–6 镜**按情感颗粒切、**段间可换场**。镜数上限按**段级**判定，**不再因整段总镜数超 6 就回退 splitter**——长区间整段做 AI 再现是合法创作，不是拆分错误。
+4. **切分触发器**（任一出现才考虑切）：时间 / 空间改变、主体改变（例：理论家 → 当事人）、抽象概念登场（从「人物戏」切到「象征物戏」）、情绪转折（安静→刺点 / 爆发→凝滞）。**不要因一个句号、一个逗号就切。**
+5. **控整体不控单镜**：你对**区间总时长**负责（各镜建议秒数之和量级贴合 `track_st→track_ed`），但不必把每一镜的秒数抠死——AI 平台交付本就不保证逐帧准，最终由用户手动拼时对齐区间。
+
+### B. 视觉基调：独立成段 + 融入各描述（一源多处）
+
+视觉基调**既独立成段（作权威源），又融入各描述（防漂）**：
+
+- **① 独立段（权威源）**：把解析到的栏目 Style Lock 写成完整一段（底色 / 中性调 / 单点强调色 / 材质 / 影视参考 / 禁忌），60–120 字/词，CN + EN。这是权威源，供各分镜复述。
+- **融入 ② 故事背景**：末句锁整段色调（「整段以……色彩与质感呈现」）。
+- **融入 ③ 角色**：每角色一句质感落点（他在这套调子里长什么样、那点单点强调色落在哪个道具上——书脊 / 印章 / 丝带 / 封蜡，别做成环境光 / 滤镜 / 背景色）。
+- **融入 ④ 分镜**：**每镜前缀复述一句**视觉基调（AI 视频模型健忘，不复述必漂色）。
+
+### C. 中英双版结构（中英分离落盘 + EN 的强制调整）
+
+**中英分块、不逐段交错**：产物分成两大块——先一整块**中文稿**（元信息 + ①②③④ 中文 + ⑤ 原文文稿），再一整块 **English Storyboard**（① Style Lock + ②③④ 英文）。这样用户按目标平台**整块复制**：中文平台（可灵 / 即梦 / Vidu / 通义）拷中文稿、英文平台（Veo / Runway / LTX / Luma）拷英文稿，不用逐行挑出中/英。**别在每个小节里 `【中文】…【EN】…` 交错**（那样复制粘贴要一句句抠）。
+
+英文块不是直译，要做这些原生化：
+- **摄影术语用英文原生词**：push-in / dolly-in、pull-back、tilt-up、lateral pan、rack focus、chiaroscuro、key/fill/rim light、practical light；景别 extreme close-up … extreme wide；焦段 35mm anamorphic / 50mm spherical / 85mm portrait。
+- **年份用英文格式**：`Vienna, 1920`，不是 `1920 年维也纳`。
+- **人名用英文原名**：`Sigmund Freud` / `Lacan`，不是拼音。
+- **影视参考用英文片名**（斜体）。
+- **⑤ 原文文稿只在中文稿里、不翻译**：逐句列中文口播原文即可，英文块不含它。
+- **元信息只写一次**（放最前），中英两块不重复；每镜的「建议秒数 / 段 / 场景 / 角色 / 对应原文句」表头行在中/英两块各写各自语言的一份。
+
+### D. 时长预算
+
+- **元信息给区间总时长**：`track_ed - track_st`，据此定蒙太奇段数与建议分镜数。
+- **④ 每镜给建议秒数**：各镜秒数之和量级贴合区间总时长。
+- **定位：意图值，不是精确交付保证**。多数平台由参数控时且不保证逐帧精确（各平台 fps 也不一），提示里写死秒数无用；把时长放**元信息 + 每镜建议秒数**，最终对齐在用户手动拼接那一步完成。
+- **时码只读不改**：本 skill 不写回 dispatch / struct_meta，只读 `track_st/track_ed`。
+
+## 工作流
+
+**Step 1 · 通读该 beat 文稿**：判有无历史/时代锚点（年份 / 地点 / 人物 / 事件）、主体是谁、情感落点在哪、叙事功能与阶段。dispatch 缺的参数在此推断并标注「推断」。
+
+**Step 2 · 拆蒙太奇段与镜**：按 craft A 判是否长文段需分蒙太奇段，段内按情感颗粒切镜，定各段镜数（文稿长度 × track 时长双校准）。
+
+**Step 3 · 锁风格**：按「业务分离」节解析栏目 Style Lock（读配置 → 取 produces==AI_DRAMA 条目 → 读其风格资产）；无则取中性默认。组装成 60–120 字/词的 CN + EN 双语 ①视觉基调段。
+
+**Step 4 · 写四段描述（中英分块）**：先出**中文稿**（② 故事背景末句锁调 → ③ 角色结构化 + 禁变项 + 质感落点，复现理论家 pin 复用同段文字 → ④ 分镜每镜前缀复述基调 + 建议秒数 + 对应原文句 + 蒙太奇级意图 → ⑤ 原文文稿中文逐句不翻译），再整块出 **English Storyboard**（① Style Lock + ②③④ 英文原生化，不含 ⑤）。中英**分两大块、不逐段交错**（craft C）。
+
+**Step 5 · 落盘**：写到 `<project>/ai-drama/<beat_id>.md`（一 beat 一文件，靠 beat id 认得是哪段、互不覆盖）。用户直投单段时落到用户指定处或 `<cwd>/ai-drama/<自拟标题>.md`。
+
+## 输出契约（落盘 Markdown 结构 · 中英分块）
+
+顶部放一次责权利声明 + 元信息（不分语言）；然后 **`## 一、中文稿`** 一整块、**`## 二、English Storyboard`** 一整块，用户整块复制。
+
+```
+# AI 再现分镜稿 · [自动标题]（beat <beat_id>）
+
+> [责权利声明：本稿只描述意图与时长；角色一致性依赖下游角色资产机制；出片/拼回在用户手里]
+
+## 元信息
+- 区间总时长：track_st→track_ed ≈ X 秒
+- 建议分镜数：N 镜（含 M 个蒙太奇段）
+- 复现角色：<角色名>（栏目级·pin 复用 / 本片新建）…
+- 叙事功能 / 情感阶段：xxx（用户指定 / 推断）
+- 目标平台：xxx（缺省 = 通用）
+
+======================================================================
+## 一、中文稿（喂可灵 / 即梦 / Vidu / 通义）
+======================================================================
+
+### ① 视觉基调（Style Lock）
+> 权威源，供各分镜前缀复述。来源：<解析到的 ref skill> / 中性默认
+[底色 / 中性调 / 单点强调色 / 材质 / 影视参考，60–120 字]
+> 禁忌：[通用 AI slop 兜底 + 栏目专属禁令]
+
+### ② 故事背景描述
+[时代 / 地点 / 世界观 / 场景。末句锁调：整段以……色彩与质感呈现。]
+
+### ③ 角色描述
+#### <角色名>（栏目级·pin / 本片新建）
+脸型 / 发型 / 瞳色 / 服装 / 标志物 + 禁变项（不留长发、不换西装…）+ 一句质感落点。
+
+### ④ 分镜描述
+#### 分镜 01 · [标题] ｜建议 ≈Xs ｜段：<蒙太奇段名> ｜场景：xxx ｜角色：xxx ｜对应原文：第 a–b 句
+〔视觉基调前缀复述一句〕+ 主体在做什么具体动作 + 蒙太奇级镜头意图（不逐帧硬控）。
+#### 分镜 02 · …
+
+### ⑤ 原文文稿（本区间口播原文，不翻译）
+1. [第一句中文原文]
+2. [第二句中文原文]
+…
+
+======================================================================
+## 二、English Storyboard (for Veo / Runway / LTX / Luma)
+======================================================================
+
+### ① Visual Tone (Style Lock)
+> Authoritative source; restated as a prefix in every shot. Source: <resolved ref skill> / neutral default
+[palette / neutrals / single accent / texture / film references]
+> Avoid: [generic AI slop floor + column-specific bans]
+
+### ② Background
+[era / place / world / setting. Closing line locks palette & texture.]
+
+### ③ Characters
+#### <name> (column-pinned / new to this film)
+face / hair / eyes / wardrobe / signature prop + do-not-change + one line on how they render in the tone.
+
+### ④ Shots
+#### Shot 01 · [title] ｜≈Xs ｜segment: <montage segment> ｜scene: xxx ｜cast: xxx ｜source lines: a–b
+〔restate style prefix〕+ subject's concrete action + shot intent (montage-level, not frame-locked).
+#### Shot 02 · …
+```
+
+> ⑤ 原文文稿只在中文稿里；English 块到 ④ Shots 为止。
+
+## 中性默认（未绑 AI_DRAMA 风格资产时）
+
+栏目配置里**没有 produces==AI_DRAMA 的条目**时，别停、别硬套别的栏目，用这套克制、通用、不特化任何栏目的兜底写 ①视觉基调段：
+
+> **中性 Style Lock**：影视级自然主义画面，真实可信的光源（窗光 / 实用光 / 自然天光，不炫技），克制稳定的镜头语言（固定或缓慢推拉摇，无手持抖动 / 无广告级动态运镜 / 无无人机炫技），近单色到低饱和的克制调色（不追 HDR、不追霓虹），胶片颗粒质感。忌塑料 3D 渲染、忌动漫二次元、忌过度戏剧化打光。
+> **EN**: Cinematic naturalism, believable practical light sources (window / practical / natural daylight, no showing off), restrained stable camera language (locked or slow dolly/pan/tilt, no handheld shake, no ad-grade dynamic moves, no drone stunts), near-monochrome to low-saturation restrained grade (no HDR, no neon), visible film grain. Avoid plastic 3D render, anime, and over-dramatic lighting.
+
+中性默认下**不设单点强调色 / 不指定影视导演锚点**（那些是栏目资产）。用完顺带提醒用户：**想要这条栏目有自己的 AI 再现视觉 DNA，去 `/gtrk-style-maker` 沉淀一套 AI_DRAMA 风格资产并登记进 `style.skills`**，之后每次生成都会自动注入。
+
+**禁忌行**（写进 ①）分两层：
+- **通用 AI slop 兜底（本 skill 自带，任何栏目都写）**：glossy 3D render / plastic skin、HDR look / oversaturated、generic AI anime / saccharine、deformed face / extra fingers / mutated limbs、text overlay / captions / 字幕（字幕剪辑阶段另做）、heavy lens flare / chromatic aberration、cartoon / low-res / unfinished。
+- **栏目专属禁令（从 Style Lock 追加）**：栏目风格资产里写明的禁令（如某栏目「禁多个红点 / 禁渐变 / 禁霓虹」）追加进来。无风格资产则只留通用兜底。
+
+## 责权利边界声明（写进产物顶部或末尾）
+
+产物要**显式声明责权利**，让用户拿去任何管线都心里有数：
+
+> **本稿只描述意图与时长。** 角色一致性依赖**下游管线自带的角色资产 / 参考图机制**（角色圣经 / 三视图在下游产品里生成）——把本稿的角色描述喂给有角色资产库的平台（可灵主体库 / OiiOii 角色设定表 / LTX Elements / LibTV 三视图 等），一致性由它保。若喂给**没有角色资产机制的裸文生视频 API**，角色会逐镜漂脸——那是该管线的短板，不是本稿的责任。出片、拼回时间线，都在你手里。
+
+## 交付前自检
+
+- [ ] 五区块齐备（元信息 + ①视觉基调 + ②故事背景 + ③角色 + ④分镜 + ⑤原文文稿）？
+- [ ] 每镜有**明确主语 + 明确动作**？（没有就退回）
+- [ ] 是**真的按情感颗粒切镜**，不是按句号切？长文段拆了**蒙太奇段**、段内 3–6 镜、段划分合理？
+- [ ] 视觉基调**独立成段（权威源）**，且**每镜前缀都复述**、②末句锁调、③每角色一句质感落点？
+- [ ] 中英双版范围对：①②③④ 都双写、**⑤ 原文中文不翻译**？EN 做了原生化（术语 / 年份 / 人名 / 片名）？
+- [ ] 底色 / 强调色 / 影视参考**取自栏目 Style Lock**（或明确用了中性默认），**没有硬编某栏目风格**？强调色**是道具化**（不是环境光 / 滤镜）？
+- [ ] 时长预算入元信息（区间总时长 + 建议镜数）、每镜有**建议秒数**、各镜之和量级贴合区间？
+- [ ] 禁忌行含**通用 slop 兜底**（无论栏目）+ 栏目专属禁令（有资产才加）？分镜区块内没有每镜独立负面词组？
+- [ ] 复现的理论家标了 **pin·同段文字复用**、含**禁变项**？
+- [ ] 缺省参数都**标了「推断」**、落盘文件名带 beat id、责权利边界声明在？
+
+## 交棒下一步（SOP 收口，别停在交描述）
+
+描述稿落盘后**别收工**，把接力讲清（但这一步的「手」在外部平台和用户手里、必须停下等用户）：
+
+1. **交代出片**：让用户拿 `<project>/ai-drama/<beat_id>.md` 里的描述，去任意外部平台出片——中文版喂可灵 / 即梦 / Vidu；英文版喂 Veo / Runway / LTX / Luma；本地开源（Wan / Hunyuan 等）或成片 agent 平台（LibTV / OiiOii / TapNow）皆可，按下游平台的角色资产机制上传角色描述保一致。
+2. **回铺时间线**：出好的 AI 片段**由用户手动**拖回 opencut 的 **AI_DRAMA 车道**，对齐该 beat 的 `track_st→track_ed`（**它属底轨 B-roll 画面家族，与影视/本地素材同层级；唯一在它之上的叠加层是 MG，而 MG 要等它落位后才产**），按区间总时长裁齐。
+3. **停下等用户**：AI 出片与拼回是**外部异步、用户驱动**的——本 skill 在此停，等所有 AI_DRAMA beat 的片段都回铺齐。这是 SOP 里的用户检查点，别替他假装出片 / 回轨完成。
+4. **回铺齐 ≠ 收口，还有两步**：你的片段回铺齐只意味着 **③ B-roll 底轨阶段**完成。接着 MUST 走 **④ 全局抽帧检查画面构图**（对三源合并后的最终底轨抽帧，看主体位置 / 安全区 / 画面朝向 / 明暗，**停下等用户确认**）→ 过了才交棒 **⑤ `/gtrk-mg`** 把 MG（含 ov）叠上 → 最后才 `gtrk render` 收口。
+   ⚠️ **MUST NOT 从你这里直接跳到 `render`**（旧文档曾这么写，那是错的——它把 AI 再现当成了最后一层）。
+
+> 原则：**agent 替用户跑 CLI / 接力 skill，用户只对话**。但 AI_DRAMA 车道天然有「用户去外部平台出片 + 手动拼回」的手工环节——那部分是外部的手，无法替跑；除此之外的解析、生成、落盘、交代，全由你（脑）一次做完，别让用户自己去拼描述。

package/skills/gtrk-matrix/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: gtrk-matrix
-description: B-roll 检索铺轨编排手册——成片管线里第一个铺的车道（SOP ③），也是素材智能铺轨「乐高架构」的裁定层指引。消费拆分派单的 FILM_BROLL 队列（`dispatch.film_broll`），双口向量检索 + 下载 preview 代理，在工程里平铺 N 条候选 B-roll 轨，供用户在 opencut 里用轨道小眼睛切换对比、挑选/调整；确认后交棒 ④ 铺 MG。另支持**本地素材模式**（`matrix index` 建免切片索引、`--local` 本地检索铺轨，素材本体不上云）、**按需理解零件**（`matrix describe`：VLM 描述/标签/质量分/可用性信号，plan 注入或素材直理解）、**源时间窗检索**（`--source-window`，电影解说式逐段推进）与 **plan 可编辑通路**（agent 改 plan 后 `matrix lay` 消费）。当用户想「铺 B-roll / 检索素材 / 找空镜 / 给空镜配画面 / 填 B-roll 候选 / 单独搜个词补个空槽 / 用我自己的素材铺 B-roll / 给素材文件夹建索引 / 理解一下这些素材能不能用 / 把这堆素材剪成片 / 影视解说配画面」时使用本 skill。凡涉及把素材检索并铺进工程，优先用本 skill 驱动 gtrk CLI 的 `matrix` 命令族，别让用户自己去终端敲、也别手搓检索。
+description: B-roll 检索铺轨编排手册——成片管线里第一个铺的车道（SOP ③ B-roll 底轨阶段的影视/本地素材腿），也是素材智能铺轨「乐高架构」的裁定层指引。消费拆分派单的 FILM_BROLL 队列（`dispatch.film_broll`），双口向量检索 + 下载 preview 代理，在工程里平铺 N 条候选 B-roll 轨，供用户在 opencut 里用轨道小眼睛切换对比、挑选/调整；确认后交棒同阶段的 AI 情景片段腿（`/gtrk-ai-drama`，车道非空时），三源落齐再进 ④ 全局抽帧检查构图、⑤ 才铺 MG。另支持**本地素材模式**（`matrix index` 建免切片索引、`--local` 本地检索铺轨，素材本体不上云）、**按需理解零件**（`matrix describe`：VLM 描述/标签/质量分/可用性信号，plan 注入或素材直理解）、**源时间窗检索**（`--source-window`，电影解说式逐段推进）与 **plan 可编辑通路**（agent 改 plan 后 `matrix lay` 消费）。当用户想「铺 B-roll / 检索素材 / 找空镜 / 给空镜配画面 / 填 B-roll 候选 / 单独搜个词补个空槽 / 用我自己的素材铺 B-roll / 给素材文件夹建索引 / 理解一下这些素材能不能用 / 把这堆素材剪成片 / 影视解说配画面」时使用本 skill。凡涉及把素材检索并铺进工程，优先用本 skill 驱动 gtrk CLI 的 `matrix` 命令族，别让用户自己去终端敲、也别手搓检索。
 ---
 
 # B-roll 检索铺轨编排手册（gtrk-matrix）
@@ -190,15 +190,19 @@ description: B-roll 检索铺轨编排手册——成片管线里第一个铺的
 - 豁免看的是 **gc_member_type**（同合云内部成员），与检索档位 `matrix_member_type` 是两个维度——`memberType:"internal"`（检索口）≠ 计费豁免，别混。
 - 量级参考：全量索引 5000 帧 ≈ 500 积分 ≈ 5 元；describe 50 张候选 = 50 积分；增量都只按新增算（索引指纹增量、理解缓存命中）。
 
-## 你在成片管线里的位置（SOP 第 ③ 步 · 第一个铺的车道）
+## 你在成片管线里的位置（SOP 第 ③ 步 · B-roll 底轨阶段的影视/本地素材腿）
 
 成片是**有序 SOP + 用户检查点**，不是并行一次铺完。全链：
 
-> ① `oralcut` 剪口播 → ② `split` 拆分派单出 `dispatch.json` → **③ `matrix` 先铺 B-roll（你在这）** → **用户 opencut 调整/挑选** → ④ `mg` 再铺 MG（叠在 B-roll 之上）→ ⑤ `ai-drama` 最后上 AI 再现 → `render` 收口。
+> ① `oralcut` 剪口播 → ② `split` 拆分派单出 `dispatch.json` → **③ B-roll 底轨全铺齐**（**`matrix` 铺影视/本地素材（你在这）** + `/gtrk-ai-drama` 产稿→外部出片→用户手动回铺，**两条腿同一阶段**）→ **用户 opencut 调整/挑选** → ④ **全局抽帧检查画面构图** → ⑤ `mg` 铺 MG（含 ov，最后叠上）→ `render` 收口。
 
-**为什么 B-roll 第一个铺**：MG 颗粒叠在 B-roll 之上、AI 再现最后上——先把底层 B-roll 定下来、用户满意了，上面几层才有稳的地基。铺完**必须停下等用户在 opencut 里挑选/调整**（关键检查点），不要一口气往 ④ 冲。
+**为什么 B-roll 整个阶段最先**：**AI 情景片段属于底轨 B-roll 画面家族，不是叠加层**——叠加层只有 MG（含 ov）。MG 的排版决策是「因势象形避主体」，**依赖底轨的最终画面构图**；三源（影视/本地/AI）没落齐就产 MG，等 AI 片段回铺后避让必然错位、甚至盖住 AI 画面主体。
 
-**前置**：需要跑过 `gtrk split` 的产物目录（`split/dispatch.json`）。`film_broll` 空 = 本片没有 B-roll 车道 → 跳过本步交棒 ④。`gtrk` 找不到 → `npm i -g @gitruck/cli@latest`。用户先在 opencut 手调过切点也不怕——命令每次都现场重投影 beat 窗口，微调口播轨不用重跑 `gtrk split`，只有拆分稿本身变了才要。
+> ⚠️ 旧序（MG ④ 在 AI 再现 ⑤ 之前、理由写「越往后叠得越上层」）**是把「工序次序」误当成了「图层次序」**。工序上 AI 片段必须先落位；图层上它本来就在底轨。
+
+铺完**必须停下等用户在 opencut 里挑选/调整**（关键检查点），不要一口气往下冲。
+
+**前置**：需要跑过 `gtrk split` 的产物目录（`split/dispatch.json`）。`film_broll` 空 = 本片没有影视/本地素材腿 → 跳过本步，看 AI 情景片段腿（`dispatch.ai_drama` 非空则交棒 `/gtrk-ai-drama`），两腿都空才直接进 ⑤。`gtrk` 找不到 → `npm i -g @gitruck/cli@latest`。用户先在 opencut 手调过切点也不怕——命令每次都现场重投影 beat 窗口，微调口播轨不用重跑 `gtrk split`，只有拆分稿本身变了才要。
 
 **业务分离**：本框架 skill 不硬编任何栏目审美。B-roll 的 `queries` 在 ② 拆分时已写进派单（不触发生产 skill）；栏目只供检索偏好（`--column`，internal 口生效）。档位由命令自己探（结果 JSON `memberType`），external 口固定 real_shot+有版权素材。
 
@@ -278,7 +282,7 @@ gtrk matrix --project "<split 产物目录>" [--lay N] [--score-floor F] [--top-
 - 候选轨下方垫了纯黑底轨（`lay.blackTrack`）——删多余候选轨时**别误删它**；换片拖到**候选轨颗粒**上、别拖到黑底条上（0.2.10 起客户端会拒绝并提示；旧版会静默建轨——用户说「拖了没反应」先让他重启客户端吃强更，再查轨道数，`Ctrl+Z` 整条撤销）。**MUST NOT 对旧版客户端用户承诺「客户端会拒绝并提示」**。
 - 觉得填充有问题（太杂/太空/漏段）→ 回来找我调参重铺（配方 B 的理解裁定也在这时上场）。
 
-**用户明确说「B-roll 就这样」之后**，才交棒 ④。
+**用户明确说「B-roll 就这样」之后**，才往下走——先看 AI 情景片段腿（同属 ③），三源齐了再进 ④ 全局抽帧检查，过了才交棒 ⑤ 铺 MG。详见末节「下一步」。
 
 ## 常见情况处置（据结果因势象形调整，同目录可反复重跑对比）
 
@@ -304,11 +308,14 @@ gtrk matrix --project "<split 产物目录>" [--lay N] [--score-floor F] [--top-
 
 > **搜词规范**（ad-hoc `search` 与理解派单 queries 通用）：英文长句场景描述（5–12 词，谁+在哪+做什么），一条只装一个场景意象，避多义/字面强的动词（"pointing"/"hunting" 会召回特写/猎人，改用 "giving suggestions in a meeting" 这类场景语义）。
 
-## 下一步（交棒 ④，别停在铺完）
+## 下一步（别停在铺完，也别直接跳去铺 MG）
 
-用户确认 B-roll 满意后，顺势按 SOP 交棒 ④ 铺 MG：触发 `/gtrk-mg`（读 `dispatch.mg`，把 MG 叠在你刚定好的 B-roll 之上）。一句话交代即推进：「B-roll 底层定了，我接着把 MG 颗粒叠上去」。
+用户确认你这条腿的 B-roll 满意后，**先看 AI 情景片段腿有没有活**——它与你同属 ③ B-roll 底轨阶段，MUST 在 MG 之前落位：
 
-- `dispatch.mg` 为空 → 跳过 ④，看 ⑤ AI 再现（`dispatch.ai_drama` 非空则触发 `/gtrk-ai-drama`）。
+- **`dispatch.ai_drama` 非空** → 交棒 `/gtrk-ai-drama`（产分镜稿 → 用户去外部平台出片 → 手动回铺）。一句话交代：「影视素材这腿定了，AI 情景片段还有 N 段要出，我把分镜稿产出来给你」。
+  ⚠️ **异步等待的口子**：外部平台抽卡可能数天，严格串行会把后续无限期卡住。故进 ⑤ 的硬门是「**AI 片段已回铺 ∨ 用户明示先跳过**」。走「明示跳过」时 MUST 把**与 AI beat 相邻或重叠区间的 MG 颗粒**标记为「AI 回铺后待复查构图」并在收口时复述该清单，**MUST NOT 静默跳过**。
+- **`dispatch.ai_drama` 为空** → 三源已齐，直接进 **④ 全局抽帧检查画面构图**：对最终底轨抽帧看主体位置 / 安全区 / 画面朝向 / 明暗，**停下等用户确认构图无误**（这与刚才「挑选 B-roll」那次确认是两次不同的确认），过了才交棒 ⑤ `/gtrk-mg`。
+- `dispatch.mg` 也为空 → 无 MG 车道，④ 检查过后直接 `render` 收口。
 - 用户表示暂时只要 B-roll → 停在这，尊重他的节奏。
 
-> 原则：**agent 替用户跑 CLI / 接力 skill，用户只对话**——别让用户自己去终端敲下一条 gtrk 命令；但关键检查点（尤其 B-roll 铺完这一处）务必停下等用户确认再进下一步。
+> 原则：**agent 替用户跑 CLI / 接力 skill，用户只对话**——别让用户自己去终端敲下一条 gtrk 命令；但关键检查点务必停下等用户确认再进下一步——本车道涉及**两处**：① B-roll 铺完让用户挑选/调整；② ④ 全局抽帧检查后让用户确认构图。