@gitruck/cli 0.2.6 → 0.2.7

package/skills/gtrk-splitter/references/example-visual-split.json

@@ -43,9 +43,9 @@
       "irreplaceability": "可被 B-roll 替代",
       "handoff": {
         "queries": [
-          "lonely person in a city apartment at night",
-          "exhausted commuter on a crowded subway train",
-          "couple arguing as their relationship falls apart"
+          "都市独处 夜晚",
+          "地铁 疲惫 通勤",
+          "关系破裂 争吵"
         ],
         "shots": 6,
         "per_shot_sec": 2,
@@ -70,8 +70,8 @@
       "irreplaceability": "可被 B-roll 替代",
       "handoff": {
         "queries": [
-          "sleepless person lying awake in bed late at night",
-          "couple giving each other the silent treatment after a fight"
+          "深夜 失眠 闪回",
+          "伴侣 争吵 冷战"
         ],
         "shots": 4,
         "per_shot_sec": 2.5
@@ -118,7 +118,7 @@
         "to": "u0013"
       },
       "base_track": "旁白主导",
-      "lane": "RRV_MG",
+      "lane": "MG",
       "narrative": "container-translation",
       "container_stage": "expand",
       "rhythm": "平稳",
@@ -139,7 +139,7 @@
         "to": "u0016"
       },
       "base_track": "旁白主导",
-      "lane": "RRV_MG",
+      "lane": "MG",
       "narrative": "container-translation",
       "container_stage": "translate",
       "rhythm": "渐升",
@@ -178,7 +178,7 @@
         "narrative": "trauma-repetition",
         "theme": "freud-fort-da",
         "emotion_stage": "abyssal",
-        "platform": "video-gen",
+        "platform": "kling",
         "shot_count": 5
       },
       "aux_layers": [
@@ -210,8 +210,8 @@
       "irreplaceability": "可被 B-roll 替代",
       "handoff": {
         "queries": [
-          "hostile social media comment threads on a phone screen",
-          "aggressive messages flooding a glowing phone screen in the dark"
+          "社交媒体 评论区 对骂",
+          "手机屏幕 戾气 弹幕"
         ],
         "shots": 5,
         "per_shot_sec": 1.8,
@@ -244,8 +244,8 @@
       "irreplaceability": "可被 B-roll 替代",
       "handoff": {
         "queries": [
-          "tall grass swaying in the wind on an empty plain",
-          "anonymous crowd walking past each other in a city street"
+          "荒野 草丛 风声",
+          "都市 人群 疏离"
         ],
         "shots": 4,
         "per_shot_sec": 2.2
@@ -291,8 +291,8 @@
       "irreplaceability": "可被 B-roll 替代",
       "handoff": {
         "queries": [
-          "glossy commercial for self-help therapy products",
-          "person venting anger by hitting a pillow in a bedroom"
+          "心理疗愈 商品 广告感",
+          "打枕头 发泄 房间"
         ],
         "shots": 5,
         "per_shot_sec": 1.8,
@@ -325,8 +325,8 @@
       "irreplaceability": "可被 B-roll 替代",
       "handoff": {
         "queries": [
-          "couple stuck in the same recurring argument at home",
-          "child overshadowed by tension in a family living room"
+          "亲密关系 反复 争执",
+          "童年 阴影 家庭"
         ],
         "shots": 4,
         "per_shot_sec": 2.5
@@ -371,7 +371,7 @@
         "to": "u0036"
       },
       "base_track": "旁白主导",
-      "lane": "RRV_MG",
+      "lane": "MG",
       "narrative": "abyssal-fall",
       "container_stage": "rupture",
       "rhythm": "渐升",
@@ -423,7 +423,7 @@
         "to": "u0041"
       },
       "base_track": "旁白主导",
-      "lane": "RRV_MG",
+      "lane": "MG",
       "narrative": "reversal-elevation",
       "container_stage": "flip",
       "rhythm": "渐升",
@@ -498,7 +498,7 @@
         "to": "u0048"
       },
       "base_track": "旁白主导",
-      "lane": "RRV_MG",
+      "lane": "MG",
       "narrative": "callback-closure",
       "container_stage": "callback",
       "rhythm": "回扣",
@@ -580,7 +580,7 @@
         "note": "回到主持人，让问题停在观众心里，而不是替观众收尾"
       }
     ],
