公众号运营总览
一键式公众号 AI 内容流水线 —— 从选题到上架 8 个子 skill 串联，公众号小编 / 自媒体 / 品牌内容团队一键产出整篇图文。
套件说明 · aws-wechat-article-* 是公众号一条龙套件，共 9 个 slug：aws-wechat-article-main / topics / writing / review / formatting / images / publish / assets，外加 aws-wechat-sticker。跨 skill 的相对引用依赖同一 skills/ 根目录；推荐 clawhub sync 或逐个 clawhub install 一次性全装。源码：https://github.com/aiworkskills/wechat-article-skills
能力披露（Capabilities）
本 skill 作为一条龙套件编排入口；真正调用外部 API 的是子 skill（writing / images / publish / sticker / review）。本入口自身的 validate_env.py 脚本行为：
- 凭证读取：读取仓库根
aws.env 的 WRITING_MODEL_API_KEY / IMAGE_MODEL_API_KEY / WECHAT_{N}_APPID / WECHAT_{N}_APPSECRET，仅用于校验键是否存在且非空，值不用于任何网络请求
- 网络：本入口脚本无外发请求；子 skill 有外发（详见各子 skill 的能力披露）
- 文件读：仓库内
aws.env、.aws-article/config.yaml、本篇 article.yaml
- 文件写：仓库内 ——
.aws-article/（首次引导创建目录结构）、本篇 article.yaml 状态字段
- shell：仅
python3 {baseDir}/scripts/validate_env.py
注意：整体套件（含子 skill）会调用外部 LLM、图像 API 与微信 API，并在调用时外发 API key 与本篇内容。完整行为见各子 skill 的「能力披露」。
配套 skill（informational）
本 skill 是 aws-wechat-article-* 一条龙公众号套件的入口，编排 8 个子 skill：topics / writing / review / formatting / images / publish / assets 以及 aws-wechat-sticker。
- 装齐全部 9 个 slug 到同一
skills/ 根目录，才能走完整一条龙流程（选题→写稿→审稿→排版→配图→发布）。
- 只装 main 一个时，仍可用于环境校验（
validate_env.py）；进入内容流水线会因对应子 skill 缺失而无法执行相关步骤（工作流里的跨 skill 脚本调用 / 文档读取会遇到 file not found）。
完整 9 slug 清单与安装指引见 源码仓库。
Agent 执行：确定本 SKILL.md 所在目录为 {baseDir}。
配置检查 ⛔ BLOCKING
进入交互顺序「2) 全局账号约束」「3) 本篇准备」及内容流水线前须完成 第 0～2.5 步配置检测（任一步失败则 不得 继续）。第 3 步是调用 publish.py 前的核对（非流水线起点）：.aws-article/config.yaml 中 publish_method 默认为 draft（publish.py full 只把图文写入公众号草稿箱）；仅当用户明确要求「发出去 / 对外发布」时，再将该键改为 published（或使用 full --publish 临时强制发布）。微信：validate_env.py 默认要求公众号账号配齐（见第 2 步）；用户明确不接微信时，先将 publish_method 设为 none 再过校验（脚本会跳过微信组），之后 publish.py full 仍直接跳过。要走草稿/发布，须补全 aws.env 与 config.yaml 微信槽位，并建议 check-wechat-env。文风与账号约束以 config.yaml 为准，发文元数据以本篇 article.yaml 为准。
第 0 步：判断操作系统
智能体在执行下列检测命令前，先判断当前环境：
- Linux / macOS：使用 Bash 命令（
test、echo 等）。
- Windows：使用 PowerShell 命令（
Test-Path 等）。
第 1 步：.aws-article/config.yaml 与 aws.env 是否存在
在仓库根目录（当前工作目录为项目根）执行：
Linux / macOS：
test -f .aws-article/config.yaml && test -f aws.env && echo "ok" || echo "missing"
Windows（PowerShell）：
if ((Test-Path -LiteralPath ".aws-article\config.yaml") -and (Test-Path -LiteralPath "aws.env")) { "ok" } else { "missing" }
⛔ 输出为 missing（任一文件不存在）→ 按 首次引导 创建或补全：可参考 {baseDir}/references/config.example.yaml 得到 config.yaml，在仓库根创建 aws.env（仅密钥与微信 WECHAT_N_APPID / WECHAT_N_APPSECRET 等，键名可与 {baseDir}/references/env.example.yaml 对照）。
初始化约束：新建 .aws-article/config.yaml 时，publish_method 默认必须为 draft；除非用户明确指定不接微信，否则禁止初始化或改写为 none。
第 2 步：校验配置内容（validate_env.py）
两文件均存在后，在仓库根运行：
python {baseDir}/scripts/validate_env.py
（默认读取 .aws-article/config.yaml 与 aws.env；可用 --config / --env 指定路径。）
脚本检查（规则摘要，具体交互文案统一以 首次引导 为准）：
- 写作模型：
config.yaml 中 writing_model.base_url / model 与 aws.env 中 WRITING_MODEL_API_KEY 须同时非空（provider 可选，不填按 URL/模型名自动识别）；否则 failed + 写作模型配置不完整，退出码 1。
- 图片模型：
image_model.base_url / model 与 IMAGE_MODEL_API_KEY 须同时非空（provider 可选，不填按 URL/模型名自动识别）；否则同上，退出码 1。
- 微信公众号：
wechat_accounts、wechat_api_base、各槽位名与 aws.env 中 WECHAT_{i}_APPID / WECHAT_{i}_APPSECRET 须成对完整；否则 failed + 微信公众号配置不完整，退出码 1。例外：config.yaml 中 publish_method: none（用户明确不接微信）时，跳过微信组校验，仍输出 True（并附一行说明已跳过）。
退出码 0：写作、图片均通过，且（未声明 none 时）微信也通过 → True + 配置校验通过。退出码 1：任一组未通过 → 不得进入一条龙默认流水线，并引导 首次引导 补全或 publish_method: none 后重跑。
第 2.5 步：创建预设与运行目录（硬性前置，必须执行）
仅当第 2 步退出码为 0 才执行本步；执行成功后才允许进入「2) 全局账号约束」与后续流水线。
目录要求与命令以 首次引导第 2 步 为准（需覆盖 presets/* 与 tmp）。业务资料库 .aws-article/products/{产品名}/ 不在本步建——由 AI 写第一份业务介绍时按 assets skill 自动 mkdir。
- 禁止因为“环境检查通过”就跳过本步直接写稿。
- 若目录已存在，可视为本步通过；若缺失，必须立即补建并继续校验。
第 3 步：调用 publish.py 前（publish_method + 微信）
publish_method（draft / published / none）写在 config.yaml，默认 draft。none = 用户明确不填微信：full 不调 API。要「发布出去」→ published 或 full --publish。- 微信：在
aws.env；槽位在 config.yaml。draft/published 走 full 前须就绪；none 下不调用微信。
- 运行
publish.py full 前：确认 publish_method 合法（小写）；非 none 时建议 check-wechat-env。
智能体行为约束（禁止自作主张）
检测到 .aws-article/config.yaml 或 aws.env 缺失、validate_env.py 退出码 1（微信配置不完整，且未声明 publish_method: none），或用户已要求调用 publish.py 而微信槽位 / 凭证未就绪时：
- 禁止在未询问用户、未取得用户明确文字确认的情况下，自行决定：跳过微信配置、仅出 prompt 却继续宣称「一条龙已完成」、或继续排版/发布并假装配置已就绪。
- 必须先：向用户说明具体缺哪一类（脚本
failed 下的 微信公众号配置不完整；或即将 publish.py 但微信未配齐），并统一按 首次引导 中「校验失败时的配置引导」文案执行。
- 输出约束：该场景下除”环境检查结果”可按实际失败项替换外，其余引导文案须与首次引导保持一致。
- 用户在本地编辑器中填好
aws.env 与 config.yaml 并保存后，智能体协助重跑 validate_env.py 复检；若用户明确声明本次例外，按首次引导与本节约束继续处理。
- 凭证处理原则：Agent 不得索取、不得接收用户在对话里粘贴的
APPSECRET / API_KEY 等任何密钥；所有密钥由用户自己在编辑器里写入 aws.env（或通过 https://aiworkskills.cn/ 平台配置）。Agent 只校验存在性、不读取值、不外发值。
模型未配置例外：写作模型默认阻断；仅当用户明确同意由 Agent 代写并传入 --agent-writing-approved 时，写作模型未配置才降为警告。图片模型同理，仅在用户明确同意使用 Agent 代生图并传入 --agent-image-capable 时降为警告；未获用户明确同意时，模型未配置均按阻断处理。须告知用户当前使用的方式。
单步子 skill：用户只触发某一子能力（如仅排版、仅审稿）且未走本总览流水线时，仍以各子 skill 内说明为准；一条龙 / 完整流程 / 从选题到发布 必须满足本节 BLOCKING 与上条「禁止自作主张」。
主要配置文件（不要混用）
| 文件 | 位置 | 作用 |
|---|
aws.env | 仓库根 | 密钥：写作/图片 *_API_KEY、微信 WECHAT_N_APPID / WECHAT_N_APPSECRET 等（键名见 references/env.example.yaml；与 config.yaml 一起由 validate_env.py 校验） |
.aws-article/config.yaml | 仓库内 | 非密钥配置：账号文风、模型 provider/base_url/model、微信槽位数与 wechat_api_base、各槽位展示名等（模板见 references/config.example.yaml） |
references/env.example.yaml | 仓库内示例 | 仅文档：aws.env 键名说明 |
references/config.example.yaml | 仓库内示例 | 仅文档：config.yaml 结构示例 |
article.yaml | 本篇目录 drafts/YYYYMMDD-标题slug/ | 发文元数据（标题/作者/摘要/封面等）及状态字段：image_source（仅 generated / user；默认 generated，用户上传配图时改为 user）与 publish_completed（新建 false，发布闭环结束 true），与 config.yaml 分工 |
发布方式与时间线
- 账号与发布策略：文风、选题边界、
publish_method（默认 draft）、微信槽位元数据等均在 .aws-article/config.yaml 维护；密钥仅在 aws.env。
- 本篇准备（须先完成交互顺序 「2) 全局账号约束」）：在 定题与 slug 之后新建
drafts/YYYYMMDD-标题slug/，并优先创建 article.yaml（含 publish_completed: false、标题/作者/摘要等；通常为本目录内首个应落盘的文件），再进入内容流水线。
- 执行原则（严格顺序）：必须按下述流水线顺序依次执行，不能跳过任何部分；每到一步若缺少必要输入（目录、元数据、主题、用户选择、发布意图等），要先及时询问用户并获得确认，再进入下一步，除非用户指出基于某个历史任务继续创作，那么需要智能体根据中间产物判断从哪个阶段开始。
- 内容流水线（子 skill 串行，详见下文 「交互顺序」第 4 步 与 「流程」 表）：选题（topics）→ 写稿（writing）→ 审稿（内容审）（review）→ 排版（formatting）→ 配图（images）→ 审稿（终审）（review）。内容审产出的 **
article.md 定稿须满足 review 第 5 步（文末 {embed:…}，⛔ BLOCKING）后再排版。全程以 .aws-article/config.yaml 为账号与文风约束；典型产物依次为 topic-card.md / draft.md → article.md → article.html 与 imgs/ 等。
- 发布（publish）：
draft → full 仅草稿箱；published 或 full --publish → 再提交发布；none → full 立即跳过、不调微信。前两档需微信凭证。
再强调：aws.env = 密钥；config.yaml = 账号/文风/模型与微信元数据及 publish_method；本篇 article.yaml = 发文元数据。
交互顺序（一步步，最小提问）
按以下顺序与用户交互，上一步完成再进下一步；上一环节就绪后再进入下一环节。
1) 配置自检（必做）
- 按上文 配置检查 完成：
config.yaml 与 aws.env 均存在 → 运行 validate_env.py（默认不加 --agent-image-capable）且退出码 0。退出码 1 时按 首次引导 补全环境；仅当用户明确表示不接微信时才可设 none；走本次例外需用户明确书面确认。
validate_env.py 退出码 0 后，必须立即执行「第 2.5 步目录创建」（可复用 首次引导第 2 步 命令）；该步完成前，禁止进入「2) 全局账号约束」与任何写稿流程。- 退出码 0 + 模型警告：流程不阻断，可直接进入下一步。模型警告仅在用户已明确同意并传入对应参数时出现：写作模型用
--agent-writing-approved，图片模型用 --agent-image-capable。
- 禁止擅自加参数：未获用户明确同意前，禁止自行追加
--agent-image-capable 或宣称可按代生图模式继续。
- 退出码 1（微信不完整）时：只展示 首次引导 中的 配置选项，不要在同一轮回复里再问「写哪篇 / 继续哪篇草稿 / 新选题」等；须等配置闭环（重跑校验通过或「本次例外」已书面确认）后，再进入下方 「2) 全局账号约束」。
validate_env.py 不检查 article_category、target_reader、default_author；须在 「2) 全局账号约束」 中单独检查并落盘。
2) 全局账号约束（.aws-article/config.yaml）⛔
在 validate_env.py 已通过（或已按总览完成「本次例外」）之后、进入「3) 本篇准备」之前，必须打开 .aws-article/config.yaml，检查下列键 trim 后是否非空：
article_category、target_reader、default_author
任一项缺失或空白：逐项询问用户（1.账号领域2.目标读者3.作者名字），取得用户当轮明确答复后再写回 .aws-article/config.yaml，再进入 「3) 本篇准备」。禁止仅在对话里口头确认却不写入文件。禁止跳过本步直接假定可写稿。
⛔ 禁止擅自填写（必须写进行为约束）
- 不得从本篇或其它目录的
article.yaml、历史草稿、topic-card.md、对话记忆或仓库内任意文件**静默抄录、推断或「顺手补全」**后写入 article_category / target_reader / default_author。对 tone 等与账号画像强相关的全局项，要直接询问用户，同样禁止未询问就写盘。
- 允许的做法：向用户说明「当前为空」，请用户填写或确认；若你想根据某篇
article.yaml 给建议，只能展示为待选文案，并问「是否采用 / 要改哪几个字」，用户明确同意后再写入 config.yaml。
- 顺序：在尚未完成 「3) 本篇准备」 中「续旧 / 新开」的确认前，禁止用某一
drafts/…/article.yaml 反推全局三键，避免误把单篇元数据当成整号定位。
3) 本篇准备（二选一，默认「新建一篇」）
在完成「2) 全局账号约束」之后，在不了解用户是要续写既有草稿还是新开一篇时（例如未指定 drafts/… 路径、且仓库 drafts/ 下存在进行中目录或多个候选）：须先询问并让用户选定 「继续哪一篇」 或 「新开一篇」，再进入下列 A/B 或调用写作脚本。禁止默认「最近修改」目录、未确认就运行写作脚本、或假定沿用上一轮路径。
业务素材双向规则（涉及用户自身业务时强制，详见 assets skill）：
- 读：若本篇涉及用户自家业务（产品/软件/服务），先
ls .aws-article/products/ 看有无相关产品目录，进入后必读根下 *.md（业务介绍）作为底稿来源；images/ 子目录里有现成业务配图则优先复用。
- 写：本流程中产生的内容若语义属于业务介绍（不是文章主体而是侧重产品/服务自介），由 AI 主动引导用户保存到
.aws-article/products/{产品名}/{文件名}.md（用 Write 工具直接落库；目录不存在时同时创建 images/），下次涉及业务的文章自动用上。
A. 新建一篇（严格子顺序，勿跳步）
- 写作意图 ⛔ BLOCKING：必须问清用户 本篇要写什么（具体主题、角度、体裁或目标）。若用户只想「帮我出选题」，须明确确认后再当无方向模式处理。
- 禁止在用户未回答本步（且当前对话也未等价说明）之前：调用 web_search、执行 topics 的调研、批量生成选题或标题。
- 用户已在当次对话中说清楚「写什么」的，可本步口头确认一句即可，不必重复盘问。
- 定题与 slug：在写作意图已明确的前提下，确定发文章标题——用户从候选中选一个，或自定义标题；据此生成 slug，目录名为
YYYYMMDD-标题slug（slug 规则：小写、连字符、与项目习惯一致即可）。
- 建目录与
article.yaml：创建 {drafts_root}/YYYYMMDD-标题slug/（drafts_root 以 config.yaml 为准，默认 drafts/）。随即初始化本篇 article.yaml（含 publish_completed: false，及标题、作者、摘要等；目录内宜最先写入；可用 {baseDir}/../aws-wechat-article-publish/scripts/article_init.py）。
publish_method：默认 draft；要发出去 → published 或 full --publish；用户明确不填微信 → none。
- 本篇预设单选落盘（必做）：初始化后按场景执行：新建首轮以
.aws-article/config.yaml 为来源，按 custom_* > default_* 结合本篇主题/选题卡，为以下字段各选单一预设并写回本篇 article.yaml 为单元素列表：default_structure、default_closing_block、default_title_style、default_format_preset、default_cover_image_style、default_article_image_style、default_sticker_style。续写/重入时若本篇 article.yaml 对应字段已为单元素列表，视为本篇已选并优先保留，不重选不覆盖。若 config.yaml 不存在或候选为空，可保持 []。
- 至此才进入 第 4 步内容流水线。
B. 我已有目录
- 用户给出路径。必读
.aws-article/config.yaml（账号与发布策略）；本篇目录内需有 article.yaml（或按用户状态后补）。若已有 article.html/cover.jpg 可直接从流水线中靠后的步骤接入。
- 若用户意图是「发布后换图并重发草稿箱」，也走本分支：指定既有目录后，从 配图（用户供图分支） 接入，再执行 终审 → 发布。
4) 内容流水线（子 skill）
须已具备 本篇目录 与 article.yaml（「已有目录」分支按上条处理）；账号侧约束以 config.yaml 为准。
确认轮次优化：全局三键已非空时静默通过；publish_method 已为合法值时不重复盘问；多个待确认项可合并为一轮提问。用户意图明确时（如给出主题 + "写一篇文章"），理想轮次为 1 轮（确认标题/摘要）+ 写完后展示结果。配图方案在用户无特殊要求时按默认风格自动执行，不单独确认。
选题 → 写稿 → 审稿(内容审) → 排版 → 配图 → 审稿(终审)
- topics：仅在 写作意图已明确（见上 3-A-1）之后执行；仍须遵守 aws-wechat-article-topics 中「展示后等用户选」等规则。
- writing：结合
.aws-article/config.yaml 与 topic-card.md（或用户素材）；publish_method 见 config.yaml（上文「发布方式与时间线」）；产物 draft.md → 内容审后 article.md。
- review（内容审）：定稿
article.md 前须按 review 第 5 步 ⛔ BLOCKING 完成文末 {embed:…}（或规则允许的省略并留痕）；未完成不得进入 formatting。
- formatting：
article.md → article.html（用户当次指定排版主题可覆盖默认）。
- images：按 aws-wechat-article-images（配置与行为约束以本节「配置检查」为准）。
- review（终审）：检查
article.html 与 imgs/；有问题给出清单，等用户确认或修复。
5) 发布
- 以
config.yaml 的 publish_method 为准；draft / published / none 含义见上文。none 时运行 full 会无操作退出。
draft/published：微信须配齐后再调 publish.py；建议 check-wechat-env。none：不调微信，说明即可。- 完成后输出小结与回执，目录按需移至
published_root。
6) 发布后换图重发（补充分支）
当用户说「草稿箱里图不满意，换我上传的图重新发」：
- 锁定目标
drafts/… 目录；
- 将新图放入本篇
imgs/，生成/更新 img_analysis.md（封面仅 1 张）；
- 同步更新本篇
article.yaml：image_source: user；
- 开始重做流程前，将
publish_completed 置回 false；
- 依据分析结果更新
article.md 图片映射（允许重排）；
- 重新执行
format.py 生成 article.html；
- 终审通过后执行
publish.py full（draft 写草稿箱）；
- 发布命令成功且回执可用后，写回
publish_completed: true。
流程
选题 → 写稿 → 审稿(内容审) → 排版 → 配图 → 审稿(终审) → 发布
中间产物门禁（缺啥补啥）⛔
进入下一步前，必须先检查本步所需中间产物；缺什么就先补什么，禁止跳步并宣称已完成。
| 阶段 | 必要产物（最小集合） | 缺失时动作 |
|---|
| 写稿完成 | article.md 存在且非空 | 继续写稿或回滚到 writing |
| 排版完成 | article.html 存在，且由当前 article.md 重新生成 | 先执行 formatting 重转 |
| 配图完成 | 文章目录存在 cover.(png/jpg/jpeg/webp)；article.md 与 article.html 不含 placeholder | 先执行 images 生成并替换（image_source=user 时走用户供图映射与重排） |
| 发布就绪 | article.yaml 含 title/author/digest/content_source；发布环境检查通过 | 先补齐元数据或环境 |
| 发布闭环 | 发布命令成功且回执可用 | 才允许写回 publish_completed: true |
禁止：仅凭单一信号（如“草稿创建成功”）就宣称全流程完成。若正文仍有 placeholder，状态必须标记为“草稿已提交，正文配图未完成”。
| 步骤 | 子 skill | 读取 | 产出 |
|---|
| 选题 | topics | .aws-article/config.yaml、aws.env、web_search | topic-card.md research.md |
| 写稿 | writing | topic-card.md、.aws-article/config.yaml、aws.env（专用写作 API） | draft.md |
| 审稿 | review | draft.md、aws.env、.aws-article/config.yaml | review.md → article.md（定稿须含文末 embed，见 review 第 5 步） |
| 排版 | formatting | article.md、.aws-article/config.yaml | article.html |
| 配图 | images | article.md、aws.env、.aws-article/config.yaml | imgs/ |
| 终审 | review | article.html、imgs/、.aws-article/config.yaml | review.md |
| 发布 | publish | article.html+imgs/、config.yaml、aws.env（调用 publish.py 时） | 草稿 media_id / 发布 publish_id、URL、out/ 记录 |
账号与文风约束：以 .aws-article/config.yaml 为准。
topics / web_search：须满足上文 3-A-1（用户已说明本篇写什么，或已确认「只帮忙出选题」）之后才可调研与生成选题；不得默认跳过提问直接搜索。
提示：发布前需就绪本篇 article.yaml（标题/作者/摘要/封面等元数据；content_source 默认 article.html）。可用 {baseDir}/../aws-wechat-article-publish/scripts/article_init.py 快速初始化或更新。
路由
默认：与长文发文相关时 优先 main，由本 skill 按步编排；不要因用户说了「写」「选题」「发」就跳过 main 直连子 skill。
何时直连子 skill（可跳过 main 入口）：用户明确只要该步产物、且不隐含「从零到发出」整条链。例如：已有 article.md 只要排版；已有稿只要审稿清单；已有 article.html+imgs/ 只要发布前检查或提交；已有选题卡只要扩写等。
| 用户说法 | 路由到 |
|---|
| 从0开始、从零、从头、一条龙、完整流程、帮我发一篇、发到公众号（含各前置步）、今天发什么/写什么好（要成文并发）、不确定从哪步开始 | main |
| 只要选题卡、标题、摘要、排期、系列策划（明确不做后续编排） | topics |
| 只要在已有选题/大纲/草稿上写稿、改写、润色、续写（明确不要全流程） | writing |
| 只要审稿/校对/合规清单（成稿或已定版 HTML） | review |
| 「能不能发」且含代为发布、或要从稿到发出整条收尾 | main |
| 只要排版、换主题、转 HTML | formatting |
| 只要长文封面/正文配图（有正文或插图位） | images |
| 贴图、图片消息、多图推送、九宫格（非长文图文链路） | sticker |
| 只要执行发布/提交/群发（已有约定产物） | publish |
运行模式
一条龙
用户说「一条龙」「完整流程」时启用。按 交互顺序 的 1→2→3→4→5 执行；3-A 内子步骤亦须逐步完成。流水线中每步完成后暂停等用户确认。审稿有 🔴 项时进入修改循环。
单步
用户明确只要某一步且已有对应输入产物（或声明不做全流程）时，可仅执行该步骤；若表述含糊、可能还要后续发文，仍从 main 问起或按一条龙拆步确认。
贴图
路由到独立的 aws-wechat-sticker skill。
配置与自定义
aws.env（仓库根，密钥）与 .aws-article/config.yaml（非密钥与模型/微信元数据及 publish_method）：校验 {baseDir}/scripts/validate_env.py；aws.env 键名见 references/env.example.yamlconfig.yaml / article.yaml / aws.env 字段说明：references/articlescreening-schema.md- 发布前微信：
{baseDir}/../aws-wechat-article-publish/scripts/publish.py check-wechat-env（仓库根执行，试换微信 access_token；凭证在 aws.env）
