原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚 登录

oil-cover Skill

代码仓库 ↗

作者:oil-oil★ 3031 个 skill

安装

能做什么

Video cover & thumbnail skill for Claude Code & Codex. 帮你用视频画面做小红书和 B 站封面。

作者提供的原文

  • 连接方式 供 AI 读取的指令文件,其中有调用外部服务的步骤
  • 账号或密钥 有些步骤需要 ZENMUX_API_KEY 的密钥(依据 README)
  • 分类 设计与网页
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/oil-oil-oil-cover.svg)](https://mcp.popnx.com/en/skills/oil-oil-oil-cover)

可搭配使用

在同一工作中把 AI 连到服务的 MCP

Next AI Draw.io

draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand

作者:DayuanJiang广泛使用↓ 2.2万/周★ 3.7万 整个仓库的星标6天前更新

MCP · 连接服务在你的电脑上运行

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

作者:pascalorg广泛使用↓ 1037/周★ 2.6万 整个仓库的星标前天更新

MCP · 连接服务电脑或云端✓ 服务方 · pascal.app

Semiotic

Verified React chart generation: select, validate, repair, render, and inspect charts through MCP.

作者:nteract广泛使用↓ 8456/周★ 2716今天更新

MCP · 连接服务电脑或云端

相似的 Skill

同类工作,排序与 Skill 列表相同

与相似项目对比
本项
oil-cover
impeccablediagram-designfrontend-slidesguizang-ppt-skill
作者oil-oilpbakauscathrynlaveryzarazhangruiop7418
Skill 数11111
GitHub 星标303113,53668,71332,63930,137
最近代码更新2026年11月16日2026年11月20日2026年11月19日2026年6月24日2026年10月30日
许可证–Apache-2.0MITMITAGPL-3.0

oil-oil 提供的 1 个 Skill(指令集),AI 读取后照做 · 不是 MCP server

Skill 和 MCP 有什么不同

MCP = 手

把 AI 连到外部服务或数据,例如读取 Notion 或开发票。需要有程序或服务器在运行。

Skill = 手册

教 AI 怎么做某项工作的文本文件,不连接任何服务。

有些会重叠:少数 Skill 带有调用工具的脚本,少数 MCP 只提供知识。请从你想完成的工作出发。

适用的应用

CodexCursor

依据开发者 README 和 repo 中的文件夹

安装

安全吗?

  • 作者

    GitHub 账号 oil-oil(个人),已创建 7 年

  • 使用与维护

    ★ 303 星,目前用户较少 · 代码最近更新 2026年11月16日

  • 有脚本吗?

    有 22 个可以在电脑上运行的脚本:scripts/credential-ui/public/app.js, scripts/credential-ui/public/favicon.svg, scripts/credential-ui/public/index.html, scripts/credential-ui/public/style.css 另外还有 18 个文件

  • 会联网吗?

    会联网的脚本:scripts/credential-ui/tests/profile.test.ts, scripts/credential-ui/tests/native-smoke.ts, scripts/credential-ui/web/app.ts, scripts/credential-ui/public/app.js

  • 会修改整台电脑的设置吗?

    没有发现 hook 或写入电脑设置的操作

根据仓库 commit dde9572 中的文件自动检查(只读取文件,没有运行任何内容)。这不是安全保证,请自己阅读后再决定

第一步:你用哪个 AI?

选择你用的应用,本页只显示该应用的安装方法

方式 1上传到 claude.ai(网页和应用)

  1. 从 GitHub 下载

    这个 Skill 没有说明许可证,所以我们不在网站上提供 ZIP。请从 GitHub 下载并自己整理文件夹,或者用上面的"让 AI 帮你安装",更简单

    从 GitHub 下载(整个仓库)↗

    解压后,只把 oil-cover 文件夹重新压缩。ZIP 的最上层必须是包含 SKILL.md 的 oil-cover 文件夹,不能直接放散乱的文件

  2. 打开 claude.ai 的 Skills 页面并上传

    +Create skillUpload a skill选择文件 oil-cover.zip

    打开 claude.ai/customize/skills ↗

  3. 看不到 Upload 按钮?请先开启创建文件的权限

    SettingsCapabilitiesCode execution and file creation

    Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free

Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)

Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)

