@gitruck/cli 1.0.3 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,16 +1,16 @@
1
- # 卡壳弹药(受 SKILL.md 铁律 2 严格约束)
2
-
3
- > **用法边界**:仅当用户明确卡壳时取用;单次访谈 ≤3 条;每条必须挂上用户已说内容作触发语并记录;**禁止逐条顺次遍历**(那是疑问句版表单)。这些问句问的是「某类证据在你这里存不存在」,不是让用户认领维度——他说「没有/不重要」就放下,绝不追销。
4
-
5
- 历史上有的栏目沉淀过以下几类资产。对应的开放式问法:
6
-
7
- - **参考锚点类**:「有看了就想抄的片子/导演/画师吗?——你刚说想要 XX 的感觉,有现成的东西长这样吗?」
8
- - **禁忌清单类**:「有没有哪种效果,一出现你就想关掉?」
9
- - **色彩纪律类**:「你刚提到颜色——你的画面里颜色是谁说了算?有数量限制吗?」
10
- - **重复仪式类**:「有没有什么东西你每期都会做一遍?(开场方式/某个符号/某种收尾)」
11
- - **强调手段类**:「你想让观众'看这里'的时候,通常怎么做?这招用得多吗、有没有用滥的担心?」
12
- - **文字出场类**:「文字在你画面里是什么身份——主角、旁注、还是尽量不出现?」
13
- - **节奏习惯类**:「你剪东西时,什么时候觉得'该停一下了'?」
14
- - **质感偏好类**:「你刚说不喜欢 XX 的廉价感——那你觉得'贵'的画面贵在哪?」
15
-
16
- > 注意:以上是**证据探测方向**,不是维度清单。若用户对某方向给出实质回答,维度命名仍然用**他的原话**。
1
+ # 卡壳弹药(受 SKILL.md 铁律 2 严格约束)
2
+
3
+ > **用法边界**:仅当用户明确卡壳时取用;单次访谈 ≤3 条;每条必须挂上用户已说内容作触发语并记录;**禁止逐条顺次遍历**(那是疑问句版表单)。这些问句问的是「某类证据在你这里存不存在」,不是让用户认领维度——他说「没有/不重要」就放下,绝不追销。
4
+
5
+ 历史上有的栏目沉淀过以下几类资产。对应的开放式问法:
6
+
7
+ - **参考锚点类**:「有看了就想抄的片子/导演/画师吗?——你刚说想要 XX 的感觉,有现成的东西长这样吗?」
8
+ - **禁忌清单类**:「有没有哪种效果,一出现你就想关掉?」
9
+ - **色彩纪律类**:「你刚提到颜色——你的画面里颜色是谁说了算?有数量限制吗?」
10
+ - **重复仪式类**:「有没有什么东西你每期都会做一遍?(开场方式/某个符号/某种收尾)」
11
+ - **强调手段类**:「你想让观众'看这里'的时候,通常怎么做?这招用得多吗、有没有用滥的担心?」
12
+ - **文字出场类**:「文字在你画面里是什么身份——主角、旁注、还是尽量不出现?」
13
+ - **节奏习惯类**:「你剪东西时,什么时候觉得'该停一下了'?」
14
+ - **质感偏好类**:「你刚说不喜欢 XX 的廉价感——那你觉得'贵'的画面贵在哪?」
15
+
16
+ > 注意:以上是**证据探测方向**,不是维度清单。若用户对某方向给出实质回答,维度命名仍然用**他的原话**。
@@ -1,9 +1,9 @@
1
- # 契约库引用(正本不在这里)
2
-
3
- 框架契约库**正本** = `@gitruck/cli` 包内 `contracts/` 目录(管线资产归管线位置):
4
-
5
- - `contracts/README.md` — 收录双轴边界(管线性 + 脱敏)
6
- - `contracts/handoff-contracts.json` — handoff 类型 → 契约映射表(**查表,不硬编码**)
7
- - `contracts/gsap-emit-v1.md` — HTML 动画颗粒逐帧 seek 合规契约 v1(**含「回调与 seek 语义」一节**:颗粒可用 `onUpdate` 等时间线回调驱动画面,回调可达性由**引擎侧** MUST 条款保证,颗粒不应自加 `tl.seek` 垫片;该节是本主题的唯一口径来源)
8
-
9
- 定位方式:本 skill 经 `gtrk skills install` 安装时,CLI 包根即 `gtrk` 命令所属包(`npm root -g` 下的 `@gitruck/cli`,或开发仓根)。找不到包时,让用户跑 `gtrk doctor` 确认安装。
1
+ # 契约库引用(正本不在这里)
2
+
3
+ 框架契约库**正本** = `@gitruck/cli` 包内 `contracts/` 目录(管线资产归管线位置):
4
+
5
+ - `contracts/README.md` — 收录双轴边界(管线性 + 脱敏)
6
+ - `contracts/handoff-contracts.json` — handoff 类型 → 契约映射表(**查表,不硬编码**)
7
+ - `contracts/gsap-emit-v1.md` — HTML 动画颗粒逐帧 seek 合规契约 v1(**含「回调与 seek 语义」一节**:颗粒可用 `onUpdate` 等时间线回调驱动画面,回调可达性由**引擎侧** MUST 条款保证,颗粒不应自加 `tl.seek` 垫片;该节是本主题的唯一口径来源)
8
+
9
+ 定位方式:本 skill 经 `gtrk skills install` 安装时,CLI 包根即 `gtrk` 命令所属包(`npm root -g` 下的 `@gitruck/cli`,或开发仓根)。找不到包时,让用户跑 `gtrk doctor` 确认安装。
@@ -1,4 +1,4 @@
1
- # 种子案例库
2
-
3
- > **种子是案例,不是模板。** 每个种子演示「一次成功的风格接生最终长什么样」——注意看的是**产出的形态**(维度有名字、铁律带自检、家族互相路由、词表单点定义),不是维度本身。不同栏目的维度截然不同:用户的栏目跟任何种子都不像时,从零引导(七招),绝不套种子结构。
4
- > 种子一律**削减版**(组织维度 + 词表 + 自检结构),且已脱敏(无外部供应商/平台名——完整版在各栏目主自己的作坊,不随框架分发)。
1
+ # 种子案例库
2
+
3
+ > **种子是案例,不是模板。** 每个种子演示「一次成功的风格接生最终长什么样」——注意看的是**产出的形态**(维度有名字、铁律带自检、家族互相路由、词表单点定义),不是维度本身。不同栏目的维度截然不同:用户的栏目跟任何种子都不像时,从零引导(七招),绝不套种子结构。
4
+ > 种子一律**削减版**(组织维度 + 词表 + 自检结构),且已脱敏(无外部供应商/平台名——完整版在各栏目主自己的作坊,不随框架分发)。
@@ -1,37 +1,37 @@
1
- # 种子 · 家居好物带货栏目(「李姐严选」削减版)
2
-
3
- 一人主理的家居好物口播带货号。访谈收敛出的家族:**1 个 skill(单产线不切)+ 词表并入 SKILL.md**。
4
-
5
- ## 组织维度(全部来自栏目主自己的语言)
6
-
7
- - **Step 1 = 痛点**:她的第一判断是「这货到底解决啥难受」——痛点必须**能拍出来**(一滩酱油/一声「咔」/一个乱抽屉),开头三秒戳它;且次序铁定「先戳痛点再亮卖点,反了人就划走」。痛点找不着,这单不接。
8
- - **第二维度 = 上手**:信任感的唯一来源是「真人上手」——手 + 货 + 使劲的动作同画面,环境必须是过日子的地方;演不出来的卖点降级为嘴上带过,不给镜头。
9
- - **第三维度 = 砸价**:价格是一个「出场动作」,不是一条信息——三选一判定(手上动作 / 憋一下再喊 / 全屏只剩一个大数),且砸之前全篇不许漏价。
10
- - **第四维度 = 现在就买的理由**:结尾闭环,最后一句必须给一个说得出口的理由(马上用得上的场景 / 限时 / 赠品),不许只说「喜欢的拍」。
11
- - **负面护栏 = 廉价感**:她说不出「风格是什么」,但对「什么显得廉价」秒答——七条禁令(综艺花字/满屏贴纸/「duang」类音效/抠图假背景/磨皮到看不清货/机器人配音/价格缩在角落小字)是全套规矩里最硬的资产。
12
-
13
- ## 铁律(禁令先行的产物,节选)
14
-
15
- - 廉价感七条禁令,中一条即重剪。
16
- - 前三秒只许出现「难受」:不许品牌、自我介绍、价格、参数。
17
- - 砸价三选一,占零样 = 念价格,返工;砸前漏价 = 白砸。
18
- - 字幕最多两行大白字;真人原声,带口音也不换机器配音。
19
- - 每条铁律配自检问句(例:「只看前三秒,看没看见一个具体的难受?」「砸价那一秒,三样占了几样?」「最后五秒能不能一句话复述那个现在就买的理由?」)。
20
-
21
- ## 家族切分
22
-
23
- 单产线不切家族:只有一条产线(带货片子),封面从片中截帧、不单独生产 → 1 个 skill 足够。`produces` = 自造串「带货台本」,查 handoff 映射表未命中注册集 → 无契约绑定,登记加 `routing:"none"`。
24
-
25
- ## 词表(并入 SKILL.md 一节)
26
-
27
- 已沉淀自造词,但家族仅 1 个 skill、无跨文件漂移面 → 词表并入 SKILL.md,并写明「出现第二个 skill 时整节迁出为 `_shared` 词表,各 skill 引用不复制」。词条(全部她的原词):
28
-
29
- **痛点 / 卖点 / 上手 / 砸价 / 信任感 / 廉价感 / 划走 / 台本**(产物名)。
30
-
31
- ## 自检结构
32
-
33
- 自检清单逐条对应铁律,问句全部可判定、且用她的词(「砸价那一秒三样占了几样?」而非「价格强调是否充分?」)。给不出判定阈值的主张(「亮堂」「干净」「东西少」——她的原话「说不上数,凭眼睛」)降级为「倾向」,单列一节,不进铁律、不进自检硬条目。
34
-
35
- ## 这个种子教你什么
36
-
37
- 维度名(痛点/上手/砸价/廉价感/划走)**只属于这个栏目**。可迁移的是形态:①**负面维度可以当第一等组织维度**——说不出「我是什么」但秒答「什么绝对不行」的创作者,禁令清单就是骨架;②**次序本身可以是铁律**(先痛后卖),不只是内容主张;③判定不了的主张降级为倾向,绝不硬凑阈值;④单产线绝不硬拆家族;⑤`produces` 写自造串完全合法——框架静默登记,管线外加 `routing:"none"` 即可,不逼创作者学管线词汇。
1
+ # 种子 · 家居好物带货栏目(「李姐严选」削减版)
2
+
3
+ 一人主理的家居好物口播带货号。访谈收敛出的家族:**1 个 skill(单产线不切)+ 词表并入 SKILL.md**。
4
+
5
+ ## 组织维度(全部来自栏目主自己的语言)
6
+
7
+ - **Step 1 = 痛点**:她的第一判断是「这货到底解决啥难受」——痛点必须**能拍出来**(一滩酱油/一声「咔」/一个乱抽屉),开头三秒戳它;且次序铁定「先戳痛点再亮卖点,反了人就划走」。痛点找不着,这单不接。
8
+ - **第二维度 = 上手**:信任感的唯一来源是「真人上手」——手 + 货 + 使劲的动作同画面,环境必须是过日子的地方;演不出来的卖点降级为嘴上带过,不给镜头。
9
+ - **第三维度 = 砸价**:价格是一个「出场动作」,不是一条信息——三选一判定(手上动作 / 憋一下再喊 / 全屏只剩一个大数),且砸之前全篇不许漏价。
10
+ - **第四维度 = 现在就买的理由**:结尾闭环,最后一句必须给一个说得出口的理由(马上用得上的场景 / 限时 / 赠品),不许只说「喜欢的拍」。
11
+ - **负面护栏 = 廉价感**:她说不出「风格是什么」,但对「什么显得廉价」秒答——七条禁令(综艺花字/满屏贴纸/「duang」类音效/抠图假背景/磨皮到看不清货/机器人配音/价格缩在角落小字)是全套规矩里最硬的资产。
12
+
13
+ ## 铁律(禁令先行的产物,节选)
14
+
15
+ - 廉价感七条禁令,中一条即重剪。
16
+ - 前三秒只许出现「难受」:不许品牌、自我介绍、价格、参数。
17
+ - 砸价三选一,占零样 = 念价格,返工;砸前漏价 = 白砸。
18
+ - 字幕最多两行大白字;真人原声,带口音也不换机器配音。
19
+ - 每条铁律配自检问句(例:「只看前三秒,看没看见一个具体的难受?」「砸价那一秒,三样占了几样?」「最后五秒能不能一句话复述那个现在就买的理由?」)。
20
+
21
+ ## 家族切分
22
+
23
+ 单产线不切家族:只有一条产线(带货片子),封面从片中截帧、不单独生产 → 1 个 skill 足够。`produces` = 自造串「带货台本」,查 handoff 映射表未命中注册集 → 无契约绑定,登记加 `routing:"none"`。
24
+
25
+ ## 词表(并入 SKILL.md 一节)
26
+
27
+ 已沉淀自造词,但家族仅 1 个 skill、无跨文件漂移面 → 词表并入 SKILL.md,并写明「出现第二个 skill 时整节迁出为 `_shared` 词表,各 skill 引用不复制」。词条(全部她的原词):
28
+
29
+ **痛点 / 卖点 / 上手 / 砸价 / 信任感 / 廉价感 / 划走 / 台本**(产物名)。
30
+
31
+ ## 自检结构
32
+
33
+ 自检清单逐条对应铁律,问句全部可判定、且用她的词(「砸价那一秒三样占了几样?」而非「价格强调是否充分?」)。给不出判定阈值的主张(「亮堂」「干净」「东西少」——她的原话「说不上数,凭眼睛」)降级为「倾向」,单列一节,不进铁律、不进自检硬条目。
34
+
35
+ ## 这个种子教你什么
36
+
37
+ 维度名(痛点/上手/砸价/廉价感/划走)**只属于这个栏目**。可迁移的是形态:①**负面维度可以当第一等组织维度**——说不出「我是什么」但秒答「什么绝对不行」的创作者,禁令清单就是骨架;②**次序本身可以是铁律**(先痛后卖),不只是内容主张;③判定不了的主张降级为倾向,绝不硬凑阈值;④单产线绝不硬拆家族;⑤`produces` 写自造串完全合法——框架静默登记,管线外加 `routing:"none"` 即可,不逼创作者学管线词汇。
@@ -1,35 +1,35 @@
1
- # 种子 · 心理学人文栏目(《实在界漫游指南》削减版)
2
-
3
- 一人公司的心理学/人文知识口播频道。访谈收敛出的家族:**4 个 skill + 1 份共享词表**。
4
-
5
- ## 组织维度(全部来自栏目主自己的语言)
6
-
7
- - **Step 1 = 叙事功能**:栏目主的第一判断是「这段话在叙事里干什么」——七个功能各占三阶段结构的一个位置(钩子/打击/翻译/坠落/抱持/升华/回扣),另有一个不占位置的修辞强调(金句大字)。**组件按叙事职责分类,不按形状分类**——这是他自己说出的核心取向。
8
- - **第二维度 = 主题变体**:每期有一个「容器概念」(借一个学科意象翻译心理理论),容器决定当期强调色;跨期不变项(字体/间距/单点强调色纪律)与可变项(accent/底色)显式两栏。
9
- - **第三维度 = 时间**:长段叙事按内部 Act 切分 + 元素生命周期表(哪个元素哪一刻入场/退场)。
10
-
11
- ## 铁律(禁令先行的产物,节选)
12
-
13
- - 绝不引入平台角标水印;绝不用渐变/3D/投影(涵容类软轮廓除外)。
14
- - 单点强调色纪律:一个画面最多一个红点,**且不是每个画面都要有**——只有需要明显强调的画面才加(稀缺性=强调的前提,实测泛滥即审美疲劳)。
15
- - 概念词首次亮相 = 衬线 Heavy 大字加宽字距的固定仪式,第二次出现即降回正文。
16
- - 每条铁律配自检问句(例:「这一镜真的需要红点吗?」「同画面字号层级 ≤3?」)。
17
-
18
- ## 家族切分(按 handoff 类型)
19
-
20
- | skill | 产什么 | produces | 契约 |
21
- |---|---|---|---|
22
- | 拆分派单器 | 全片 beat 派单文档 | —(管线文档生产者,不登记) | — |
23
- | 动态图生成 | HTML 动画颗粒 | MG | gsap-emit v1(合规项进自检) |
24
- | AI 再现分镜 | 双语分镜提示词文本 | AI_DRAMA | 暂无契约 |
25
- | 封面设计 | 文生图 prompt + 排字工作台 | cover + routing:"none" | 管线外 |
26
-
27
- 每个 skill 开头声明「这个 skill 不做什么 → 找谁」。
28
-
29
- ## 共享词表(漂移的解药)
30
-
31
- 叙事功能枚举曾在 6 处独立定义、数目口径打架;颜色 token 双份硬编码。收口后:一份 `_shared/<栏目>/vocab.md` 单点定义(枚举/色值/叫法/悬置区),各 skill 引用不复制,「新词先入表再用」。
32
-
33
- ## 这个种子教你什么
34
-
35
- 维度名(叙事功能/容器/红点)**只属于这个栏目**。可迁移的是形态:①用户的 Step 1 就是 skill 的 Step 1;②禁令比正面描述硬;③铁律必配自检;④多产线才切家族、切了就要互相路由;⑤共享词一旦出现在两个 skill 里就该进词表。
1
+ # 种子 · 心理学人文栏目(《实在界漫游指南》削减版)
2
+
3
+ 一人公司的心理学/人文知识口播频道。访谈收敛出的家族:**4 个 skill + 1 份共享词表**。
4
+
5
+ ## 组织维度(全部来自栏目主自己的语言)
6
+
7
+ - **Step 1 = 叙事功能**:栏目主的第一判断是「这段话在叙事里干什么」——七个功能各占三阶段结构的一个位置(钩子/打击/翻译/坠落/抱持/升华/回扣),另有一个不占位置的修辞强调(金句大字)。**组件按叙事职责分类,不按形状分类**——这是他自己说出的核心取向。
8
+ - **第二维度 = 主题变体**:每期有一个「容器概念」(借一个学科意象翻译心理理论),容器决定当期强调色;跨期不变项(字体/间距/单点强调色纪律)与可变项(accent/底色)显式两栏。
9
+ - **第三维度 = 时间**:长段叙事按内部 Act 切分 + 元素生命周期表(哪个元素哪一刻入场/退场)。
10
+
11
+ ## 铁律(禁令先行的产物,节选)
12
+
13
+ - 绝不引入平台角标水印;绝不用渐变/3D/投影(涵容类软轮廓除外)。
14
+ - 单点强调色纪律:一个画面最多一个红点,**且不是每个画面都要有**——只有需要明显强调的画面才加(稀缺性=强调的前提,实测泛滥即审美疲劳)。
15
+ - 概念词首次亮相 = 衬线 Heavy 大字加宽字距的固定仪式,第二次出现即降回正文。
16
+ - 每条铁律配自检问句(例:「这一镜真的需要红点吗?」「同画面字号层级 ≤3?」)。
17
+
18
+ ## 家族切分(按 handoff 类型)
19
+
20
+ | skill | 产什么 | produces | 契约 |
21
+ |---|---|---|---|
22
+ | 拆分派单器 | 全片 beat 派单文档 | —(管线文档生产者,不登记) | — |
23
+ | 动态图生成 | HTML 动画颗粒 | MG | gsap-emit v1(合规项进自检) |
24
+ | AI 再现分镜 | 双语分镜提示词文本 | AI_DRAMA | 暂无契约 |
25
+ | 封面设计 | 文生图 prompt + 排字工作台 | cover + routing:"none" | 管线外 |
26
+
27
+ 每个 skill 开头声明「这个 skill 不做什么 → 找谁」。
28
+
29
+ ## 共享词表(漂移的解药)
30
+
31
+ 叙事功能枚举曾在 6 处独立定义、数目口径打架;颜色 token 双份硬编码。收口后:一份 `_shared/<栏目>/vocab.md` 单点定义(枚举/色值/叫法/悬置区),各 skill 引用不复制,「新词先入表再用」。
32
+
33
+ ## 这个种子教你什么
34
+
35
+ 维度名(叙事功能/容器/红点)**只属于这个栏目**。可迁移的是形态:①用户的 Step 1 就是 skill 的 Step 1;②禁令比正面描述硬;③铁律必配自检;④多产线才切家族、切了就要互相路由;⑤共享词一旦出现在两个 skill 里就该进词表。
@@ -1,4 +1,4 @@
1
- interface:
2
- display_name: "视频转文字稿"
3
- short_description: "将本地视频整理为带总结与时间戳的单一 Markdown"
4
- default_prompt: "Use $gtrk-transcript to turn my local video into one Markdown transcript with an Agent-written summary."
1
+ interface:
2
+ display_name: "视频转文字稿"
3
+ short_description: "将本地视频整理为带总结与时间戳的单一 Markdown"
4
+ default_prompt: "Use $gtrk-transcript to turn my local video into one Markdown transcript with an Agent-written summary."