soia-media-cover-image 是媒体内容发布链（compose -> publish-*）里的封面生成环节：给已经写好或即将发布的文章生成一张位图封面，公众号场景的产出可直接喂给 soia-media-publish-wechat-draft 的 --cover 参数。本技能只产出一张封面位图（文中配图/插画属于 v2 路线图），不做排版、不做发布、不碰账号凭据。
用途与主要能力
- 给一篇公众号/X/小红书文章配一张封面：分析内容，推荐五维参数（type/palette/rendering/text/mood）与比例，经确认后解析生成后端、落盘 prompt 并生成。
- 换风格重新生成：保留旧版本、写新 prompt 文件、只重生成，不在旧图上描字改字。
- 后端不可用（没装 codex / 未登录）时停止生成，明确告知缺什么、如何补齐，不降级成代码画图冒充位图。
使用方式
- 提供文章的确切标题（不可由本技能编造或改写）、主题/要点、目标发布渠道（公众号 / X / 小红书，决定默认比例）。
- Agent 分析内容后推荐五维参数与比例，连同确认闸门一起交给用户确认——除非用户在当前这句话里已明说直接生成/--quick。
- 后端解析：当前消息指定后端就用它；否则探测 codex CLI；都不满足就停止并询问用户，不静默降级。
- 生成前把最终 prompt 落盘到 prompts/NN-cover-<slug>.md；公众号场景生成后的 cover.png 可直接作为下游 soia-media-publish-wechat-draft 的 scripts/publish.py --article <md> --cover <output-dir>/cover.png 输入（该 skill 是独立下游 skill，按其自身安装说明配置，本技能不修改它）。
- 最终回复给出完成回执。
安装本技能（单个技能）：
npx skills add soia-team/soia-open-media-content-skills -g -a '*' -s soia-media-cover-image -y
依赖与配置
- codex CLI（codex exec）：强依赖（v1 唯一生图后端）。安装 codex CLI 并完成登录，具体命令以官方文档当前版本为准。PATH 上探测不到或登录态检查未通过时，停止生成，告知用户缺什么、如何安装/登录并询问下一步；不得静默换成代码渲染或其它未声明工具。
- soia-media-publish-wechat-draft：下游衔接（非本技能依赖），见该 skill 自身安装说明。本技能只负责产出 cover.png。
- 配置约定：~/.config/soia-skills/soia-media-cover-image/config.yml，或 SOIA_MEDIA_COVER_IMAGE_CONFIG_FILE=<custom-config-path>。本技能不需要任何账号凭据、cookie、token；config.yml 只保存生成偏好（默认 type/palette/aspect、是否跳过确认）。COVER_IMAGE_OUTPUT_DIR 可为进程环境变量或写在私有 config.yml 的 env: 映射中。若不创建 config.yml，按内置默认值（auto 推荐 + 2.35:1 + 需要确认）运行。样例见 config.example.yml。
五维参数与比例
维度与可选值（默认）：type（hero / conceptual / typography / metaphor / scene / minimal，默认 auto）、palette（warm / elegant / cool / dark / vivid / mono，默认 auto）、rendering（flat-vector / hand-drawn / painterly / digital，默认 auto）、text（none / title-only / title-subtitle，默认 title-only）、mood（subtle / balanced / bold，默认 balanced）。
比例：2.35:1（默认，微信公众号头图，900×383）、16:9（通用横版 / X 配图）、1:1（小红书方图）。未指定发布渠道时默认按公众号场景出图（2.35:1）；提到 X 或小红书就切到对应比例。
确认闸门
生成前必须让用户确认 type、palette、text、aspect 四项；rendering 与 mood 一并展示但硬性门槛以前四项为准。内容分析出的推荐值与 config.yml 偏好默认值都只算推荐输入，不构成跳过确认的理由。唯一跳过条件：用户在当前这句话明确说直接生成/--quick/等价表述，或 config.yml 设置 quick_mode: true；跳过时必须在完成回执里说明沿用的假设。
后端解析与红线
后端解析顺序：当前消息指定 -> 探测 codex CLI（PATH 可执行且已完成登录，满足则以 codex exec 调用，由 codex 内部 image_gen 完成生图）。落地路径注意：codex exec 生成的图片默认落在 ~/.codex/generated_images/<session-id>/ 缓存目录，需复制/移动到约定输出路径后再校验落地。模型版本注意（实测 2026-07-10）：codex 在 PATH 且已登录不等于能生图；遇模型不支持类报错，读 ~/.codex/models_cache.json 找 supported_in_api=true 的模型，显式加 -m <受支持模型> 重试，不要误判为后端不可用。
两条红线：1）禁止用 SVG / HTML / canvas / 任何代码渲染冒充位图，交付物必须是真实生成的位图（PNG/JPG）。2）禁止在已生成的位图上描字、改字、贴补丁；文字或排版有问题只能改 prompt 重新生成，重新生成时新写 prompt 文件与新的输出文件名，保留旧版本。
Prompt 落盘与输出结构
每次调用生图后端前，必须把完整最终 prompt 写入产物目录下的 prompts/NN-cover-<slug>.md（NN 从 01 递增，slug 为 2–4 个英文单词的 kebab-case 短语）。输出结构为 <draft-article-dir>/prompts/01-cover-<topic-slug>.md 与 cover.png；用户指定目录时以用户指定为准，内部结构不变。重生成用 cover-v2.png 递增并保留旧版本。产物路径优先用户指定；未指定时读 COVER_IMAGE_OUTPUT_DIR，都未配置时默认与草稿文章同目录；三者都没有则先询问，不得静默选 cwd。禁止写入 vault 根 outputs/，也不得创建 outputs/cover-image/<name>/ 作为默认落点。
构图原则与限制
构图：留白 40–60%；主元素居中或左偏；人物只用简化剪影，禁止写实人脸；标题必须用用户提供或原文的确切标题，不得编造或改写。
限制：本技能不生成插画、多图长图、文中配图，只做单张封面；不做发布、不碰账号凭据或平台 API；不保证生图后端一定产出满意结果，效果不理想时走重新生成流程。v2 路线图规划文中配图（article illustration）。