Checked against official docs 2026年11月12日 · Source: support.claude.com, support.claude.com, code.claude.com

方式 1让 Claude Code 帮你安装

复制这句话,粘贴到 Claude Code 的对话中

安装到哪里

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

如果只用于一个项目,请粘贴到在该项目文件夹中打开的对话里 · AI 在安装前一定会先告诉你路径

AI 会先说明要做什么,每一步都会征求你的同意

重新打开 Claude Code,输入 /oil-cover,或直接提出相关任务,Claude 会自动选用

Checked against official docs 2026年11月12日 · Source: code.claude.com

适合使用 Terminal 的人

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

开发者推荐的方式

安装 Node.js(如果还没有)

已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

node -v
  • 显示版本号(例如 v26.13.1)= 已安装,可跳过这一步
  • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端

Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令

打开 Node.js 下载页 ↗

装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v

安装一次,所有需要 Node.js 的工具都能用

正在检查命令 · 通过后才会显示复制按钮

摘自开发者 README,会下载并运行开发者的代码

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.claude/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

  3. 重新打开 Claude Code,输入 /oil-cover,或直接提出相关任务,Claude 会自动选用

自己安装的 Skill 可用于 ChatGPT 桌面应用、Codex CLI 和 IDE 中的 Codex 扩展 · 网页版和手机版 ChatGPT 不能使用自己安装的 Skill,只能使用目录中插件自带的 Skill

ChatGPT 桌面应用

ChatGPT 桌面应用内置 Codex,Codex 从 ~/.agents/skills 文件夹读取 Skill

方式 1让 ChatGPT 帮你安装

在 ChatGPT 桌面应用中打开 Codex,把这句话粘贴到对话中

安装到哪里

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

AI 在安装前一定会先告诉你路径

AI 会先说明要做什么,每一步都会征求你的同意

方式 2自己放入文件夹

把 oil-cover 文件夹放到 ~/.agents/skills/oil-cover

~ 是你的主文件夹($HOME)

适合使用 Terminal 的人

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.agents/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

安装之后

  • ChatGPT 桌面应用:打开侧边栏中的 Skills,确认 Skill 已出现
  • 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称
  • Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

网页版和手机版 ChatGPT

不能使用你自己安装的 Skill,只能使用目录中插件自带的 Skill

想在 ChatGPT 中使用这个 Skill,请按上面的方法使用 ChatGPT 桌面应用

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

方式 1让 Codex 帮你安装

复制这句话,粘贴到 Codex 的对话中 · 适用于 ChatGPT 桌面应用中的 Codex、Codex CLI 和 IDE 扩展

安装到哪里

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

如果只用于一个项目,请粘贴到在该项目文件夹中打开的对话里 · AI 在安装前一定会先告诉你路径

AI 会先说明要做什么,每一步都会征求你的同意

Codex 会自动发现新安装的 Skill;如果没有出现,请重启 Codex · 使用方法:在 ChatGPT 中输入 @ 并选择 Skill · 在 Codex CLI 或 IDE 扩展中运行 /skills,或输入 $ 加 Skill 名称

Checked against official docs 2026年11月15日 · Source: learn.chatgpt.com

适合使用 Terminal 的人

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.agents/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

  3. 重新打开 Codex 并提出相关任务,Codex 会列出这个 skill

方式 1让 Cursor 帮你安装

复制这句话,粘贴到 Cursor 的对话中

安装到哪里

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

如果只用于一个项目,请粘贴到在该项目文件夹中打开的对话里 · AI 在安装前一定会先告诉你路径

