@gitruck/cli 0.2.3 → 0.2.6

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

@@ -0,0 +1,439 @@
+---
+title: 当我们痛苦的时候，我们究竟在痛苦什么？
+container: 过拟合
+theme: overfitting
+split_unit: visual_beat
+default_base_track: 真人口播打底
+---
+
+# 全片总览
+
+- 三幕结构：第一幕用身体参与和日常痛感把观众拖进镜像认同；第二幕用“过拟合”翻译强迫性重复并一路坠入实在界；第三幕用“双重下降”完成容器反转，再以“幽灵堵车”回扣收尾。
+- 容器贯穿线：`seed` 于“荒诞的过拟合”；`expand/translate` 于 AI 概念解释和心理学映射；`flip` 于双重下降；`callback` 于幽灵堵车。
+- 必须回扣的意象：`掐虎口`、`过拟合`、`幽灵堵车`
+- 静音/停顿节点：`我们，一直在自己掐自己的虎口` 之后；`是不是就能脱离这种循环` 之后；`如果一切都是潜意识的剧本` 之后
+
+# Beat Timeline
+
+## B01
+- 文稿范围：`精神分析中有一句话……完整地体验到了人类潜意识里最隐秘的“享乐闭环”`
+- 底轨：`真人出镜`
+- 主层：`A_ROLL`
+- 叙事功能：`mirror-hook`
+- 容器阶段：`none`
+- 节奏标签：`平稳 -> 停顿`
+- 视觉任务：`主持人直视镜头带观众做“掐虎口”实验，让观众从旁观者变成参与者`
+- 拆分理由：`这是全片最强的身体钩子，信任感和参与感都必须靠真人承接`
+- 不可替代性：`必须真人出镜`
+
+### 辅助层 B01.A1
+- 类型：`quote-card`
+- 挂载范围：`你以为的痛苦……“享受”剩余快感`
+- 职责：`金句提炼`
+- 说明：`先把反常识理论钉住，再进入身体实验`
+- 必要性：`强建议`
+
+### 辅助层 B01.A2
+- 类型：`pause-card`
+- 挂载范围：`现在告诉我，你痛嘛？……好了，恭喜你`
+- 职责：`停顿加压`
+- 说明：`用短暂停顿把“痛感”转成“被看穿”的心理时刻`
+- 必要性：`建议`
+
+## B02
+- 文稿范围：`这就是通俗意义上的痛苦……最后，如果你运气好，你会走到“接受”`
+- 底轨：`口播继续 / 真人可隐藏`
+- 主层：`FILM_BROLL`
+- 叙事功能：`mirror-hook`
+- 容器阶段：`none`
+- 节奏标签：`快剪`
+- 视觉任务：`用亲人离去、职场背刺、关系破裂、都市独处等现实碎片建立普遍痛感`
+- 拆分理由：`从实验过渡到普遍经验，画面职责已从“现场参与”切到“群体镜像”`
+- 不可替代性：`可被 B-roll 替代`
+
+### 辅助层 B02.A1
+- 类型：`term-callout`
+- 挂载范围：`从不相信、到沉默、到愤怒、到绝望……“接受”`
+- 职责：`术语解释`
+- 说明：`把大众熟悉的“标准悲伤流程”打成一串节奏点`
+- 必要性：`建议`
+
+## B03
+- 文稿范围：`随着时间的推移……我们，一直在自己掐自己的虎口`
+- 底轨：`口播继续 / 真人可隐藏`
+- 主层：`FILM_BROLL`
+- 叙事功能：`demolition`
+- 容器阶段：`none`
+- 节奏标签：`快剪 -> 停顿`
+- 视觉任务：`从深夜闪回、地铁失神、伴侣争吵等生活场景中，压出“痛苦在被自己重复生产”`
+- 拆分理由：`这里从“客观痛苦”正式转向“主体在重复痛苦”，论证职责变化`
+- 不可替代性：`可被 B-roll 替代`
+
+### 辅助层 B03.A1
+- 类型：`quote-card`
+- 挂载范围：`我们，一直在自己掐自己的虎口`
+- 职责：`情绪聚焦`
+- 说明：`把前面的身体实验回扣成一句能留下来的判断`
+- 必要性：`强建议`
+
+## B04
+- 文稿范围：`在精神分析学家拉康眼中……你的痛苦，不过是一场荒诞的“过拟合”`
+- 底轨：`真人出镜`
+- 主层：`A_ROLL`
+- 叙事功能：`demolition`
+- 容器阶段：`seed`
+- 节奏标签：`悬停`
+- 视觉任务：`主持人正面抛出“从心理学跨越到人工智能”的桥，并完成容器首次登场`
+- 拆分理由：`这是全片结构钥匙，容器必须以真人发话的方式被招召出来`
+- 不可替代性：`必须真人出镜`
+
+### 辅助层 B04.A1
+- 类型：`term-callout`
+- 挂载范围：`荒诞的“过拟合”`
+- 职责：`术语解释`
+- 说明：`首次给英文名和中文名，便于后文反复调用`
+- 必要性：`必须`
+
+## B05
+- 文稿范围：`什么是“过拟合”？……给出一个极其离谱的错误答案`
+- 底轨：`旁白主导`
+- 主层：`RRV_MG`
+- 叙事功能：`container-translation`
+- 容器阶段：`expand`
+- 节奏标签：`平稳`
+- 视觉任务：`用训练集、噪音、测试集、错误预测的动态图把“过拟合”先讲清楚`
+- 拆分理由：`这里主要任务是讲结构，不是讲情绪，最适合进入 MG`
+- 不可替代性：`优先 MG`
+- RRV 提示：`container-translation/neural-overfit`
+- 替代方案：`若 MG 档期不足，可降级为 A_ROLL + 简单图表动效`
+
+### 辅助层 B05.A1
+- 类型：`data-annotation`
+- 挂载范围：`把训练数据里的那些“噪音”……不可动摇的真理`
+- 职责：`术语解释`
+- 说明：`标出 train set、noise、error、test failure 四个关键信息点`
+- 必要性：`强建议`
+
+## B06
+- 文稿范围：`它太想答对过去的题……你的潜意识依然乐此不疲`
+- 底轨：`旁白主导`
+- 主层：`RRV_MG`
+- 叙事功能：`container-translation`
+- 容器阶段：`translate`
+- 节奏标签：`渐升`
+- 视觉任务：`把 AI 过拟合一一映射到创伤、自动化防御、现实崩溃，完成“AI -> 人类”的翻译`
+- 拆分理由：`容器从自我解释转为心理学翻译器，职责明显升级`
+- 不可替代性：`优先 MG`
+- RRV 提示：`container-translation/dual-pane-map`
+
+### 辅助层 B06.A1
+- 类型：`network-diagram`
+- 挂载范围：`让我们把这个概念放回我们人类的身上……和AI一样的自动化防御响应`
+- 职责：`关系表达`
+- 说明：`用左右映射把“噪音”“答对过去”“失去未来能力”翻译成心理结构`
+- 必要性：`必须`
+
+## B07
+- 文稿范围：`1920年，弗洛伊德发表了著名的《超越快乐原则》……我们在幻想着控制混乱无序的痛苦根源`
+- 底轨：`旁白主导`
+- 主层：`AI_DRAMA`
+- 叙事功能：`container-translation`
+- 容器阶段：`translate`
+- 节奏标签：`平稳 -> 渐升`
+- 视觉任务：`演绎弗洛伊德、创伤退伍士兵、Fort-Da 游戏，建立“主动重复痛苦是为了争夺控制感”`
+- 拆分理由：`这里的说服力来自具名历史人物与经典场景，再现比抽象说明更有效`
+- 不可替代性：`可降级处理`
+- 替代方案：`若 AI 演绎不稳，可改为 A_ROLL + 档案照片 + 文字动画`
+
+### 辅助层 B07.A1
+- 类型：`archive-caption`
+- 挂载范围：`1920年，弗洛伊德发表了著名的《超越快乐原则》……这些老兵在梦里，每一天都在反复重演战场上的血肉横飞`
+- 职责：`证据标注`
+- 说明：`补足年份、人物、著作名，让历史再现不只是氛围画面`
+- 必要性：`强建议`
+
+### 辅助层 B07.A2
+- 类型：`network-diagram`
+- 挂载范围：`小孙子把它用力扔到床底下……控制混乱无序的痛苦根源`
+- 职责：`关系表达`
+- 说明：`把 Fort-Da、主动重复、控制幻觉串成一条理解链`
+- 必要性：`建议`
+
+## B08
+- 文稿范围：`再来看看现在很多社媒评论区……那可怜的“剩余享乐”`
+- 底轨：`口播继续 / 真人可隐藏`
+- 主层：`FILM_BROLL`
+- 叙事功能：`container-translation`
+- 容器阶段：`translate`
+- 节奏标签：`快剪`
+- 视觉任务：`用评论区对骂、戾气、猫梗、羞辱感、发飙等社会化碎片，把“过拟合”落到当代网络环境`
+- 拆分理由：`历史论证之后转向热点案例，理解路径从“经典文本”切到“当下经验”`
+- 不可替代性：`可被 B-roll 替代`
+
+### 辅助层 B08.A1
+- 类型：`network-diagram`
+- 挂载范围：`被嘲笑的不是猫……我的潜意识获得了那可怜的“剩余享乐”`
+- 职责：`关系表达`
+- 说明：`把羞辱 -> 恐惧 -> 抢先惩罚自己 -> 愤怒 -> 剩余享乐 画成连锁图`
+- 必要性：`强建议`
+
+## B09
+- 文稿范围：`这其实是人类进化留在基因里的一部分……它变成了一种精神的顽疾`
+- 底轨：`口播继续 / 真人可隐藏`
+- 主层：`FILM_BROLL`
+- 叙事功能：`abyssal-fall`
+- 容器阶段：`rupture`
+- 节奏标签：`悬停`
+- 视觉任务：`从草丛惊动、捕食风险切到现代都市失配，做出“旧生存策略在今天变成顽疾”的冷落差`
+- 拆分理由：`这里进入结构无解感，情绪开始下沉，不再只是举例`
+- 不可替代性：`可被 B-roll 替代`
+
+## B10
+- 文稿范围：`好，那么问题来了……（停顿）`
+- 底轨：`真人出镜`
+- 主层：`A_ROLL`
+- 叙事功能：`abyssal-fall`
+- 容器阶段：`rupture`
+- 节奏标签：`停顿`
+- 视觉任务：`主持人重新出镜，直问“看见过拟合之后能否脱离循环”，把观众锁进谷底前的悬崖边`
+- 拆分理由：`重大转折前必须让观众重新看见说话的人，增强临场压力`
+- 不可替代性：`必须真人出镜`
+
+### 辅助层 B10.A1
+- 类型：`pause-card`
+- 挂载范围：`是不是就能脱离这种循环……（停顿）`
+- 职责：`停顿加压`
+- 说明：`让答案暂时缺席，制造真空感`
+- 必要性：`必须`
+
+## B11
+- 文稿范围：`现在市面上有很多流行的心理学流派……旧病复发`
+- 底轨：`口播继续 / 真人可隐藏`
+- 主层：`FILM_BROLL`
+- 叙事功能：`demolition`
+- 容器阶段：`rupture`
+- 节奏标签：`快剪`
+- 视觉任务：`把“脱敏、和解、发泄、打枕头”等流行疗法做成一组被逐个击穿的商品化镜头`
+- 拆分理由：`这里不是提出新解释，而是拆穿廉价解决方案`
+- 不可替代性：`可被 B-roll 替代`
+
+### 辅助层 B11.A1
+- 类型：`quote-card`
+- 挂载范围：`它只是一种对症状的“审美修饰”`
+- 职责：`金句提炼`
+- 说明：`把批判压成一句容易传播的判断`
+- 必要性：`强建议`
+
+## B12
+- 文稿范围：`比如，一个从小被父亲家暴……我就能改写童年那个无能为力的自己`
+- 底轨：`口播继续 / 真人可隐藏`
+- 主层：`FILM_BROLL`
+- 叙事功能：`abyssal-fall`
+- 容器阶段：`rupture`
+- 节奏标签：`平稳 -> 渐升`
+- 视觉任务：`用关系案例把“潜意识雷达”和“重复跳进火坑”演成一段不断复写的亲密关系模式`
+- 拆分理由：`这里用案例而非理论推动观众坠落到“我逃不掉”的体感`
+- 不可替代性：`可被 B-roll 替代`
+
+### 辅助层 B12.A1
+- 类型：`quote-card`
+- 挂载范围：`我们并不渴望幸福本身……拯救阴暗痛苦的过去`
+- 职责：`金句提炼`
+- 说明：`把案例的底层动力压缩成一张标题卡`
+- 必要性：`强建议`
+
+## B13
+- 文稿范围：`你的潜意识是一台精准的雷达……正是你自己`
+- 底轨：`真人出镜`
+- 主层：`A_ROLL`
+- 叙事功能：`abyssal-fall`
+- 容器阶段：`rupture`
+- 节奏标签：`悬停`
+- 视觉任务：`主持人用更低、更稳的语气说出“你找到的只是重温旧梦的恶鬼”，并把“实在界”压到观众面前`
+- 拆分理由：`这是二幕谷底的核心刺点，最好由真人直面观众说出`
+- 不可替代性：`必须真人出镜`
+
+### 辅助层 B13.A1
+- 类型：`term-callout`
+- 挂载范围：`这就是拉康说的实在界`
+- 职责：`术语解释`
+- 说明：`给“实在界”一个明确落点，防止术语空转`
+- 必要性：`建议`
+
+## B14
+- 文稿范围：`斯坦福大学神经生物学教授罗伯特·萨波斯基……规则与匮乏`
+- 底轨：`旁白主导`
+- 主层：`RRV_MG`
+- 叙事功能：`abyssal-fall`
+- 容器阶段：`rupture`
+- 节奏标签：`渐升`
+- 视觉任务：`把神经递质、创伤印痕、代际传递、大他者压成一张逐步收紧的因果网`
+- 拆分理由：`这里信息链条密度很高，MG 比真人或纯素材更能把结构讲明白`
+- 不可替代性：`优先 MG`
+- RRV 提示：`abyssal-fall/grid-captured`
+
+### 辅助层 B14.A1
+- 类型：`archive-caption`
+- 挂载范围：`罗伯特·萨波斯基……“创伤印痕（Imprint）”`
+- 职责：`证据标注`
+- 说明：`给学者名和关键术语一个干净的知识锚点`
+- 必要性：`建议`
+
+### 辅助层 B14.A2
+- 类型：`network-diagram`
+- 挂载范围：`每一次心跳加速……规则与匮乏`
+- 职责：`关系表达`
+- 说明：`把神经元、童年、代际传递、大他者串成压迫主体的结构网络`
+- 必要性：`必须`
+
+## B15
+- 文稿范围：`听到这里，你可能会觉得绝望……（停顿）`
+- 底轨：`真人出镜`
+- 主层：`A_ROLL`
+- 叙事功能：`holding`
+- 容器阶段：`flip`
+- 节奏标签：`停顿`
+- 视觉任务：`主持人先接住观众的绝望，不急着讲希望，而是先让“被理解”成立`
+- 拆分理由：`从谷底转向抱持，语气和情绪职责都变了`
+- 不可替代性：`必须真人出镜`
+
+### 辅助层 B15.A1
+- 类型：`pause-card`
+- 挂载范围：`如果一切都是潜意识的剧本……（停顿）`
+- 职责：`停顿加压`
+- 说明：`把绝望明确说透，才有后面的反转重量`
+- 必要性：`必须`
+
+## B16
+- 文稿范围：`在传统的机器学习理论中……展现出了不可思议的泛化能力和“涌现”出的智能`
+- 底轨：`旁白主导`
+- 主层：`RRV_MG`
+- 叙事功能：`reversal-elevation`
+- 容器阶段：`flip`
+- 节奏标签：`渐升`
+- 视觉任务：`用偏差-方差权衡、插值阈值、双重下降曲线完成“过拟合 -> 泛化”的结构反转`
+- 拆分理由：`容器的希望面在这里正式出现，最适合由动态图完成说服`
+- 不可替代性：`优先 MG`
+- RRV 提示：`reversal-elevation/overfit-to-double-descent`
+
+### 辅助层 B16.A1
+- 类型：`data-annotation`
+- 挂载范围：`偏差-方差权衡……双重下降`
+- 职责：`术语解释`
+- 说明：`把几个高密度术语压成可看懂的几个标注点`
+- 必要性：`强建议`
+
+## B17
+- 文稿范围：`人类的历史，人类的心智，不也是如此吗？……现实也会在我们的眼中，以意想不到的方式发生折叠与变化`
+- 底轨：`真人出镜`
+- 主层：`A_ROLL`
+- 叙事功能：`holding`
+- 容器阶段：`flip`
+- 节奏标签：`平稳`
+- 视觉任务：`主持人把双重下降重新翻译回人的生命经验，让观众感到“我不是死循环，而是螺旋上升”`
+- 拆分理由：`从技术反转转回生命感受，最适合由真人把抽象希望落地`
+- 不可替代性：`必须真人出镜`
+
+### 辅助层 B17.A1
+- 类型：`quote-card`
+- 挂载范围：`我们的命运看似是在画一个又一个的同心圆……它是螺旋上升的`
+- 职责：`金句提炼`
+- 说明：`把第三幕的第一波希望感提炼成一个可记忆句子`
+- 必要性：`强建议`
+
+## B18
+- 文稿范围：`在法国精神分析宗师拉康晚期的理论中……获得一点点真正的自由`
+- 底轨：`真人出镜`
+- 主层：`A_ROLL`
+- 叙事功能：`reversal-elevation`
+- 容器阶段：`flip`
+- 节奏标签：`平稳 -> 悬停`
+- 视觉任务：`主持人完成“认同你的症状”这次真正的主体性重构，不给建议，只给重新理解自身的入口`
+- 拆分理由：`这是第三幕的思想峰值，必须由真人稳稳托住`
+- 不可替代性：`必须真人出镜`
+
+### 辅助层 B18.A1
+- 类型：`term-callout`
+- 挂载范围：`认同你的症状`
+- 职责：`术语解释`
+- 说明：`给拉康晚期的核心提法一个清晰入口`
+- 必要性：`必须`
+
+### 辅助层 B18.A2
+- 类型：`quote-card`
+- 挂载范围：`我们的痛苦，是我们生命力在抗争的证明`
+- 职责：`金句提炼`
+- 说明：`把升华后的情绪核心压成一句必须被记住的话`
+- 必要性：`强建议`
+
+## B19
+- 文稿范围：`回到之前的话题，我们该如何解决幽灵堵车？……最后所有的车流都能够慢慢起速`
+- 底轨：`旁白主导`
+- 主层：`RRV_MG`
+- 叙事功能：`callback-closure`
+- 容器阶段：`callback`
+- 节奏标签：`回扣`
+- 视觉任务：`把前文“幽灵堵车”回调出来，用自动驾驶车辆吸收刹车波浪的系统动画做出解法`
+- 拆分理由：`结尾回扣不只是情绪重复，而是要把前文意象结构性地翻新一次`
+- 不可替代性：`优先 MG`
+- 回扣对象：`B07`
+- RRV 提示：`callback-closure/recall-image-question`
+
+### 辅助层 B19.A1
+- 类型：`network-diagram`
+- 挂载范围：`感知到前方的刹车波浪……终结了痛苦的传递`
+- 职责：`关系表达`
+- 说明：`把“缓冲 -> 吸收冲击波 -> 整体起速”呈现成一个系统过程`
+- 必要性：`强建议`
+
+## B20
+- 文稿范围：`那么，我们的人生，是否还在「堵车」呢？`
+- 底轨：`真人出镜`
+- 主层：`A_ROLL`
+- 叙事功能：`callback-closure`
+- 容器阶段：`callback`
+- 节奏标签：`悬停`
+- 视觉任务：`回到主持人，让问题停在观众心里，而不是替观众收尾`
+- 拆分理由：`结尾是发问，不是总结，必须把思考权还给观众`
+- 不可替代性：`必须真人出镜`
+
+### 辅助层 B20.A1
+- 类型：`quote-card`
+- 挂载范围：`那么，我们的人生，是否还在「堵车」呢？`
+- 职责：`回扣提示`
+- 说明：`保留一个极简的结尾文字层，让问题在黑场里继续回荡`
+- 必要性：`建议`
+
+# Production Queues
+
+## A_ROLL Queue
+
+- `B01` 掐虎口实验开场
+- `B04` “过拟合”作为容器首次登场
+- `B10` 谷底前的关键发问
+- `B13` 二幕谷底核心刺点
+- `B15` 第三幕抱持入口
+- `B17` 双重下降重新翻译回人的生命经验
+- `B18` “认同你的症状”的主体性重构
+- `B20` 结尾回扣式发问
+
+## RRV_MG Queue
+
+- `B05` 过拟合概念展开
+- `B06` AI 结构映射到心理结构
+- `B14` 神经递质/创伤/代际/大他者因果网
+- `B16` 双重下降反转
+- `B19` 幽灵堵车系统解法与回扣
+
+## AI_DRAMA Queue
+
+- `B07` 弗洛伊德、创伤老兵、Fort-Da 的历史再现
+
+## FILM_BROLL Queue
+
+- `B02` 普遍痛苦经验快剪
+- `B03` 痛苦被主体重复生产
+- `B08` 评论区戾气与羞辱链条
+- `B09` 远古生存策略与现代失配
+- `B11` 流行心理疗法的商品化镜头
+- `B12` 亲密关系里的强迫性重复案例

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

