Gitruck/cli / skills/gtrk-style-maker
gtrk-style-maker
Verified能生产 skill 的 meta skill——通过启发式访谈引导视频创作者想清楚**他自己的**视觉语法,并把它落成**他自己的可执行 skill 家族**(黑盒、留本地)+ 栏目内共享词表 + 栏目配置登记。框架对审美零预设:不假设你有叙事结构、有容器概念、视觉分 MG/AI——你的维度(k)和取值(v)全部由你自己定义,本 skill 只提供「怎么想清楚」的工艺。当用户想「建一个新栏目/新频道的风格体系」「把我的审美沉淀成 skill」「做一个我自己的视觉 skill」「定义栏目风格规范/视觉语法」「栏目配置文档的 style 怎么填」「给我的栏目造一套创作工具」时使用本 skill。产出的 skill 通过通用 skills 适配器安装到当前或多个 Agent,登记进 gtrk 栏目配置(style.skills)。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.4 KB |
| references/ammo.md | markdown | 1.5 KB |
| references/contracts-ref.md | markdown | 865 B |
| references/craft-output-spec.md | markdown | 4.4 KB |
| references/seeds/README.md | markdown | 594 B |
| references/seeds/seed-ecom-home-goods.md | markdown | 3.6 KB |
| references/seeds/seed-psych-humanities.md | markdown | 2.7 KB |
references/craft-output-spec.md
View on GitHub# 产出物规范(craft-output-spec)
## 1. 用户 skill 目录解剖
```
<skill-name>/
├── SKILL.md # 必须。frontmatter: name + description(description 即触发器)
├── README.md # 必须。对人类的说明 + 「正本→安装」单向流声明(spec MUST)
├── references/ # 按需。深文档(渐进披露:SKILL.md 装不下的细则放这里)
├── assets/ # 按需。exemplar 成品/模板/素材
└── scripts/ # 按需。可执行工具
```
- **frontmatter 最小集**:`name`(kebab-case)+ `description`。description 决定触发——包含功能关键词 + 「当用户想「…」时使用本 skill」+ 触发短语枚举。这是生态实证的唯一触发机制,没有独立 trigger 字段。
- **自足性铁律**:skill 里要含齐干活所需的全部信息(或明确引用哪里查),不让运行时去猜。
- **正文结构由访谈维度决定**——用户的 Step 1 是什么,skill 的 Step 1 就是什么。唯一必备的三个小节:铁律(含禁令)、交付前自检清单、(多 skill 家族时)「这个 skill 不做什么 → 找谁」。
## 2. 「正本→安装」单向流(写进产出 skill 的 README)
> 本 skill 源码正本在 `<用户作坊路径>`;Agent 的 skills 目录是安装产物。改动**永远先改正本**,再运行 `npx -y skills@1.7.4 add "<用户作坊路径>/<name>" -g -y -a <首次安装时用户选定的 agent-id>` 重新安装(`-a` 可重复;用户当初选了「全都装」才省掉)。通用适配器负责 Agent 探测、目录映射,以及统一正本到各宿主的 symlink/junction;需要独立副本时才加 `--copy`。云端上传是可选的第三级分发,同样以作坊正本打包。
> ——副本漂移是有血泪教训的(同一枚举曾在 6 处定义、口径打架),单向流是唯一解法。
## 3. 共享词表(条件产出)
触发条件(任一):家族 ≥2 个 skill;访谈沉淀出自造词。
形态:单独一份 `_shared/<栏目>/vocab.md`(下划线前缀防误认成 skill),条目 = 词 + 定义 + 取值(如有)。各 skill **引用不复制**(需要内联值时标注「正本在词表,改值先改那里」)。文件头写治理规则:「新词先入表再用」。
不满足条件时:词表内容并入 SKILL.md 一节。
## 4. 栏目配置登记
- 位置:以 gtrk paths 口径为准(当前 `~/.gitruck/columns/<栏目id>.json`;权威在 CLI 的 paths 模块,本文档不是路径权威源)。
- 写法:**追加**进 `style.skills` / `style.shared` 数组,绝不清空既有条目;文件不存在则创建最小骨架。
- 条目:`{ "id": "<skill-name>", "ref": "<正本绝对路径>", "produces": "<handoff 类型或用户自造串>" }`。
- `routing:"none"` 的语义是「跳过我」(消费方按惯例跳过该条目,用于退役 / 显式停用,配合 `status` 注明缘由)——**不是**「管线外产物」的标配:产线若存在消费方框架 skill(如封面 → `/gtrk-cover` 消费 `produces=="cover"`),**活跃条目不要加** `routing:"none"`,否则会被消费方跳过;只有确无任何消费方、又想豁免疑似拼写提示的纯登记条目才加。
- `produces` 是登记不是审批:写用户自造串完全合法(框架静默惰性登记);只有命中管线 handoff 注册集的才参与派单路由。
## 5. 契约绑定
查 `contracts/handoff-contracts.json`(随 @gitruck/cli 分发,包内相对路径 `contracts/`;本 skill 安装后可从 CLI 包根定位)。规则:
- `produces` 命中注册集 **且** 映射表给出契约 → 生成的 skill 必须:①引用「契约名+版本」(如 `gsap-emit v1`,契约文档在 `contracts/<doc>`);②把契约合规项列进自检清单(如:template 包裹?paused 时间线注册?无 random/Date?字面值无 var()?)。
- 映射为 `null`(暂无契约)或管线外产物 → 无绑定要求,照常生成。
- **永远查表,不硬编码映射**——契约升版/新增时表会更新。
## 6. 收尾提醒(给用户)
- skill 留本地即完整可用;上传到 agent 产品的云端 skill 市场(按其要求打包)是**可选**分发,供网页/移动端触发。
- 后续迭代:改作坊正本 → 重跑 `npx -y skills@1.7.4 add "<正本目录>" -g -y -a <选定的 agent-id>` → (可选)重新打包上传。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |