贴图 / 多图推送#

贴图 / 多图推送一条龙 —— 构思→生图→图片消息群发，九宫格自动排布、多图打包。

套件说明 · 本 skill 属 aws-wechat-article-* 一条龙套件（共 9 个 slug，入口 aws-wechat-article-main）。跨 skill 的相对引用依赖同一 skills/ 目录，建议一并 clawhub install 全套。源码： https://github.com/aiworkskills/wechat-article-skills

能力披露（Capabilities）#

本 skill 编排贴图与多图推送，调用同套件的 image_create.py（images）生图；可选调用 publish.py 发布。 会把图片 prompt 发给外部图像 API；若走发布路径，会把图片作为 POST body 上传到微信 API。 具体行为：

• 凭证读取： aws.env 的 IMAGE_MODEL_API_KEY；走发布时额外读取 WECHAT_{N}_APPID / WECHAT_{N}_APPSECRET
• 凭证外发： IMAGE_MODEL_API_KEY 以 Authorization: Bearer 头发送到 image_model.base_url 外部端点； WECHAT_{N}_APPID/APPSECRET 用于换 access_token 后调用微信 API
• 内容外发：图片 prompt 发给图像 API；图片文件（PNG/WEBP）发给微信 material/add_material / draft/add
• 文件读：仓库内 .aws-article/config.yaml、本篇 article.yaml、 imgs/prompts/*.md
• 文件写：本篇 imgs/*.{png,webp}、 imgs/outline.md、 article.yaml 状态字段
• shell： {python} {baseDir}/../aws-wechat-article-images/scripts/image_create.py；可选 {python} {baseDir}/../aws-wechat-article-publish/scripts/publish.py（ {python} = 本机 Python 3 解释器，见 main SKILL 第 0 步：Windows 用 py -3 -X utf8，macOS / Linux 用 python3）

配套 skill（informational）#

本 skill 属 aws-wechat-article-* 一条龙公众号套件的 贴图/多图推送专用分支（入口 aws-wechat-article-main）。工作流中的生图步骤与发布步骤依赖同套件其他 slug 提供的能力。

• 至少需要同时安装 aws-wechat-article-images（用于生图）；若要走发布链路，建议再装 aws-wechat-article-publish。
• 套件完整装齐到同一 skills/ 根目录 时，跨 skill 引用都能读到。
• 单独安装本 skill 时，生图/发布相关步骤会在执行阶段遇到缺失文件；本 skill 内的选题规划、图序、风格约定等本地步骤仍可用。

完整 9 slug 清单见 源码仓库。

路由#

长文图文（标题+正文+插图+后台发文）→ aws-wechat-article-main；长文内单篇插图 → aws-wechat-article-images。

创作以图片为主的公众号内容：多张图片 + 每张配文，统一风格。

产出目标（先看这个）#

• 输入：主题 / 选题卡 / 用户素材图（任选其一）
• 输出： imgs/（outline + prompts + 图片）与可发布的多图内容
• 风格：整组统一（避免每张图风格漂移）

配置检查 ⛔#

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

从选题到发布的 前置规则 见 aws-wechat-article-main/SKILL.md；本 skill 描述贴图子流程。

图片模型： image_model（ provider、 base_url、 model 等）在 config.yaml； IMAGE_MODEL_API_KEY 在 aws.env。键名对照 {baseDir}/../aws-wechat-article-main/references/env.example.yaml（与 image_create.py 一致）。

交互约定：须遵守 main 的 智能体行为约束——未通过环境校验且未获用户明确「本次例外」时，不得假装已走专用生图 API。

脚本目录#

Agent 执行：确定本 SKILL.md 所在目录为 {baseDir}。

脚本路径（相对仓库 skills/）用途image_create.py``aws-wechat-article-images/scripts/image_create.py专用生图 API：读取 .aws-article/config.yaml 的 image_model + 根目录 aws.env 的 IMAGE_MODEL_API_KEY``publish.py``{baseDir}/../aws-wechat-article-publish/scripts/publish.py发布（与 publish skill 一致）

工作流#

text

贴图进度：
- [ ] 第1步：环境检查 + 本篇约束（合并 YAML）
- [ ] 第2步：确定选题
- [ ] 第3步：确定风格
- [ ] 第4步：规划图序
- [ ] 第5步：展示方案并等待确认 ⛔
- [ ] 第6步：生成图片（**脚本失败时**见同节「调用失败」分支）
- [ ] 第7步：审稿
- [ ] 第8步：发布

第1步：环境检查 + 本篇约束（合并 YAML）#

若本篇在 drafts/…/ 下：按 .aws-article/config.yaml → 本篇 article.yaml 合并读取约束（同键本篇优先，最后层覆盖），重点字段： multi_image_count、 tone、 target_reader、 custom_sticker_style > default_sticker_style（ 须为 YAML 字符串列表； custom_* 非空时优先于 default_*；多候选时智能体择一并写回本篇为 单元素列表）。若无有效 YAML，以用户口述主题 + skill 默认值作为约束。

第2步：确定选题#

topics 产出的贴图卡片 / 用户直接给主题 / 用户提供素材图片。

第3步：确定风格#

贴图风格加载优先级：

1. 用户指定（「用知识卡片风格」）
2. 本篇合并配置中的 custom_sticker_style > default_sticker_style（若有； custom_* 优先；列表多元素时须先择一）
3. .aws-article/presets/sticker-styles/ 下的自定义风格
4. fallback：根据贴图主题从共享的 image-styles/ 里选一个形态——信息型选「信息位」那几个（流程步骤/结构分层/数据图表/对比两栏/清单要点），氛围型选「节奏位」（概念隐喻/场景还原/氛围留白）

全组图统一风格。

第4步：规划图序#

产出 imgs/outline.md：每张图的用途、文案要点、文件名。详见： references/workflow.md

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

第6步：生成图片#

生成方式（优先级）：

1. 优先：调用 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 时（在 仓库根 执行，路径按本篇 imgs/ 调整）：

bash

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

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

连通性自检： {python} {baseDir}/../aws-wechat-article-images/scripts/image_create.py test

图片内文字与 prompt 构建规则与长文配图一致，见 aws-wechat-article-images/SKILL.md 与 prompt-construction.md。

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

沿用配图 skill 的同一规则：必须摘要 stderr 关键行，按 网络 / 配置·凭证 / 业务·参数 分类处理； 禁止 配置错误时静默降级。细则参照 aws-wechat-article-images/SKILL.md 第 6 步「调用失败」表格。

第7步：审稿#

贴图专用清单： references/checklist.md

第8步：发布#

bash

{python} {baseDir}/../aws-wechat-article-publish/scripts/publish.py full article/

过程文件#

读取产出topic-card.md（可选）、 .aws-article/config.yaml + 本篇 article.yamlimgs/（outline + prompts + 图片）