AI 会先说明要做什么,每一步都会征求你的同意

在 Cursor 的 Agent 聊天中输入 / 并选择 oil-cover

Checked against official docs 2026年11月12日 · Source: cursor.com

适合使用 Terminal 的人

Skill 是 AI 会照做的指令。安装前先阅读文件,只安装可信开发者的 Skill。

  1. 打开终端

    Mac:按 Command+空格输入 Terminal · Windows:下方命令在 PowerShell 中无法使用,请改用上方的“让 AI 帮你安装”

  2. 把 skill 文件夹复制到 ~/.cursor/skills

    这条命令把 repo 下载到临时文件夹,只复制含 SKILL.md 的文件夹

    正在检查命令 · 通过后才会显示复制按钮

  3. 在 Cursor 的 Agent 聊天中输入 / 并选择 oil-cover

方式 1让 AI 帮你安装

适用于其他能读取 Skill 的应用。这句话列出了 Claude Code、Codex 和 Cursor 的路径,AI 会按你的应用选择 · 复制这句话,粘贴到应用的对话中

安装到哪里

正在检查命令 · 通过后才会显示复制按钮

正在检查命令 · 通过后才会显示复制按钮

如果只用于一个项目,请粘贴到在该项目文件夹中打开的对话里 · AI 在安装前一定会先告诉你路径

AI 会先说明要做什么,每一步都会征求你的同意

Checked against official docs 2026年11月12日 · Source: code.claude.com, learn.chatgpt.com, cursor.com

适合使用 Terminal 的人

其他支持 Agent Skills 的应用(如 Gemini CLI、GitHub Copilot)使用不同文件夹,请查看该应用的指南,再把含 SKILL.md 的文件夹复制过去。

在 GitHub 上查看 ↗

已于 2026年11月11日 对照 Claude Code、Codex 和 Cursor 官方指南核实 skill 文件夹

查看原始 SKILL.md

以下文字来自开发者的 repo,不是 PopNx MCP 的指令

显示前 8,000 个字符 · 在 GitHub 打开完整文件

---
name: oil-cover
description: 生成小红书和 B 站 AI 工具实操视频封面,支持脚本模式与 Agent 自主模式、真实视频证据、三画幅输出和可选创作者头像。仅在用户明确提到 oil-cover、$oil-cover、使用 oil-cover 或指定本 Skill 时触发;普通封面、首图、视频封面请求不要自动触发。
---

# oil-cover

为小红书 AI 工具实操内容生成稳定、清楚、干净、精致的视频封面。执行模式以用户配置为准;两种模式遵循同一套标题、产物和验收规则。

先检查当前视频已有产物:源视频、审校字幕、标题、画幅和头像配置未变且最终图已经验收时,直接复用。缺哪一版只生成哪一版;只改头像时复用无人物底图。用户选定已有版本后停止其他候选的生成。两种模式均遵守这条恢复规则,不因分析文件格式不同重做已有封面。

## API Key 配置入口

需要外部服务凭据时先读[API Key 配置与业务读取](references/api-key-setup.md):复用已有安全入口;本机缺少 Key 时使用随附固定页面,保存后通过业务包装入口读取。内置能力与纯本地流程不要求配置 Key。

## 两种执行模式

- **模式一 · 脚本模式(默认)**:把活儿交给 `generate_oil_cover.py`,由脚本调用外部视觉服务完成选帧分析,并生成无人物底图;用户配置启用创作者头像时,再用确定性代码把透明头像合成到右下角。需要 Python、ffmpeg、Pillow 和所选服务的 API Key。下面「默认入口」到「输出说明」描述的都是这一模式。
- **模式二 · Agent 自主执行**:复用宿主视觉与内置生图能力,无需额外服务 Key,由执行的 Agent 自己读 SOP 完成选帧、分析和生图;用户配置启用头像时,再调用项目脚本的头像合成函数。完整流程见 `references/agent-native-flow.md`。