-    "rrv_mg": [
+    "mg": [
       {
         "beat": "B05",
         "note": "用训练集、噪音、测试集、错误预测的动态图把过拟合先讲清楚"

package/skills/gtrk-splitter/references/example-visual-split.md

@@ -97,14 +97,14 @@ default_base_track: 真人口播打底
 ## B05
 - 文稿范围：`什么是“过拟合”？……给出一个极其离谱的错误答案`
 - 底轨：`旁白主导`
-- 主层：`RRV_MG`
+- 主层：`MG`
 - 叙事功能：`container-translation`
 - 容器阶段：`expand`
 - 节奏标签：`平稳`
 - 视觉任务：`用训练集、噪音、测试集、错误预测的动态图把“过拟合”先讲清楚`
 - 拆分理由：`这里主要任务是讲结构，不是讲情绪，最适合进入 MG`
 - 不可替代性：`优先 MG`
-- RRV 提示：`container-translation/neural-overfit`
+- MG 提示：`container-translation/neural-overfit`
 - 替代方案：`若 MG 档期不足，可降级为 A_ROLL + 简单图表动效`
 
 ### 辅助层 B05.A1
@@ -117,14 +117,14 @@ default_base_track: 真人口播打底
 ## B06
 - 文稿范围：`它太想答对过去的题……你的潜意识依然乐此不疲`
 - 底轨：`旁白主导`
-- 主层：`RRV_MG`
+- 主层：`MG`
 - 叙事功能：`container-translation`
 - 容器阶段：`translate`
 - 节奏标签：`渐升`
 - 视觉任务：`把 AI 过拟合一一映射到创伤、自动化防御、现实崩溃，完成“AI -> 人类”的翻译`
 - 拆分理由：`容器从自我解释转为心理学翻译器，职责明显升级`
 - 不可替代性：`优先 MG`
-- RRV 提示：`container-translation/dual-pane-map`
+- MG 提示：`container-translation/dual-pane-map`
 
 ### 辅助层 B06.A1
 - 类型：`network-diagram`
@@ -263,14 +263,14 @@ default_base_track: 真人口播打底
 ## B14
 - 文稿范围：`斯坦福大学神经生物学教授罗伯特·萨波斯基……规则与匮乏`
 - 底轨：`旁白主导`
-- 主层：`RRV_MG`
+- 主层：`MG`
 - 叙事功能：`abyssal-fall`
 - 容器阶段：`rupture`
 - 节奏标签：`渐升`
 - 视觉任务：`把神经递质、创伤印痕、代际传递、大他者压成一张逐步收紧的因果网`
 - 拆分理由：`这里信息链条密度很高，MG 比真人或纯素材更能把结构讲明白`
 - 不可替代性：`优先 MG`
-- RRV 提示：`abyssal-fall/grid-captured`
+- MG 提示：`abyssal-fall/grid-captured`
 
 ### 辅助层 B14.A1
 - 类型：`archive-caption`
@@ -307,14 +307,14 @@ default_base_track: 真人口播打底
 ## B16
 - 文稿范围：`在传统的机器学习理论中……展现出了不可思议的泛化能力和“涌现”出的智能`
 - 底轨：`旁白主导`
-- 主层：`RRV_MG`
+- 主层：`MG`
 - 叙事功能：`reversal-elevation`
 - 容器阶段：`flip`
 - 节奏标签：`渐升`
 - 视觉任务：`用偏差-方差权衡、插值阈值、双重下降曲线完成“过拟合 -> 泛化”的结构反转`
 - 拆分理由：`容器的希望面在这里正式出现，最适合由动态图完成说服`
 - 不可替代性：`优先 MG`
-- RRV 提示：`reversal-elevation/overfit-to-double-descent`
+- MG 提示：`reversal-elevation/overfit-to-double-descent`
 
 ### 辅助层 B16.A1
 - 类型：`data-annotation`
@@ -369,7 +369,7 @@ default_base_track: 真人口播打底
 ## B19
 - 文稿范围：`回到之前的话题，我们该如何解决幽灵堵车？……最后所有的车流都能够慢慢起速`
 - 底轨：`旁白主导`
-- 主层：`RRV_MG`
+- 主层：`MG`
 - 叙事功能：`callback-closure`
 - 容器阶段：`callback`
 - 节奏标签：`回扣`
@@ -377,7 +377,7 @@ default_base_track: 真人口播打底
 - 拆分理由：`结尾回扣不只是情绪重复，而是要把前文意象结构性地翻新一次`
 - 不可替代性：`优先 MG`
 - 回扣对象：`B07`
-- RRV 提示：`callback-closure/recall-image-question`
+- MG 提示：`callback-closure/recall-image-question`
 
 ### 辅助层 B19.A1
 - 类型：`network-diagram`
@@ -417,7 +417,7 @@ default_base_track: 真人口播打底
 - `B18` “认同你的症状”的主体性重构
 - `B20` 结尾回扣式发问
 
-## RRV_MG Queue
+## MG Queue
 
 - `B05` 过拟合概念展开
 - `B06` AI 结构映射到心理结构

package/skills/gtrk-splitter/references/field-schema.md

@@ -1,7 +1,7 @@
 # 拆分稿字段契约 v1（JSON）
 
 `gtrk-splitter` 的产物是**机器 JSON 拆分稿**（不是 Markdown）——`gtrk split <拆分稿.json>` 校验落地。
-目标：LLM 可稳定产出、校验器可硬拒、下游（matrix / rrv / ai-drama）可直接消费。
+目标：LLM 可稳定产出、校验器可硬拒、下游（matrix / mg / ai-drama）可直接消费。
 
 > 时码零触碰：拆分稿里**不含任何秒级时码字段**。轨道时码由 `gtrk split` 落地时现场投影写入 `struct_meta.split` / `dispatch.json`。
 
@@ -17,7 +17,7 @@
 ```
 
 - `transcript_hash` 不匹配当前 `transcript.json` 的 `text_hash` → **硬拒**（提示转写已变更、需重新导出视图重拆）。
-- `queues` 是给人看的四车道汇总（`a_roll/rrv_mg/ai_drama/film_broll` 各 `[{beat, note}]`），**可选**；真正的机器派单 `dispatch.json` 由落地时按 beats 现场生成，不读 `queues`。
+- `queues` 是给人看的四车道汇总（`a_roll/mg/ai_drama/film_broll` 各 `[{beat, note}]`），**可选**；真正的机器派单 `dispatch.json` 由落地时按 beats 现场生成，不读 `queues`。
 
 ## Beat 字段
 
@@ -28,7 +28,7 @@
 | `id` | string | `B` + 两位起序号（`B01`…）；同稿内唯一 |
 | `span` | object | `{from, to}` 两端均为投影视图中存在的 utterance id；`from ≤ to`（id 序）；beats 间**不重叠**（允许留空隙） |
 | `base_track` | enum | 口播底轨三态：`真人出镜` \| `口播继续` \| `旁白主导` |
-| `lane` | enum | 主层四选一：`A_ROLL` \| `RRV_MG` \| `AI_DRAMA` \| `FILM_BROLL` |
+| `lane` | enum | 主层四选一：`A_ROLL` \| `MG` \| `AI_DRAMA` \| `FILM_BROLL`（遗留 `RRV_MG` 读旧归一为 `MG`） |
 | `narrative` | enum | 八枚举：`mirror-hook` \| `demolition` \| `container-translation` \| `abyssal-fall` \| `holding` \| `reversal-elevation` \| `callback-closure` \| `typography-emphasis` |
 | `container_stage` | enum | 七枚举：`none` \| `seed` \| `expand` \| `translate` \| `rupture` \| `flip` \| `callback` |
 | `rhythm` | string | 人读节奏标签（`快剪` / `平稳` / `渐升` / `停顿` / `悬停` / `回扣` 等）；**机器不消费**、只透传 |
@@ -48,9 +48,13 @@
 ## handoff 按 lane 分型（校验器硬查）
 
 ```jsonc
-// lane === "RRV_MG"
-"handoff": { "slug_hint": "neural-overfit", "theme": "overfitting", "bg": "paper", "duration_hint": 12 }
-//   duration_hint（秒）必填；slug_hint / theme / bg 可选（bg 底色可由底轨态推导）
+// lane === "MG"（遗留 "RRV_MG" 读旧兼容）
+"handoff": { "category": "overlay", "slug_hint": "neural-overfit", "theme": "overfitting", "bg": "paper", "duration_hint": 12 }
+//   duration_hint（秒）必填；slug_hint / theme / bg / category 可选（bg 底色可由底轨态推导）
+//   category（颗粒品类子类型，裁决⑩）：overlay（透明叠加,叠在 A-roll/B-roll 上,不挡主体）
+//     | fullscreen（不透明满屏,旁白主导整帧）；缺省=下游按颗粒 HTML 根 background 反推透明度。
+//     二期扩 subtitle/title。供剪辑器色带按品类分层(叠加/满屏 各一行)。
+//     读旧兼容：遗留品牌值 rrv-overlay/mg-fullscreen/explain-subtitle/op-ed-title 仍认。
 
 // lane === "FILM_BROLL"
 "handoff": { "queries": ["lonely person in a city apartment at night", "exhausted commuter on a crowded subway train"], "shots": 6, "per_shot_sec": 2, "exclude": ["卡通", "水印"] }
@@ -71,8 +75,8 @@
 
 ```jsonc
 {
-  "type": "quote-card",                        // 七类：quote-card | term-callout | network-diagram
-                                               //       | archive-caption | pause-card | data-annotation | timeline-tag
+  "type": "quote-card",                        // 八类：quote-card | term-callout | network-diagram
+                                               //       | archive-caption | pause-card | data-annotation | timeline-tag | overlay
   "mount": { "from": "u0001", "to": "u0002" }, // 挂载范围三型："same_beat" | {from,to} | {trigger:"uNNNN"}
   "role": "金句提炼",                           // 职责：金句提炼/术语解释/关系表达/证据标注/停顿加压/情绪聚焦/回扣提示
   "necessity": "强建议",                        // 可选：必须 | 强建议 | 建议 | 可省略
@@ -84,13 +88,37 @@
 
 - `mount` 里的所有 id（`from`/`to`/`trigger`）MUST 为视图中存在的 utterance id，否则硬拒。
 - 辅助层是补充理解职责，不是装饰。满足升级规则时**切出新 beat 升级为主层**，别硬塞辅助层。
+- 前七类是**纯建议性**（人读稿一行摘要，不承接派单）；第八类 `overlay` 是**承接颗粒派单**的叠层类型（见下）。
+
+### `overlay` 叠层颗粒 aux（第八类，承接派单）
+
+`overlay` = 与底轨主视觉（如 `FILM_BROLL` 电影感 B-roll）**同段共存的透明概念颗粒**——想「底轨放实拍情绪镜头、其上叠一层 MG 透明图解/金句」时用它。与前七类不同，`overlay` aux 必带 `handoff`，由 `gtrk split` 落地投影成派生颗粒（进 `dispatch.mg` + 合成 `struct_meta.split.beats`），后续 `gtrk mg` 铺出透明颗粒盖在底轨上。
+
+```jsonc
+{
+  "type": "overlay",
+  "mount": "same_beat",                        // same_beat（复用当前 beat 落轨区间）| {from,to}（子区间）；{trigger} 一期不支持
+  "role": "概念叠层图解",
+  "handoff": {                                 // overlay 必带（镜像 MG lane 的 handoff）
+    "duration_hint": 6,                        //   必填正数秒（该 aux 要生成颗粒，无时长不成立；缺/非正数硬拒）
+    "category": "overlay",                     //   可选品类（软校验，非法只告警不拒；派生颗粒实际 category 恒 "overlay"）
+    "slug_hint": "overfit-mirror",             //   可选：颗粒 slug 提示
+    "theme": "overfitting",                    //   可选：主题
+    "bg": "transparent"                        //   可选：底色（叠层通常透明）
+  }
+}
+```
+
+- **mount 投影**：`same_beat` → 复用当前 beat 的 `track_st/track_ed`；`{from,to}` → 取该子区间存活实例的包络（全被剪则计入 `skipped` 不落）。**`{trigger}` 点挂载一期不支持**（无干净源区间，`duration_hint` 是时间线秒非源秒 → 跟随会不准）：遇到计入 `skipped` + 告警，二期再补。
+- **composition_id 命名**：派生颗粒 = `<工程slug>-<beatId>-aux<n>`（`n` 从 1，位置计数）；同 beat 主颗粒仍是 `<工程slug>-<beatId>`。「一 beat 一 composition_id」松绑为「`composition_id` 全局唯一，一 beat 可派生主 + N 个 `-aux<n>` 颗粒」。
+- **一期约束**：`FILM_BROLL` 主（底轨不产 MG 颗粒）+ 一颗 `overlay` aux 同段安全；`MG` 主 beat 再挂 `overlay` aux 会同段两颗撞一轨（后续拆轨），先避开。
 
 ## 落地产物（CLI 写，供参照）
 
 - **`.gtrk` 的 `struct_meta.split`**：`{contract_version, transcript_hash, projected_at, material_id, beats:[{id, lane, span, track_st, track_ed, source_ranges, narrative, container_stage, visual_task, shrunk?, handoff}]}`——投影时刻快照。**消费方要新鲜时码就重新投影**（`gtrk split --project`）。
   - `material_id`：口播素材 id（= transcript.material_id），消费方脱离 transcript 文件即可定位素材。
   - `beats[].source_ranges`：`[{st, ed}]` 源时基秒（v1 恒单元素 = span 源包络，含句间静默与被剪词）——**源时基不随时间线编辑漂移**，消费方以「源区间 ∩ 当刻颗粒源窗口」投影可得实时覆盖（客户端色带跟随模式即此）。
-- **`split/dispatch.json`**：`{rrv_mg:[{beat, composition_id, duration, theme, bg, slug_hint, track_st, track_ed}], film_broll:[{beat, queries, shots, per_shot_sec, exclude, track_st, track_ed}], ai_drama:[{beat, ...handoff, track_st, track_ed}]}`。`composition_id` = `<工程slug>-<beatId>`（rrv 颗粒 `data-composition-id` 直接用它，打通 beat↔颗粒命名）。
+- **`split/dispatch.json`**：`{mg:[{beat, composition_id, duration, category?, theme, bg, slug_hint, track_st, track_ed}], film_broll:[{beat, queries, shots, per_shot_sec, exclude, track_st, track_ed}], ai_drama:[{beat, ...handoff, track_st, track_ed}]}`（去品牌化前 `mg` 键为 `rrv_mg`，消费方 `mg ?? rrv_mg` 双读）。`composition_id` = `<工程slug>-<beatId>`（MG 颗粒 `data-composition-id` 直接用它，打通 beat↔颗粒命名）；`overlay` aux 派生颗粒 = `<工程slug>-<beatId>-aux<n>`（`n` 从 1）——`composition_id` 全局唯一，一 beat 可派生主 + N 个 `-aux<n>` 颗粒。
 - **`split/visual-split.md`**（`--md`）：由机器 JSON 单向渲染的人读稿，不回读。
 
 ## 落地时的 dropped 处理（你要知道）

package/skills/gtrk-style-maker/SKILL.md

@@ -14,6 +14,7 @@ description: "能生产 skill 的 meta skill——通过启发式访谈引导视
 3. **种子是案例，不是模板。** `references/seeds/` 里的种子演示「产出长什么样」，结构随栏目而异。用户的栏目跟种子不像时，从零引导，绝不套种子结构。
 4. **产出必须可执行。** 最终交付的是标准 skill 目录（新会话即可触发干活），不是一份风格描述文档。
 5. **管线接口全权威。** 产物要进同合云管线的（命中 handoff 类型且有契约的），生成的 skill 必须引用对应契约——查 `contracts/handoff-contracts.json` 映射表（随本 CLI 分发），**不要**自己记映射。
+6. **生产 skill = 纯生产者，零包工头职责。** 你产的栏目 skill 只做一件事：按栏目视觉语法**产内容**（颗粒 HTML / 分镜提示词 / 检索偏好…）。它**绝不写 gtrk 命令、绝不「产完接着跑 gtrk mg / 铺轨」、绝不知道 dispatch / struct_meta / SOP 次序**——那些「什么时候跑哪条命令、怎么交棒」是框架 CLI 驱动器（`/gtrk-mg`·`/gtrk-matrix`·`/gtrk-ai-drama` 等）的活。**CLI 驱动栏目 skill，不是反过来**；栏目 skill 独立触发时也只产内容、不假设有工程/派单上下文。理由：把编排焊进栏目 skill = 业务耦合 + 不通用（换个栏目又得重焊），且违背「框架对审美零预设」的对偶——**审美归你、编排归框架**。你只暴露产物**经 `style.skills[].produces` 绑定到哪条车道**，让框架据此调用。
 
 ## 访谈工艺 · 七招
 
@@ -84,5 +85,10 @@ description: "能生产 skill 的 meta skill——通过启发式访谈引导视
 - [ ] 卡壳追问 ≤3 条且每条有触发语记录？
 - [ ] 产出 skill 有：触发器 description / 铁律（含禁令）/ 可判定自检清单 / exemplar 或判例计划？
 - [ ] 契约绑定查了映射表（而不是凭记忆）？
+- [ ] 产出 skill 是**纯生产者**——正文里没有任何 gtrk 命令、没有「产完接着跑…」、不碰 dispatch/struct_meta/SOP 编排（铁律 6）？
 - [ ] 栏目配置登记是**追加**语义，既有条目一条没丢？
 - [ ] 已提醒用户：skill 是他的资产，留本地即可用；上传云端（claude.ai）是可选分发，非必需？
+
+## 下一步（回成片管线）
+
+建栏目是**一次性装修厨房**，装完就该开始做菜。栏目 skill 家族 + 词表 + 栏目配置就绪后，告诉用户「风格体系已就绪，给我一条口播毛片就能开工」，顺势回到成片管线起点：用户给毛片 → 触发 `/gtrk-oralcut`（agent 跑 `gtrk oralcut`）→ `/gtrk-splitter` 拆分派单 → 各车道用你**刚建的生产 skill** 产内容 + agent 跑 `gtrk mg`/`matrix` 铺轨 → `gtrk render` 出片。往后每片都在这套厨房里做，不用重新装修。**agent 替用户跑 CLI，用户只对话。**

package/skills/gtrk-style-maker/references/seeds/seed-psych-humanities.md

@@ -20,7 +20,7 @@
 | skill | 产什么 | produces | 契约 |
 |---|---|---|---|
 | 拆分派单器 | 全片 beat 派单文档 | —（管线文档生产者，不登记） | — |
-| 动态图生成 | HTML 动画颗粒 | RRV_MG | gsap-emit v1（合规项进自检） |
+| 动态图生成 | HTML 动画颗粒 | MG | gsap-emit v1（合规项进自检） |
 | AI 再现分镜 | 双语分镜提示词文本 | AI_DRAMA | 暂无契约 |
 | 封面设计 | 文生图 prompt + 排字工作台 | cover + routing:"none" | 管线外 |