aws-wechat-article-images

name	aws-wechat-article-images
description	为公众号文章生成封面图和正文配图，根据文章内容自动匹配风格。当用户提到「封面」「配图」「插图」「生成图片」「给文章加图」「做个封面」「文章插图」「配个图」时使用。

配图

路由

完整长文从选题到发布 → aws-wechat-article-main；图片消息/九宫格等多图推送 → aws-wechat-sticker。

读取文章中的配图标记，按 Type × Style 体系生成图片。专注于长文配图，贴图请用 sticker。

脚本目录

Agent 执行：确定本 SKILL.md 所在目录为 {baseDir}（仓库内即 skills/aws-wechat-article-images/）。

脚本	用途
scripts/image_create.py	专用生图 API：读 .aws-article/config.yaml 的 image_model + 仓库根 aws.env 的 IMAGE_MODEL_API_KEY

配置检查 ⛔

任何操作执行前，必须按 首次引导 执行其中的 「检测顺序」。检测通过后才能进行以下操作（或用户明确书面确认「本次不检查」）：

从选题到发布的前置规则见 aws-wechat-article-main/SKILL.md；本 skill 只描述配图步骤。

图片模型：image_model（provider、base_url、model、default_size、default_quality 等）在 config.yaml；IMAGE_MODEL_API_KEY 在 aws.env。键名对照 .aws-article/env.example.yaml。

交互约定：可提示用户上述项是否已填；一条龙下通常已通过 validate_env.py。须遵守 main 的智能体行为约束——未通过环境校验且未获用户明确「本次例外」时，不得假装已走专用生图 API。

Type × Style 体系

Type（画面构成）× Style（视觉风格）自由组合。

完整风格库、兼容矩阵、预设组合、prompt 模板：见 shared/image-styles/ 目录。

工作流

配图进度：
- [ ] 第1步：环境检查 + 本篇约束与文章
- [ ] 第2步：解析配图标记
- [ ] 第3步：确定风格
- [ ] 第4步：生成配图方案
- [ ] 第5步：展示方案并等待确认 ⛔
- [ ] 第6步：生成图片（**脚本失败时**见同节「调用失败」分支，勿静默吞掉报错）
- [ ] 第7步：插入文章

第1步：环境检查 + 本篇约束与文章

• 全局：读 .aws-article/config.yaml — cover_aspect、cover_style、image_density、caption_style、default_image_style、multi_image_count、tone 等以之为准（完整字段见 articlescreening-schema.md 与 config.example.yaml）。
• 本篇：若同目录有 article.yaml，可读取 cover_image 等本篇字段；与 config.yaml 同名字段时本篇优先（与写稿侧合并规则一致）。
• 读取 article.md（或当前流程规定的正文来源）。

第2步：解析配图标记

提取所有 ![类型：描述](placeholder)。实证 类型提示用户提供素材或从 .aws-article/assets/ 搜索。

可用素材库：

• .aws-article/assets/screenshots/ — 可直接复用的产品/系统截图。优先用于「实证」「界面」类图片；如含敏感信息请打码后使用。

第3步：确定风格

风格加载优先级：

1. 用户指定（「用水彩风」）
2. config.yaml 的 default_image_style（若有）
3. .aws-article/presets/image-styles/ 下的自定义风格
4. fallback：根据正文与 config.yaml 的 tone 自动推荐（规则见 auto-selection.md），默认「扁平矢量」

全文统一风格。完整风格库：shared/image-styles/styles.md

第4步：生成配图方案

为每张图生成方案（类型、风格、prompt 要点）。

图片内文字：画面中出现的文字必须为中文。在 prompt 里直接写出要显示的中文文案（如「传统对话AI」「OpenClaw」），禁止只写 “labels in Chinese” 或 “Chinese or English OK”，否则模型会生成英文。

Prompt 构建：shared/image-styles/prompt-construction.md

第5步：展示方案并等待确认 ⛔

第6步：生成图片

生成方式（优先级）：

1. 优先：调用专用生图 API（scripts/image_create.py）— 依赖 config.yaml 的 image_model + aws.env 的 IMAGE_MODEL_API_KEY
2. 降级：当前 Agent 多模态 / 仅出 prompts — 仅当环境未就绪、用户接受 main「本次例外」、或已按本节下方「调用失败」表格处理（网络重试后仍失败等）时

必须告知用户当前使用的方式：

• 已配置且调用脚本 → ℹ️ 使用 image_create.py 调用专用生图模型（{model}）
• Agent 生图 / 仅 prompts → ℹ️ 本次未走 image_create.py（原因：…）

⛔ 未调用专用 API 时的终点：只做到第 4 步（或第 5 步）。产出 imgs/prompts/*.md 与方案；不执行「替换 article 中的 placeholder」或「修复 HTML」。若 imgs/README.md 尚不存在或需补充当前方案的说明，可创建/更新（如何配置 aws.env / config.yaml、如何跑 image_create.py batch、如何在 article.html 中替换）；若已存在且已涵盖当前方案，不必重写。

调用专用 API 时（在仓库根执行，{baseDir} 按上表解析；路径按本篇 imgs/ 调整）：

python {baseDir}/scripts/image_create.py batch drafts/YYYYMMDD-slug/imgs/prompts/ -o drafts/YYYYMMDD-slug/imgs/

单张：python {baseDir}/scripts/image_create.py generate imgs/prompts/01-cover.md -o imgs/01-cover.png

连通性自检：python {baseDir}/scripts/image_create.py test

图片规格：references/specs.md

image_create.py 调用失败时（智能体必选分支）

只要执行了 image_create.py 且非零退出或 stderr 有 API/网络错误，就必须走本节，不得只说「生图失败」而不分类、不摘要报错。

运行脚本后须把终端 stderr 中的具体报错摘要给用户（含 ❌、HTTP 状态码、【配置/认证】、网络错误（可重试） 等关键行），勿只说「失败」。

类型	判断线索	智能体动作
网络类	URLError、网络错误（可重试）、超时、临时 502/503	必须自动再试 1 次（可短暂等待后重跑同一命令）。第二次仍为网络类 → 可降级为 Agent 多模态生图 或仅保留 prompts；须明确告知用户本次未走专用 API。
配置/凭证类	401/403、图片模型配置不完整、【配置/认证】	不要静默降级。列出须检查项（config.yaml 的 image_model、aws.env 的 IMAGE_MODEL_API_KEY、端点、权限），请用户改正后重跑。用户明确打字接受本次仅用 Agent/仅 prompts 时，再按 main「本次例外」处理。
业务/参数类	【请求参数】、400、返回体提示 model/size 不支持	将响应摘要给用户；可改 config.yaml 或 env 中的 model/尺寸后再试；仍失败则与用户商定是否 Agent 生图。

禁止：配置明显错误时静默改用 Agent 却不说明；网络降级后不告知「本次未走专用生图」。

第7步：插入文章

仅当已生成图片时执行：替换 placeholder 为实际图片路径，输出到 imgs/。

修复 HTML 的触发条件：仅当在 article.html 中确实存在 href="placeholder" 或 placeholder 被渲染成可点击链接时，才将误转的 <a> 改为 <img> 或占位说明；不要默认每次都执行「修复流程图占位」或「修复 HTML」。

过程文件

读取	产出
article.md、.aws-article/config.yaml、本篇可选 article.yaml 中的标记与配图约束	imgs/（outline + prompts + 图片；未走 API 时为 prompts + 可选 imgs/README.md）