## 安装位置与用户配置

不要假设用户名、Skill 安装目录、视频库、脚本、素材镜像或密钥位置。

- `SKILL_DIR`:当前这份 `SKILL.md` 所在目录。
- 用户配置:`${OIL_COVER_CONFIG:-$HOME/.oil-cover/config.json}`。它属于本机用户,不进入 Skill 仓库。
- Skill 内脚本:`$SKILL_DIR/scripts/generate_oil_cover.py`。若安装包没有脚本,读取配置里的 `script_path`;两者都不存在时说明安装不完整,不要猜个人目录。
- Skill 内资产:`$SKILL_DIR/assets/`。额外素材镜像仅从配置 `product_asset_mirror` 读取。
- API key:优先使用 `ZENMUX_API_KEY`;备用文件仅从 `api_key_file` 配置或 `--api-key-file` 读取。不要把 key 或个人绝对路径写进 Skill 仓库。

支持的用户配置:

```json
{
  "mode": "agent-native",
  "creator_name": "optional creator name",
  "script_path": "/optional/path/to/generate_oil_cover.py",
  "video_library_root": "/optional/path/to/video-library",
  "product_asset_mirror": "/optional/path/to/shared-product-assets",
  "api_key_file": "/optional/path/to/zenmux-key",
  "creator_portrait": {
    "enabled": false,
    "path": "/optional/path/to/portrait.png"
  }
}
```

路径允许使用 `~`,读取后必须展开。没有配置 `video_library_root` 时,所有持久产物默认跟随输入视频。配置后,同一视频的持久资源统一放进 `<video_library_root>/<视频标题>/`;从导出暂存目录开始处理时,先无覆盖地归位源视频,再生成字幕、封面和 sidecar。

### 选哪个模式(设一次,以后不问)

每次触发 oil-cover 时按这个顺序决定:

1. 先读用户配置的 `mode` 字段。
2. 已设为 `script` 或 `agent-native` → **直接按该模式执行,不再询问**。
3. 未设置(第一次)→ 问用户一次默认想用哪种模式,说明这是一次性设置;拿到答案后更新用户配置,再按选择执行。保留文件里的其他配置键,不要整份覆盖:

   ```bash
   mkdir -p "$(dirname "${OIL_COVER_CONFIG:-$HOME/.oil-cover/config.json}")"
   # 合并写入 {"mode":"agent-native"},或设为 "script"
   ```

4. 用户随时可说「切换 / 改成 X 模式」覆盖默认(重写该文件),或在单次任务里临时指定某模式而**不**改默认偏好。

**前提与回退**:模式二要求执行 Agent 具备多模态视觉 + 支持参考图的生图工具,通过当前宿主实际提供的工具判断,不根据宿主品牌推断。若 `mode=agent-native` 但当前环境跑不了生图这一步,说明情况并给两条路——使用具备所需能力的宿主,或在已授权的服务范围内临时使用脚本模式——不要静默失败,也不要擅自改掉用户的默认偏好。

走模式二时,先完整读 `references/agent-native-flow.md` 和 `references/cover-rules.md`,按 SOP 执行,**忽略下面所有针对脚本的参数与说明**。

## 修改已有风格

用户反馈字号、留白或局部排版时,默认只调整对应问题,保留原有字体气质、配色体系、透视、装饰和主体表达。先保留可回退的图片与提示词,再做最小修改;未明确要求更换风格时,不全面重写视觉规范。

## 封面标题提炼(执行者职责)

封面主标题由执行本 skill 的 Agent 在跑脚本**之前**自己提炼,不交给脚本里的分析模型做,避免它理解错内容:

- 用户已经指定封面标题,或要求“封面也用文件名”时,直接锁定原文,只做视觉断行;只有未指定时才按下述方法提炼。视频文件名、封面标题、发布标题分别记录,不能互相覆盖。平台发布标题的长度限制不用于缩短封面标题。
- 视频标题只是主题输入,封面主标题不必和它一模一样。要突出这条视频最有分量的重点:结论、评价、对比、数字。
- **字数与品牌名解耦(防字号缩水)**:Agent 自拟主标题时,默认提炼为 **`2 行 × 3–5 字`(最佳 `4+4` 字,两行用空格分隔,如 `"AI 写前端 风格统一"`、`"后台设计 更有质感"`、`"一眼看懂 代码改动"`)**。不要把长英文品牌名或工具名(如 `Claude Code`、`GitHub Copilot`、`Screen Studio`)硬塞进主标题行内凑成 7–8 个字符导致整块标题字号被迫缩小;长品牌名应拆为标题上方的独立品牌小标(small product mark / eyebrow lockup),把主标题空间留给两行超大字(短词如 `AI` 除外)。
- 有字幕或文稿时(`.srt`/`.ass`/`.txt`,或视频旁的同名字幕文件)先通读一遍再提炼。`.ass`/`.srt` 先抽成纯文本(去掉时间轴和样式标记)。优先借用视频里的原话强词(例如口播里的「目前最强」「指哪打哪」这类明确判断),忠于内容,不夸大、不编造评价。
- 没有字幕、文稿或用户补充时,才退回视频标题本身做克制的精简。
- 提炼结果通过 `--title` 传给脚本;抽好的纯文本字幕通过 `--subtitle` 传入,供分析模型选帧、写副标题和点缀使用。分析模型会把 `--title` 当作已定稿的封面主标题,只做断行和排版,不再改写。
- **独立理解检查**:封面脱离文件名、正文和此前对话时,也要让第一次看到的人马上知道主题。主标题优先写清“对象 + 具体任务或结果”;不要单独用依赖上下文的反转短语(如“不只 X”)、泛化形容词或悬念句代替主题。若使用这类表达,副标题必须同时点明具体对象和结果。生成后只看封面做一次理解检查;仍说不清视频讲什么,就改写标题并重新生成、检查全部画幅。

## 默认入口

将实际存在的生成脚本绝对路径记为 `OIL_COVER_SCRIPT`。默认运行以下命令;有字幕时额外添加 `--subtitle "<实际纯文本字幕路径>"`,没有字幕时省略该参数:

```bash
node "$SKILL_DIR/scripts/credential-ui/src/profile.ts" run default -- python3 "$OIL_COVER_SCRIPT" \
  --video "<视频路径>" \
  --title "<提炼后的封面主标题>" \
  --topic "<补充背景>"
```

如果用户提供的是截图或已选关键帧:

```bash
node "$SKILL_DIR/scripts/credential-ui/src/profile.ts" run default -- python3 "$OIL_COVER_SCRIPT" \
  --image "<截图或关键帧路径>" \
  --logo "<可选 Logo 路径>" \
  --title "<标题或主题>" \
  --topic "<补充背景>"
```

默认不传 `--aspect` 时,脚本会并行生成小红书 `3:4` 竖屏版、通用/B 站首页主封面 `4:3` 横屏版和 `16:9` 横屏版。只重跑或按需生成部分画幅时使用 `--aspect both`(`3:4` + `4:3`)、`--aspect 3x4`、`--aspect 4x3`、`--aspect 16x9` 或逗号组合(如 `3x4,4x3`、`4x3,16x9`)。

## 进阶参数