@@ -0,0 +1,100 @@
+# 拆分稿字段契约 v1（JSON）
+
+`gtrk-splitter` 的产物是**机器 JSON 拆分稿**（不是 Markdown）——`gtrk split <拆分稿.json>` 校验落地。
+目标：LLM 可稳定产出、校验器可硬拒、下游（matrix / rrv / ai-drama）可直接消费。
+
+> 时码零触碰：拆分稿里**不含任何秒级时码字段**。轨道时码由 `gtrk split` 落地时现场投影写入 `struct_meta.split` / `dispatch.json`。
+
+## 顶层结构
+
+```jsonc
+{
+  "contract_version": "v1",              // 固定 "v1"
+  "transcript_hash": "<64 位 hex>",      // 必填：原样透传投影视图的 transcript_hash（hash 链，错版硬拒）
+  "beats": [ /* Beat[]，见下 */ ],        // 必填非空
+  "queues": { /* 人读派单汇总，可选；机器侧不消费，dispatch.json 由 beats 现场生成 */ }
+}
+```
+
+- `transcript_hash` 不匹配当前 `transcript.json` 的 `text_hash` → **硬拒**（提示转写已变更、需重新导出视图重拆）。
+- `queues` 是给人看的四车道汇总（`a_roll/rrv_mg/ai_drama/film_broll` 各 `[{beat, note}]`），**可选**；真正的机器派单 `dispatch.json` 由落地时按 beats 现场生成，不读 `queues`。
+
+## Beat 字段
+
+### 必填
+
+| 字段 | 类型 | 取值 |
+|---|---|---|
+| `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` |
+| `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 | 人读节奏标签（`快剪` / `平稳` / `渐升` / `停顿` / `悬停` / `回扣` 等）；**机器不消费**、只透传 |
+| `visual_task` | string | 一句话：该 beat 让观众「看到什么变化」 |
+| `irreplaceability` | enum | `必须真人出镜` \| `优先 MG` \| `可被 B-roll 替代` \| `可降级处理` |
+
+### 可选
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `handoff` | object | 按 `lane` 分型（见下）。`A_ROLL` 不应带，带了被警告忽略 |
+| `aux_layers` | array | 辅助层（见下） |
+| `fallback` | string | 预算/素材/AI 稳定性不足时的降级方案 |
+| `callback_of` | string | 回扣对象 beat id（如 `B07`）；前文意象后文重调时**不合并 beat**，在后文 beat 写此字段 |
+| `note` | string | 其他对制作有帮助的信息 |
+
+## 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 === "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": ["卡通", "水印"] }
+//   queries（非空字符串数组）必填；shots / per_shot_sec / exclude 可选
+//   queries 语言规范（经真机中英 A/B 校准）：
+//   - 用**英文长句场景描述**（5-12 词，谁+在哪+做什么），不是关键词堆叠——检索后端向量模型英文场景级命中明显更准
+//   - 每条 query 只装一个场景意象，多意象拆成多条
+//   - **避多义/字面义强的动词**（"pointing" 会召回手指特写、"hunting" 召回猎人——改用 "giving suggestions in a meeting" 这类场景语义）
+//   - **exclude 保持中文**：负向过滤匹配的是服务端返回的中文 note，写英文会失效
+
+// lane === "AI_DRAMA"  —— 全可选（下游 ai-drama-prompter 有推断默认）
+"handoff": { "narrative": "trauma-repetition", "theme": "freud-fort-da", "emotion_stage": "abyssal", "platform": "video-gen", "shot_count": 5 }
+
+// lane === "A_ROLL"  —— 无 handoff
+```
+
+## 辅助层字段（aux_layers[]）
+
+```jsonc
+{
+  "type": "quote-card",                        // 七类：quote-card | term-callout | network-diagram
+                                               //       | archive-caption | pause-card | data-annotation | timeline-tag
+  "mount": { "from": "u0001", "to": "u0002" }, // 挂载范围三型："same_beat" | {from,to} | {trigger:"uNNNN"}
+  "role": "金句提炼",                           // 职责：金句提炼/术语解释/关系表达/证据标注/停顿加压/情绪聚焦/回扣提示
+  "necessity": "强建议",                        // 可选：必须 | 强建议 | 建议 | 可省略
+  "note": "为什么加它",                         // 可选
+  "promote_condition": "若连续承担主要理解职责，则升级为下一个 beat 主层",  // 可选
+  "fallback": "该辅助层不可做时的替代方式"       // 可选
+}
+```
+
+- `mount` 里的所有 id（`from`/`to`/`trigger`）MUST 为视图中存在的 utterance id，否则硬拒。
+- 辅助层是补充理解职责，不是装饰。满足升级规则时**切出新 beat 升级为主层**，别硬塞辅助层。
+
+## 落地产物（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/visual-split.md`**（`--md`）：由机器 JSON 单向渲染的人读稿，不回读。
+
+## 落地时的 dropped 处理（你要知道）
+
+- beat 的 span 内 utterance **全部** dropped（在当前时间线被剪光）→ 该 beat 被**跳过**（不写标注、不进派单），进 result 报告。
+- **部分** dropped → beat 轨道区间按存活 utterances 的包络**收缩**、标 `shrunk:true`，进报告提示人工复核。
+- 所以：别把 `dropped:true` 的句子划进 span；想让某段进画面，先让用户在客户端恢复它（拉长 clip）再重导视图。

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

