baoyu-cover-image实战：把文章主题转成可复用封面方案

baoyu-cover-image 把“给文章做张封面”拆成可以讨论和复用的设计决策。它不是把正文压成一张大图，而是提炼主题、构图和标题，让读者在小尺寸预览中理解文章入口。

本文基于固定提交源码核对；案例为操作示例，非付费服务或账号实测。本教程只讲方法，不实际生成封面，也不为本页面设置 cover。

一、场景与边界

适合博客列表缩略图、文章头图、社交分享封面。对于一篇“从手工部署到自动化流水线”的文章，封面可表达从重复操作走向可控流程，而不必把完整部署流程和全部命令塞进去。

设计有五个主维度：类型、配色、渲染方式、文字密度和情绪强度，另外还需确认字体、画幅与语言。类型有 hero、conceptual、typography、metaphor、scene、minimal；文字级别有无文字、仅标题、标题加副标题和较丰富文本。字体不是第六个主维度，却确实会进入确认流程，使用时应把它单独说明。

该技能生成位图，不负责发布文章，也不保证某个平台的自动裁剪效果。源码要求使用真实用户标题，不擅自编造；人物构图原则偏向简化剪影而非写实人物。需要精确展示每个组件与连线时，应使用技术图解，不要用封面承担说明书职责。

二、前置依赖与按需安装

需要可读取源文章、参考图片和写出文件的 Agent，以及可用图像后端。原生图像工具可承担渲染；非原生环境可按需安装图片生成后端，并由用户配置合法凭证与额度。

README 核实过的安装入口是：

1	npx skills add jimliu/baoyu-skills --skill baoyu-cover-image --agent codex

Claude Code 用户可将 codex 替换为 claude-code。

只选择 baoyu-cover-image 和确实缺少的后端，不必整仓全装。命令跟随仓库当前版本，不自动固定到本文提交。需要一致复现时使用固定提交的完整技能目录；Codex 项目级可以复制或链接到 .agents/skills/baoyu-cover-image/。保留 references/，因为预设、确认流程、提示词模板都在其中。

安装不是调用授权。后续选择收费 API、上传参考图片、登录账号都应单独说明。本教程没有执行安装或登录。

三、输入与输出

输入包括文章文件或粘贴内容、明确标题、目标用途，以及可选的品牌或构图参考图。告诉 Agent “博客列表展示，主要在手机上看”比单说“高级感”更有用，因为前者影响留白和文字量。

独立输出目录默认为 cover-image/{topic-slug}/，也可通过偏好切换到文章旁或 imgs/ 子目录。常见文件有源内容副本、refs/、prompts/cover.md 与 cover.png。重生成前应备份旧图。

这一提交存在提示词命名差异：流程模板使用 prompts/cover.md，实际生成步骤还要求保存完整最终提示词到 prompts/01-cover-[slug].md。不要因为看见两个名字就断言其中一个不存在；让 Agent 在完成报告中明确“实际传给后端的是哪个文件”，并保留对应最终版本即可建立可追溯关系。

四、可复制请求

请使用 baoyu-cover-image 为《从手工部署到自动化流水线》设计封面。
标题必须逐字使用上述文字，不新增宣传语或未经提供的数据。
用途是中文技术博客列表和文章头图，先推荐概念型、简洁渲染的方案。
请说明类型、配色、渲染、文字密度、情绪、字体、比例和后端。
使用 16:9；先让我确认，不要把已有偏好当成免确认授权。
不要用真人肖像；保留足够留白，重要标题不要贴边。
生成前保存最终提示词，旧图保留备份，只输出文件，不发布文章。

如果只是准备选题，可以把最后一句改为“本轮只做方案讨论，不生成图片”。这是任务范围约束，而非新的技能参数。

五、案例：一篇自动化部署文章的封面流程

读取偏好。 首次找不到 EXTEND.md 时先完成初始设置，这是阻塞步骤。应先决定输出目录与语言，避免后面追着找图。

提取视觉主题。 输入文章讲的是减少重复操作和提升流程可控性。可以提出“左侧散落的手工步骤、右侧连贯流程”的视觉概念，但不能擅自画出正文没有使用的云厂商标识或宣称“效率提升十倍”。

确认设计组合。 本例建议 conceptual、偏冷配色、flat-vector、仅标题、balanced 情绪与 clean 字体。16:9 是源码列出的默认比例。也支持电影宽幅、方形等比例，但不同平台裁剪规则仍需实际预览，不能由比例名称推断自动适配。

组织参考图。 如果提供了品牌图，先确认它是直接参考、只取风格还是只取配色。只有文件确实存在且后端支持时，才能传为直接参考。没有文件的口头风格描述不应伪装成已上传图片。

存提示词后出图。 提示词写清标题、主体位置、留白与比例，后端调用时使用已经落盘的最终版本。源码建议留白约四成至六成，主视觉居中或偏左。文字较长时优先减少副标题，不要缩到手机上无法阅读。

验收并迭代。 如果“流水线”出现错别字，保留旧候选，改提示词并另存新图；不允许用 Pillow、Canvas 等在位图上涂抹覆盖文字。允许的后处理限于不改变文字和主体构图的裁剪、缩放、压缩与格式转换。

六、配置与确认策略

偏好查找顺序是项目 .baoyu-skills/baoyu-cover-image/EXTEND.md、XDG 配置目录中的同名技能目录、用户 $HOME/.baoyu-skills/baoyu-cover-image/EXTEND.md。只取首个命中，不是逐层合并所有文件。

常用字段包括 preferred_type、preferred_palette、preferred_rendering、default_aspect、language、preferred_image_backend。如果每次都想核对服务，使用 preferred_image_backend: ask；auto 则进入运行时能力发现规则。

确认政策规定默认先确认后生成。源码局部流程表仍有“参数全部指定可不再询问”的旧式表述，与前面的硬门槛有张力，实际操作应保守遵循明确确认政策：给了所有设计值不应被解读成自动免确认。只有当前用户明确要求直接生成，或已主动设置 quick_mode: true，才按对应规则减少确认；即使快速模式，也可能仍需补齐未指定比例。

七、验收与排错

[ ] 标题与用户给定原文完全一致，没有新增保证性宣传。
[ ] 完成报告包含实际比例、后端和最终提示词路径。
[ ] 缩到博客列表宽度后，标题仍可读，主体仍清晰。
[ ] 参考图用途准确，未上传的图没有被声称传给模型。
[ ] 旧候选有备份，修正版本能区分。
[ ] Obsidian 和 Hexo 使用普通图片附件路径，发布链能复制图片。

画面太满：降低文字级别、删除次要物件，而不是继续加细节。颜色与品牌不符：明确把参考用途设为配色，写出实际颜色约束。无后端却收到 SVG：这不符合该技能的位图要求，应停下选择合适后端。博客裁掉标题：先检查主题的封面裁剪方式，再决定换比例或调整安全区，不能只反复重画同一构图。