- `--subtitle <脚本/字幕/转录文件>`:把上下文喂给 Gemini,帮助判断主题、标题措辞和证据选择。有完整文稿时优先加上。
- `--logo <Logo 路径>`:可多次传入多个产品 Logo 作为参考资产。
- 自动 Logo 匹配只把 `--title` 和 `--topic` 当作主产品依据。只要其中任一存在,就不再扫描字幕寻找 Logo,避免把口播里的次要产品错当成主产品。
- 主产品没有可信 Logo 资产时保持无外置 Logo,不拿字幕中的其他品牌代替,也不让生图模型发明近似标识;此时用准确产品名和真实界面建立识别。
- 如果标题、字幕、视频画面或截图能明确判断主产品有 Logo,但 `references/product-assets.md` 暂时没有对应资产,先联网寻找官方或可信来源的透明 PNG,归档到 `$SKILL_DIR/assets/product-logos/`;配置了 `product_asset_mirror` 时再同步到镜像目录。通过 `--logo` 传给脚本,高频复用的产品同步补充到 `product-assets.md` 和脚本的自动匹配表。
- 取帧策略是「本地预筛」:脚本用 ffmpeg 低分辨率扫描整段视频,对每帧算清晰度(拉普拉斯方差)、亮度、内容度,硬过滤掉黑屏/纯白/纯色/loading/模糊帧,再按时间分桶取每段最清晰的一帧,产出若干**真实高清候选**交给分析模型按语义挑最佳帧。全程不调模型选帧、不上传整段视频。这是唯一的自动取帧路径,没有旧的「视频选帧」/均匀盲采兜底——预筛若失败会直接报错,不会静默降级。
- `--frame-count <N>`:本地预筛产出多少个候选帧供分析模型挑选,默认 8。候选越多模型选择越好,但分析请求越大。
- `--scan-fps <N>`:本地预筛扫描的采样帧率,默认 0=自动(≤5 分钟视频用 2fps,更长用 1fps)。想抓更细的瞬间可调高。
- `--candidate-seconds 1,8,24.5`:手动指定取帧时间点,跳过本地预筛。已经知道哪几秒是关键画面时用。
- `--aspect all|both|3x4|4x3|16x9|组合`:默认 `all` 并行生成三版;`both`(或 `3x4,4x3`)只生成 `3:4` 和 `4:3`;单独生成或重跑时传入指定画幅或逗号组合(如 `4x3,16x9`)。
- `--cover-state-file <状态文件路径>`:可选,每完成或失败一个画幅立即原子写入 JSON 状态(含 `generated` 与最终路径),供并行发布编排实时追踪各画幅进度。
- `--bilibili-size <尺寸>`:B 站个人空间 `16:9` 伴随版的 API 尺寸,默认 `1280x720`;B 站个人空间槽使用此 `16:9` 文件独立上传。
- 副标题默认放开。如需禁用副标题、让外层只剩主标题,传 `--no-allow-subtitle`。
- 创作者头像由本地代码在生图后合成,不作为 Gemini 或 `gpt-image-2.5-flare` 的参考图上传。是否启用及素材路径来自用户配置;公开 Skill 默认关闭。默认布局参数为:3:4 宽约 55%、顶部约 58%、向右越界约 6%;4:3 宽约 38%、顶部约 40%、向右越界约 3%;16:9 宽约 32%、顶部约 40%、右侧内收约 2%。
- 用户明确要求无人物封面时传 `--no-default-creator-portrait`。配置启用头像时默认保留;未配置时保持无人物。

排查与验证:

- `--dry-run`:不调任何 API,只准备本地文件和 prompt,用于核对路径、规则文件和素材是否就位。
- `--skip-generate`:只跑 Gemini 分析和写 prompt,不调用图片 API。用来看 Gemini 选了哪一帧、标题怎么断行、prompt 写成什么样。
- `--generation-only`:用 `/images/generations` 而非 `/images/edits`,屏幕帧和 Logo 参考图不上传给图片 API;头像启用时始终只在本地合成。

## 脚本职责

- 脚本路径:优先 `$SKILL_DIR/scripts/generate_oil_cover.py`,否则使用用户配置 `script_path`
- 默认分析模型:`google/gemini-3.8-flash`
- 默认生图模型:`openai/gpt-image-2.5-flare`
- 默认规则文件:`references/cover-rules.md`
- 默认输出位置:视频(或图片)所在目录。最终封面命名 `<视频名>_3x4.png`、`<视频名>_4x3.png`、`<视频名>_16x9.png`,直接落在影片旁边方便查找;分析、prompt、原始响应等中间产物收进 `<视频名>.oil-cover/` 子目录。传 `--output-root` 可改到别处。