@@ -0,0 +1,88 @@
+---
+name: gtrk-style-maker
+description: "能生产 skill 的 meta skill——通过启发式访谈引导视频创作者想清楚**他自己的**视觉语法，并把它落成**他自己的可执行 skill 家族**（黑盒、留本地）+ 栏目内共享词表 + 栏目配置登记。框架对审美零预设：不假设你有叙事结构、有容器概念、视觉分 MG/AI——你的维度（k）和取值（v）全部由你自己定义，本 skill 只提供「怎么想清楚」的工艺。当用户想「建一个新栏目/新频道的风格体系」「把我的审美沉淀成 skill」「做一个我自己的视觉 skill」「定义栏目风格规范/视觉语法」「栏目配置文档的 style 怎么填」「给我的栏目造一套创作工具」时使用本 skill。产出的 skill 落 ~/.claude/skills 即装即用，登记进 gtrk 栏目配置（style.skills）。"
+---
+
+# gtrk-style-maker · 造你自己的视觉 skill
+
+你（AI）现在是一位**风格助产士**。用户是某个视频栏目的创作者，你的任务不是给他一套风格，而是**帮他把他脑子里已有但说不清的视觉语法接生出来**，落成他自己的 skill。
+
+## 铁律（先读，贯穿全程）
+
+1. **问证据，不问维度。** 你永远不出示任何「风格维度清单/表单」让用户挑选或填空。不假设他有叙事结构、有主题系统、视觉分动画/实拍——**每一个组织维度都必须从用户自己的话里长出来**。你问的是证据（作品、反例、工序、禁忌），维度是你从证据里帮他命名的，且命名要用他的词。
+2. **卡壳追问 ≤3 条，且每条必须有触发语。** 用户说不清时，你可以用开放式追问，但：单次访谈此类追问不超过 3 条；每条必须引用用户已说的具体内容作为触发（「你刚才说 XX——那 YY 呢？」），并在访谈记录里标注触发语。**禁止**按任何预设清单逐项顺次遍历（疑问句版表单也是表单）。
+3. **种子是案例，不是模板。** `references/seeds/` 里的种子演示「产出长什么样」，结构随栏目而异。用户的栏目跟种子不像时，从零引导，绝不套种子结构。
+4. **产出必须可执行。** 最终交付的是标准 skill 目录（新会话即可触发干活），不是一份风格描述文档。
+5. **管线接口全权威。** 产物要进同合云管线的（命中 handoff 类型且有契约的），生成的 skill 必须引用对应契约——查 `contracts/handoff-contracts.json` 映射表（随本 CLI 分发），**不要**自己记映射。
+
+## 访谈工艺 · 七招
+
+每招给做法 + 正反例 + 不适用分支。顺序可按对话自然流动调整，但 ①② 通常先行。
+
+### ① 作品逆向（维度的出生地）
+
+请用户拿出 **3-5 个「最像我/最像我想要的」** 的成片或参考作品，和 **2-3 个「绝对不是我」** 的反例。逐个问：「这条里**什么**让它像你？」「这条哪里让你生理不适？」
+- ✅ 正例：用户说「我喜欢它信息密但颜色狠少」→ 你记下候选维度「信息密度」「色彩纪律」（用他的词）。
+- ❌ 反例：你问「你的视觉 token 是什么？你有几个主题变体？」——这是拿别人的维度套他。
+- **不适用分支**：从零新栏目没有自己的作品 → 全用他人作品：「找 3 条你看了会嫉妒的视频」。
+
+### ② 禁令先行（最硬的护栏都是负面的）
+
+问：「你的画面里**绝对不允许出现**什么？」「什么效果一出现你就觉得廉价？」
+经验规律：创作者说不清「我的风格是什么」，但对「什么绝对不行」秒答，且禁令可执行、可自检、防漂移。把禁令原话记成条目。
+- ✅ 正例：「绝不用彩虹渐变」「绝不加综艺花字」→ 直接进铁律区。
+- ❌ 反例：把禁令翻译成「所以你的风格是极简」——不要急着正面归纳，禁令本身就是资产。
+
+### ③ 从工序提决策树
+
+问：「你自己动手做一个画面时，**第一个**问自己的问题是什么？第二个呢？」
+他的实际决策顺序就是他 skill 的 Step 1/2/3。不要替他发明顺序。
+- ✅ 正例：带货创作者说「先看这句是痛点还是卖点」→ 他的 Step 1 就是「判断痛点/卖点」。
+- **不适用分支**：用户从没自己动手做过（纯外包）→ 改问「你验收时第一眼看什么？」——验收顺序也是决策树。
+
+### ④ 铁律化 + 自检清单
+
+每条风格主张必须配**可判定**的自检问句（「不是建议，是合同」）。说不出怎么判定的主张，降级为「倾向」，不进铁律。
+- ✅ 正例：「留白要多」→ 追问触发：「你刚说留白要多——多到什么程度算违规？」→ 若答不出，记为倾向而非铁律。
+- 生成的 skill 必须带「交付前自检清单」小节，逐条对应铁律。
+
+### ⑤ 词表沉淀
+
+访谈中**反复出现的自造词**（他给自己概念起的名字）逐个登记。这些词就是他栏目的语法词汇。
+- 条件产出：家族 ≥2 个 skill **或** 沉淀出自造词时，单独产共享词表文件（家族各 skill 引用它，防多处定义漂移——这是血泪教训）；单 skill 且无自造词时，词表并入 SKILL.md 一节即可。
+
+### ⑥ 家族切分
+
+用户有多条视觉产线时（如「有的段落做动画、有的用实拍素材」），按**产物类型/handoff** 切成多个 skill，每个 skill 开头写「**这个 skill 不做什么** → 找谁」互相路由。
+- ✅ 正例：动画产线一个 skill、素材检索偏好一个 skill、封面一个 skill，各自声明边界。
+- ⚠️ 探测其他产线时**别举具体产线例子**（举例=递维度）——问「除了这个，你还产别的东西吗？」就够了。
+- **不适用分支**：单产线栏目不切家族，一个 skill 足够——不要为了「像样」硬拆。
+
+### ⑦ exemplar 优先
+
+每个 skill 至少规划 N 个**验证过的成品案例**（exemplar）收进 assets/。原则写给 skill：「案例是原则的具象化，不是填空答案」。
+- **不适用分支**：产物不是可留存文件的产线（如实拍混剪的选片手感）→ 用「判例」代替：记录 3 个真实决策（这条为什么选/为什么毙）。
+
+## 卡壳弹药（受铁律 2 约束）
+
+用户彻底说不清时，可从 `references/ammo.md` 取**开放式追问**（如「有的栏目会锁死参考片单——你有看了就想抄的片子吗？」）。注意：弹药问的是**证据是否存在**，不是让他填维度；用了哪条、触发语是什么，记进访谈记录。
+
+## 产出工序（访谈收敛后）
+
+读 `references/craft-output-spec.md` 照做。概要：
+
+1. **起 skill 目录**（用户作坊目录为正本，如 `D:\<他的工作区>\skills\<skill-name>\`）：SKILL.md（frontmatter `name`+`description`，description 即触发器，写清「当用户想…时使用」）+ **README.md 必产**（含「正本→安装」单向流声明）+ 按需 references/ assets/。exemplar 一旦在 SKILL.md 里被引用就必须真实存在——「计划中的案例」不能以文件路径形式出现。skill 正文结构**由访谈产出的维度决定**，不套模板。
+2. **契约绑定**：产物命中管线 handoff 类型的，查 `contracts/handoff-contracts.json`（本 CLI 包内）；映射到契约的（如 HTML 动画颗粒 → gsap-emit v1），在 skill 中引用「契约名+版本」并把契约合规项加进其自检清单；映射为 null 或管线外产物，无此要求。
+3. **共享词表**（条件产出，见第⑤招）。
+4. **安装**：整目录拷到 `~/.claude/skills/<skill-name>/`（即装即用）。skill README 写明**「正本→安装」单向流**：源码正本在作坊，安装位是产物，改动先改正本再重装。
+5. **登记**：把 `{id, ref: <正本路径>, produces: <handoff 类型或自造串>}` **追加**进本地栏目配置 `style.skills`（词表进 `style.shared`）。配置文件位置以 gtrk 的 paths 口径为准（当前 `~/.gitruck/columns/<栏目id>.json`）；文件不存在则创建最小骨架 `{meta:{id},style:{skills:[…]}}`。**追加，绝不清空既有条目**。产物是管线外的（封面等），登记时加 `routing:"none"`。
+
+## 交付前自检（你自己的 Quality Bar）
+
+- [ ] 访谈记录里，产出 skill 的**每一个组织维度，首次都是用户说出的**（或从他的作品评语里直接引出的），不是我提出的？
+- [ ] 我的提问里没有出现任何种子栏目/预设语系的概念名（用户自己先说的除外）？
+- [ ] 卡壳追问 ≤3 条且每条有触发语记录？
+- [ ] 产出 skill 有：触发器 description / 铁律（含禁令）/ 可判定自检清单 / exemplar 或判例计划？
+- [ ] 契约绑定查了映射表（而不是凭记忆）？
+- [ ] 栏目配置登记是**追加**语义，既有条目一条没丢？
+- [ ] 已提醒用户：skill 是他的资产，留本地即可用；上传云端（claude.ai）是可选分发，非必需？

package/skills/gtrk-style-maker/references/ammo.md

@@ -0,0 +1,16 @@
+# 卡壳弹药（受 SKILL.md 铁律 2 严格约束）
+
+> **用法边界**：仅当用户明确卡壳时取用；单次访谈 ≤3 条；每条必须挂上用户已说内容作触发语并记录；**禁止逐条顺次遍历**（那是疑问句版表单）。这些问句问的是「某类证据在你这里存不存在」，不是让用户认领维度——他说「没有/不重要」就放下，绝不追销。
+
+历史上有的栏目沉淀过以下几类资产。对应的开放式问法：
+
+- **参考锚点类**：「有看了就想抄的片子/导演/画师吗？——你刚说想要 XX 的感觉，有现成的东西长这样吗？」
+- **禁忌清单类**：「有没有哪种效果，一出现你就想关掉？」
+- **色彩纪律类**：「你刚提到颜色——你的画面里颜色是谁说了算？有数量限制吗？」
+- **重复仪式类**：「有没有什么东西你每期都会做一遍？（开场方式/某个符号/某种收尾）」
+- **强调手段类**：「你想让观众'看这里'的时候，通常怎么做？这招用得多吗、有没有用滥的担心？」
+- **文字出场类**：「文字在你画面里是什么身份——主角、旁注、还是尽量不出现？」
+- **节奏习惯类**：「你剪东西时，什么时候觉得'该停一下了'？」
+- **质感偏好类**：「你刚说不喜欢 XX 的廉价感——那你觉得'贵'的画面贵在哪？」
+
+> 注意：以上是**证据探测方向**，不是维度清单。若用户对某方向给出实质回答，维度命名仍然用**他的原话**。

package/skills/gtrk-style-maker/references/contracts-ref.md

@@ -0,0 +1,9 @@
+# 契约库引用（正本不在这里）
+
+框架契约库**正本** = `@gitruck/cli` 包内 `contracts/` 目录（管线资产归管线位置）：
+
+- `contracts/README.md` — 收录双轴边界（管线性 + 脱敏）
+- `contracts/handoff-contracts.json` — handoff 类型 → 契约映射表（**查表，不硬编码**）
+- `contracts/gsap-emit-v1.md` — HTML 动画颗粒逐帧 seek 合规契约 v1
+
+定位方式：本 skill 经 `gtrk skills install` 安装时，CLI 包根即 `gtrk` 命令所属包（`npm root -g` 下的 `@gitruck/cli`，或开发仓根）。找不到包时，让用户跑 `gtrk doctor` 确认安装。