1实现原理 · 为什么它能做到
把“封面长什么样”拆成六个可确认的维度（Type/Palette/Rendering/Text/Mood/Font）+ 宽高比，每维都有取值枚举与默认值，最终拼成一份结构化 prompt。
skills/baoyu-cover-image/SKILL.md
Generate elegant cover images for articles with 5-dimensional customization.
注：SKILL.md 的 Five Dimensions 表给出每维取值与默认（Text 默认 title-only、Mood 默认 balanced、Font 默认 clean、Aspect 默认 16:9），Font 是第六个实际维度（描述里没数进去）。
维度缺省时有“内容信号 → 取值”的自动选择表：按关键词命中把内容类型、调色板、渲染手法、文字量、情绪、字体一一映射。
skills/baoyu-cover-image/references/auto-selection.md
When a dimension is omitted, select based on content signals.
注：例如 'Education, tutorial, knowledge, onboarding, concept explainer → macaron'、'Poster, movie, album, concert, silhouette, mondo, limited-edition → screen-print'；默认值集中在 Text/Mood/Font 三处。
确认是硬门禁：必须用宿主交互工具（AskUserQuestion 或等价物）把选项做成可点选问题，而不是甩一张文字表格。
skills/baoyu-cover-image/SKILL.md
**MUST use `AskUserQuestion` tool** to present options as interactive selection — NOT plain text tables.
注：最多 4 问一批；只有 --quick / quick_mode: true / 六维与 --aspect 全部指定时才跳过，且宽高比除非显式给 --aspect 否则永远要问。
生成前把 prompt 落盘成 prompts/cover.md（含 content context / visual design / text elements / mood / font / composition 分段），frontmatter 里带 references 列表。
skills/baoyu-cover-image/SKILL.md
Save to `prompts/cover.md`.
注：写入前要求自检参考图文件存在（test -f）；正文把色值限定为“渲染指引”，明令不得把 hex 或色名当成图上可见文字。
参考图是“高优先级视觉输入”，且明确警告只传 --ref 不够：必须同时在 prompt 文本里描述要复现什么。
skills/baoyu-cover-image/references/workflow/prompt-template.md
**Passing `--ref` alone is NOT enough.**
注：对不支持 --ref 的模型（文档点名 Jimeng、Seedream 3.0）改为写 refs/ref-NN-{slug}.md 逐角色文字描述，并以 MUST/REQUIRED 前缀嵌入 prompt。
后端解析沿用仓库统一规则：请求点名 > EXTEND.md 偏好 > 自动选择（Codex imagegen > codex-imagegen > Cursor GenerateImage > 其它原生 > 唯一已装 > 问用户）。
skills/baoyu-cover-image/SKILL.md
**Codex (`imagegen`)** — first, inspect your available-skills / tool inventory.
注：同样是“skill 点名单一生成后端”的证据；生成时把 prompt 文件、输出路径、宽高比交给该后端，失败自动重试一次。
构图与文字纪律写死：留白 40-60%、人物只做简化剪影、标题必须用用户/原文的准确标题不得自创；文字出错只能改 prompt 重生成，不许在图上涂改。
skills/baoyu-cover-image/SKILL.md
**Title**: Use exact title from user/source; never invent
注：同一段还有 Characters: Simplified silhouettes; NO realistic humans；修正路径写明“regenerate from a corrected prompt, switch to a lower-text or no-title variant”。
输出目录与产物结构固定：默认 independent 落到 cover-image/{topic-slug}/，内含 source、refs/、prompts/cover.md、cover.png，重生成前先备份旧图。
skills/baoyu-cover-image/SKILL.md
- `independent` (default): `cover-image/{topic-slug}/`
注：Step 4 第 1 条要求 Backup existing cover.png if regenerating；Slug 2-4 词 kebab-case，冲突加时间戳。
2核心能力
01六维封面定制 + preset 快捷（--style 一次给全）
02内容信号自动选型（11 调色板 / 7 渲染 / 6 类型 / 文字量 / 情绪 / 字体）
03结构化 prompt 模板（Content Context / Visual Design / Text Elements / Composition 分段 + frontmatter references）
04参考图处理：支持 --ref 的模型直传，不支持的模型改写成逐角色文字描述
05生成前后置校验与备份（test -f 参考图、备份 cover.png、失败重试一次）
06宽高比多档支持（16:9 / 2.35:1 / 4:3 / 3:2 / 1:1 / 3:4），且除非显式指定否则必问
07占位符与色值纪律（色值仅供渲染，不得作为图上文字出现）
08偏好持久化（EXTEND.md：watermark / preferred_* / default_aspect / quick_mode / language）
3外部依赖
| 类型 | 依赖 |
|---|---|
| api | Codex 原生 imagegen skill（Skill 工具调用） |
| cli | codex CLI / baoyu-image-gen（codex-imagegen 分支） |
| api | Cursor 原生 GenerateImage / Hermes image_generate |
| network | codex-imagegen wrapper（自述认证走用户 Codex 订阅） |
4风险提醒 风险提醒：橙色 · 评估后使用
风险提醒：橙色 · 评估后使用
- 标题与摘要出网到第三方图像模型（orange 档主因） — Step 4 明确把 prompt 文件交给 codex imagegen / baoyu-image-gen 等后端；未发布文章的标题与要点会离开本机，且消耗账号额度。
- 确认流程与后端依赖带来使用门槛 — 没有 AskUserQuestion 等价物的宿主会退化为编号文本问答；若一个图像后端都不可用，流程停在“问用户怎么办”。
- 参考图被提升为强指令的注入面 — 模板要求把参考图特征以 MUST/REQUIRED 写进 prompt；若参考图来自不可信来源，其描述会主导生成内容，属内容层风险。
- multiSelect/问题数受宿主限制 — 按注释一次最多 4 问，六维 + 宽高比需分两批；宿主若只支持单问会显著拉长交互。
- 产物为单文件，无版本管理 — 重生成会备份 cover.png 但目录内不保留多版本索引，需要用户自行命名管理（对比 comic 的 -backup 规则更细）。
风险提醒：橙色，评估后使用。(a) SKILL.md 点名运行时要调的外部生成后端：'**Codex (`imagegen`)** — first, inspect your available-skills / tool inventory.' 与 'route through `baoyu-image-gen --provider codex-cli` (preferred)'（Cursor `GenerateImage`、Hermes `image_generate` 同规则）——照 SKILL.md 执行后，文章标题/摘要/关键词与参考图会出网到第三方图像模型，并消耗用户账号额度。(b) 本地写盘明确：prompts/cover.md、refs/、cover.png、EXTEND.md。(c) 自身目录零脚本、零自带网络端点、零凭证读取，出网与凭证面全在被点名的后端，故不判 red。对照先例：ai-image-generation / nano-banana-2 等素材送生成后端一律 orange。
5第二遍独立确认
- [ok] 自身无脚本/无端点/无凭证 — 目录内全是 markdown；URL 扫描只命中 github.com/JimLiu/baoyu-skills。
- [ok] SKILL.md 点名生成后端（orange 依据） — Codex imagegen / codex CLI via baoyu-image-gen / Cursor GenerateImage / Hermes image_generate 均在 SKILL.md 正文，且写成“一次选定、生成前必须完成”。
- [ok] 维度数量说法核对（描述写 5 dimensions） — SKILL.md 正文 Actually 列 Type/Palette/Rendering/Text/Mood 五维于 Five Dimensions 表，Font 单列在枚举与 Options 中——描述与正文不冲突，侦查按正文六项记录。
- [ok] 文字/色值纪律 — prompt-template.md 的 Color constraint 与 SKILL.md 的 Title/Characters/Composition Principles 三处对得上；位图涂改禁令与 article-illustrator 同款。
- [ok] 参考图不支持 --ref 时的降级路径 — SKILL.md Step 1 与 reference-images.md 一致：写 refs/ref-NN-{slug}.md 逐人物描述，并以 MUST/REQUIRED 嵌入 prompt。
- [ok] meta 元数据 — GitHub API：MIT、25926 stars、pushed_at 2026-09-10T15:13:43Z；本地 HEAD 与 pin 1567581c26ec… 一致。
6结论
适合：适合需要稳定视觉规范的博客/公众号/技术文作者出封面图，按主题批量产出并保持色彩与字体一致；也适合把“封面设计决策”结构化成流程的团队。
不适合：不适合需要精确排版文字（像素级对齐）的封面——应交给设计工具；不适合严格禁止内容外发的环境；不适合无交互能力且不接受默认值的宿主。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 baoyu-cover-image.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agente68671656994141a…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库JimLiu / JimLiu/baoyu-skills
原始 GitHubJimLiu/baoyu-skills ↗
Stars25926
最近推送2026-09-10
本 skill commit
1567581c26许可MIT（仓库根 LICENSE，Copyright (c) 2026 Jim Liu；GitHub API license.spdx_id=MIT）
本站信息
收录日期2026-09-06
分类设计
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。