脚本负责用 ffmpeg 本地扫描+评分预筛出若干高清候选帧(默认策略,无需调模型),把候选交给视觉模型分析、由模型按语义选出最佳封面帧并生成封面方案和提示词、保存 sidecar、并行调用所选图片服务、生成无人物底图。用户配置启用头像时,再用 Pillow 把透明头像按画幅参数合成到右下角;头像不会进入 视觉或图片 API 的参考图列表。底图保存在 `<视频名>.oil-cover/<画幅>.generated-base.png`,合成记录保存在 `portrait_composite.json`,最终封面写到影片目录。本地预筛的打分明细写在 `<视频名>.oil-cover/frame_selection_local.json`。

## 何时读取参考文件

- 走模式二(Agent 自主执行)时,先完整读 `references/agent-native-flow.md`(流程 SOP)和 `references/cover-rules.md`(视觉规范)。
- 日常生成封面时(模式一),不需要手动读取完整视觉规范;脚本会把 `references/cover-rules.md` 传给 Gemini。
- 修改视觉规则、排查提示词遗漏、评审模型输出质量或调整脚本 guard 时,读取 `references/cover-rules.md`。
- 判断产品 Logo 或产品资产时,读取 `references/product-assets.md`。
- 新增产品 Logo、排查资产缺失或判断可信来源时,读取 `references/product-assets.md` 并按里面的补充规则执行。
- 如果用户要求复刻特定冲击型科技封面风格,读取 `references/impact-tech-cover-style.md`。

## 不可违反

- 生图模型必须一次性生成完整无人物底图,包括真实屏幕证据、标题、产品标识、点缀和风格化效果。
- 头像按配置直接合成,不要求预留避让空间,也不以头像遮挡为验收或返工条件。
- 本地后处理只允许执行一项:配置启用头像时,把配置的透明头像按固定参数 alpha 合成到右下角。不要本地贴字、贴 Logo、拼其他图片、重排、裁切改版或视觉修补。
- 源截图、重建 UI 和生图底图不保留人物、人脸、头像、摄像头气泡和真人画中画;配置启用头像时,最终封面只允许出现这一张代码合成的头像,否则最终封面保持无人物。
- 绝对不要把历史案例或上一次任务里的产品名、模型名、关键词、品牌色和点缀带入当前封面。所有外层文字和点缀都必须来自当前视频、当前标题、当前字幕、当前截图或当前用户补充信息。
- 外置产品 Logo 必须对应当前主标题或用户显式传入的参考资产;字幕里的次要品牌不能替代主产品,没有匹配资产时不放外置 Logo。
- 默认同时交付 `3:4`、`4:3` 和 `16:9` 三版;上游流程明确指定所需画幅集合(如未选 YouTube 时传 `--aspect both`)或单独重跑时,只生成指定画幅。
- 锁定标题的断行必须逐字拼回用户原题,不能在英文标识或版本号内部断开。写入生图 prompt 前统一替换完整标题指令,包括模型的逐行描述,只保留一套标题与断行;副标题和构图指令独立保留。重新应用 guard 后结果必须不变。
- 每次生图前保存 `.prompt.md` sideca

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

来自 GitHub

GitHub 星标
303
开发者
oil-oil
许可证
未注明许可证 此 repo 未注明许可证,默认作者保留所有权利;转发或商用前请先询问作者。
最近代码更新
2026年11月16日
repo 中的 SKILL.md 文件(含译本和模板)
1
主题
agent-skill, agent-skills, bilibili, claude-code, claude-skills, codex, codex-skill, content-creation, cover, cover-design, image-generation, skill