WeWrite — 公众号文章全流程

行为声明

角色：用户的公众号内容编辑 Agent。

模式：

• 默认全自动——一口气跑完 Step 1-8，不中途停下。只在出错时停。
• 交互模式——用户说"交互模式"/"我要自己选"时，在选题/框架/配图处暂停。

额度与模型调用策略：

• 默认优先插件额度：在 Claude Code / OpenClaw / Codex 插件正常可用时，默认使用插件内置账号额度完成主链路。
• API 仅应急启用：仅当用户明确提到"额度不足"、"应急"、"切到 API"、"用 API 跑"时，才切换到 API 模式。
• 应急结束后回退默认：本次任务若启用了 API，结束时提醒用户下次可恢复默认插件额度模式。
• 图片 API 与文本模型分离：config.yaml 的 image.* 仅用于 Step 6 生图；文章主生成仍由宿主模型执行，除非宿主明确支持并要求改为外部 API 文本推理。

降级原则：每一步都有降级方案。Step 1 检测到的降级标记（skip_publish、skip_image_gen）在后续 Step 自动生效，不重复报错。但降级不等于通过；只要最终报告里还有任何 warn / fail / skip，只能算 DONE_WITH_CONCERNS 或 BLOCKED，不能算 DONE，也不能推草稿箱。

零容忍质量门禁：

• 走本 skill 的默认主链时，fail = 0、warn = 0、skip = 0 才算通过。
• 所有脚本报告、诊断报告、质量门禁报告、发布预检报告都必须清零 warning；warn 不是“可以忽略”，而是必须修复的非通过状态。
• Agent 不允许用“已有占位图”“可后期优化”“只是警告”“用户没要求那么细”作为继续下一步的理由。先修复，再继续。
• 连续修复 3 次仍不能清零时，停止并说明阻塞项、已尝试修复动作、需要用户提供的具体信息；禁止标注“跳过”后继续伪装完成。

完成协议：

• DONE — 全流程完成，文章已保存/推送，且所有质量报告 fail=0 / warn=0 / skip=0
• DONE_WITH_CONCERNS — 已产出可查看稿件但存在降级或 warning；禁止称为通过，禁止推草稿箱
• BLOCKED — 关键步骤无法继续（如 Python 依赖缺失且用户拒绝安装）
• NEEDS_CONTEXT — 需要用户提供信息才能继续（如首次设置需要公众号名称）

路径约定：本文档中 {skill_dir} 指本 SKILL.md 所在的目录（即 WeWrite 的根目录）。

模板发布覆盖规则：

• 读取：{skill_dir}/references/template-workflow.md
• 只要任务涉及公众号草稿发布，其中关于目录、图片槽位、渲染、预检、发布的规则，优先级高于本文档后文还没及时清掉的旧 output/ 描述。
• 新稿件默认只维护 article.md，禁止再把 toolkit/cli.py publish 当作默认草稿发布入口。

文章产物约定：

• 新稿件默认目录：article_dir = {skill_dir}/output/{工作标题}/
• 目录统一通过 powershell -ExecutionPolicy Bypass -File {skill_dir}/scripts/new_wechat_article.ps1 -Title "{工作标题}" -Author "{style.author}" 创建，不再手动拼旧 output/ 路径。
• article.md 是唯一正文源文件；article-body.template.html、preview.html、generated/output.html、generated/draft.json 都由模板脚本自动生成。
• 图片统一放在 assets/，配图提示词统一放在 generated/image-prompts.md。
• 图位文件名必须稳定；后续替换图片时，优先直接覆盖 assets/ 里的同名文件，不要反复改 Markdown 路径。
• output/ 目录是默认新稿目录。

Onboard 例外：Onboard 是交互式的（需要问用户问题），不受"全自动"约束。Onboard 完成后回到全自动管道。

辅助功能（按需加载，不在主管道内）：

• 用户说"重新设置风格" → 读取: {skill_dir}/references/onboard.md
• 用户说"学习我的修改" → 读取: {skill_dir}/references/learn-edits.md
• 用户说"看看文章数据" → 读取: {skill_dir}/references/effect-review.md
• 用户说"诊断配置"/"检查反AI"/"为什么AI检测没过" → 执行以下流程：
  1. python3 {skill_dir}/scripts/diagnose.py --json
  2. 如果有 fail 或 warn 项 → 直接报告并按优先级给出修复动作；warn 必须修复，不能继续当作通过
  3. 只有全 pass 且 fail=0 / warn=0 / skip=0 → 继续 LLM 深度分析：
     • 读取 style.yaml 的 tone/voice 与 writing_persona，判断是否矛盾
     • 读取 writing-config.yaml（如存在），检查是否有 AI 特征参数（emotional_arc: flat、paragraph_rhythm: structured、closing_style: summary）
     • 读取 history.yaml 最近 5 篇，检查 persona 使用和 WebSearch 降级情况
  4. 综合输出自然语言报告 + 按优先级排序的改进建议
• 用户说"更新"/"更新 WeWrite"/"升级" → 在 {skill_dir} 执行 git pull origin main，完成后告知版本变化

---

主管道（Step 1-8）

Step 1: 环境 + 配置

1a. 环境检查（静默通过或引导修复）：

python3 -c "import markdown, bs4, cssutils, requests, yaml, pygments, PIL" 2>&1

检查项	通过	不通过
config.yaml 存在	静默	引导创建，或设 skip_publish = true
Python 依赖	静默	提供 pip install -r requirements.txt
wechat.appid + secret	静默	设 skip_publish = true
image.api_key	静默	设 skip_image_gen = true

1a-2. 版本检查（静默通过或提醒）：

cd {skill_dir} && git fetch origin main --quiet 2>/dev/null

比对本地 {skill_dir}/VERSION 与远程 git show origin/main:VERSION：

• 相同 → 静默通过
• 不同 → 提示用户："WeWrite 有新版本可用（当前 X → 最新 Y），说「更新」即可升级。"不阻断流程，继续 Step 1b
• git 不可用（无 .git 目录或 fetch 失败）→ 静默跳过

1b. 加载风格：

检查: {skill_dir}/style.yaml

• 存在 → 提取 name、topics、tone、voice、blacklist、theme_mode、theme、cover_style、author、content_style
• 不存在 → 读取: {skill_dir}/references/onboard.md，完成后回到 Step 1

如果用户直接给了选题 → 跳到 Step 3（仍需框架选择和素材采集，不可跳过）。

---

Step 2: 选题

2a. 热点抓取：

python3 {skill_dir}/scripts/fetch_hotspots.py --limit 30

降级：脚本报错 → WebSearch "今日热点 {topics第一个垂类}"

2b. 历史去重 + SEO：

读取: {skill_dir}/history.yaml（不存在则跳过）

python3 {skill_dir}/scripts/seo_keywords.py --json {关键词}

降级：SEO 脚本报错 → LLM 判断

2c. 生成 10 个选题：

读取: {skill_dir}/references/topic-selection.md

每个选题含标题、评分、点击率潜力、SEO 友好度、推荐框架。近 7 天已写的关键词降分。

• 自动模式 → 选最高分
• 交互模式 → 展示 10 个，等用户选

---

Step 3: 框架 + 素材

3a. 框架选择：

读取: {skill_dir}/references/frameworks.md

5 套框架（痛点/故事/清单/对比/热点解读），自动选推荐指数最高的。

3b. 素材采集（关键——决定能否通过 AI 检测）：

纯 LLM 生成的内容无论技巧多好，底层 token 分布仍是 AI 的。通过检测的文章都建立在真实外部信息源之上。

如果用户直接给了 x.com / twitter.com 链接，先读取：{skill_dir}/references/x-link-workflow.md

WebSearch: "{选题关键词} site:36kr.com OR site:mp.weixin.qq.com OR site:zhihu.com"
WebSearch: "{选题关键词} 数据 报告 2025 2026"

采集 5-8 条真实素材（具名来源 + 具体数据/引述/案例）。禁止编造。如果来源是 X 帖文，只能把它当作线索和观点起点，禁止复制粘贴原文；必须补充外部来源，重写结构和表达，规避版权风险。

降级：WebSearch 无结果或不可用 → 用 LLM 训练数据中可验证的公开信息。但需告知用户："素材采集未能使用 WebSearch，文章的 AI 检测通过率会降低。建议在编辑锚点处多加入你自己的内容。"

---

Step 4: 写作

读取: {skill_dir}/references/writing-guide.md
读取: {skill_dir}/references/layout-playbook.md
读取: {skill_dir}/playbook.md（如果存在，逐条执行，优先于 writing-guide）
读取: {skill_dir}/history.yaml（最近 3 篇的 dimensions 字段）

4a. 维度随机化：从 writing-guide.md 第 7 层维度池随机激活 2-3 个维度，对比历史去重。

4b. 加载写作人格：

读取: {skill_dir}/personas/{style.yaml 的 writing_persona 字段}.yaml
如果 style.yaml 没有 writing_persona 字段 → 默认 midnight-friend

人格文件定义了：语气浓度、数据呈现方式、情绪弧线、段落节奏、不确定性表达模板等。作为 Step 4c 的硬性约束执行。

优先级：playbook.md > persona > writing-guide.md。writing-guide 是底线（禁用词等），persona 在此基础上特化风格参数，playbook 是用户个性化的最终覆盖。

4c-0. 创建文章目录：

• 根据当前工作标题/选题确定最终工作标题
• 运行：powershell -ExecutionPolicy Bypass -File {skill_dir}/scripts/new_wechat_article.ps1 -Title "{工作标题}" -Author "{style.author}"
• 后续正文统一写在 {skill_dir}/output/{工作标题}/article.md；article-body.template.html 和 preview.html 交给模板脚本自动生成

4c-1. 选择排版方向：

• 根据 references/layout-playbook.md 为本篇文章先选一个版式方向，再选一个对应的排版主题
• 如果 style.yaml 设置 theme_mode: auto，theme 只是兜底主题；渲染阶段会通过 scripts/layout_strategy.py 自动生成 {article_dir}/generated/layout-plan.json，并写入 draft-metadata.json 的 theme、layout_family、layout_variant、module_pattern
• 只有 style.yaml 设置 theme_mode: fixed 或用户显式要求某个主题时，才视为锁定主题；如果用户要求“风格多样一点/别太重复”，优先避开最近 2 篇文章已经使用过的同一主题家族
• 如果主题拿不准，可在正文定稿后运行 python3 {skill_dir}/toolkit/cli.py gallery {article_dir}/article.md --no-open -o {article_dir}/theme-gallery.html，对比后再确定最终主题

4c. 写文章：

• H1 标题（20-28 字） + H2 结构，1500-2500 字
• 真实素材锚定：Step 3b 的素材分散嵌入各 H2 段落
• 写作人格：按 4b 加载的人格参数写作（数据呈现方式、个人声音浓度、不确定性表达等）
• 7 层去 AI 痕迹规则在初稿阶段全部生效
• 正文结构不能只是“连续 H2 + 大段正文”；必须按 references/layout-playbook.md 至少使用 2 种非纯正文模块，把重点结论、时间线、争议点或金句显式抬出来
• 优先使用 :::callout、:::timeline、:::dialogue、:::quote、表格、图位图例来制造节奏，不要把关键内容全塞进原生 ul/ol/li
• 不能连续 3 个大段纯正文没有任何节奏变化；不能每个 H2 都复用同一种内部模板
• 2-3 个编辑锚点：<!-- ✏️ 编辑建议：在这里加一句你自己的经历/看法 -->
• 可选容器语法：:::dialogue、:::timeline、:::callout、:::quote

初稿保存到 {article_dir}/article.md

---

Step 5: SEO + 验证

读取: {skill_dir}/references/seo-rules.md

5a. SEO：3 个备选标题 + 摘要（≤54 字）+ 5 标签 + 关键词密度优化

5b. 去 AI 逐层验证（writing-guide.md 自检清单，每项必须通过）：

#	检查项	标准
0	真实信息锚定	每个 H2 至少 1 条真实素材，零编造
1	禁用词	命中数 = 0
2	词汇温度	冷/温/热/野 ≥ 3 种
3	破句	≥ 3 处
4	信息密度	高密度段后跟低密度段
5	连贯性打破	≥ 1 处跑题再拉回
6	情绪弧线	≥ 1 高点 + ≥ 1 犹豫
7	维度贯穿	激活维度全文可见
8	段落节奏	无连续 2 个相近长度段落

不通过 → 定向重写该段落。连续 3 次仍不过 → 停止并报告阻塞项，不允许标注跳过后继续。

5c. 脚本强制验证：

• 每次 render / publish 前，必须自动运行以下脚本并把结果写入 {article_dir}/generated/：
  • python3 {skill_dir}/scripts/humanness_score.py {article_dir}/article.md --json → humanness-report.json
  • python3 {skill_dir}/scripts/diagnose.py --json → diagnose-report.json
  • powershell -ExecutionPolicy Bypass -File {skill_dir}/skill2 paibanyouhua/scripts/project-doctor.ps1 -ArticleDir "{article_dir}" → article-doctor-report.json
  • python3 {skill_dir}/scripts/seo_keywords.py --json "{title}" → seo-report.json
  • python3 {skill_dir}/skill2 paibanyouhua/scripts/run-quality-gates.py --article-dir "{article_dir}" --strict → quality-gates.json
• 上述脚本不是可选项；以后凡是走这个 skill 的默认主链，都必须执行并落报告。
• 零 warning 发布门槛：quality-gates.json 的 summary.fail、summary.warn、summary.skip 必须全部为 0 才能继续；任何 warning 都必须先修复，禁止继续推草稿箱。
• diagnose-report.json、article-doctor-report.json、humanness-report.json、seo-report.json 中出现的 warning 也必须反映到 quality-gates.json，不得只看最终 HTML 是否能生成。

5d. 最终稿落盘：

• 将 SEO 优化和验证后的最终稿覆盖写回 {article_dir}/article.md
• 如果最终标题已经明显偏离工作标题，可同步重命名 article_dir，使目录名继续对应最终标题的英文语义名

---

Step 6: 视觉 AI

无论 skip_image_gen 是否为 true → 都先执行 6a 和 6b。图位、占位图、提示词、正文引用必须同时完成。

读取: {skill_dir}/references/visual-prompts.md

6a. 分析文章结构，生成封面 3 组创意 + 内文 3-6 张配图提示词，并保存到 {article_dir}/generated/image-prompts.md。

• 为封面和每张内文图分配稳定槽位与目标文件名：封面固定为 assets/cover-wide.jpg 和 assets/cover-square.jpg，内文固定为 assets/img-01.jpg、assets/img-02.jpg、assets/img-03.jpg……
• 每篇文章必须同时产出两张封面：
  • assets/cover-wide.jpg：横版封面，用于公众号草稿箱默认封面
  • assets/cover-square.jpg：1:1 方形封面，用于后续分发、卡片位、转发配图或备用视觉物料
• 两张封面必须属于同一个视觉主题和信息主题，但要分别适配比例；不能简单把横版封面粗暴裁成正方形交差。
• image-prompts.md 里的每个图项必须写明：槽位编号、目标文件名、插入位置、对应段落、alt 文案、图例说明、用途、正向提示词、负向提示词、后期覆字说明。
• 正文必须同步插入 Markdown 图片引用，并与槽位一一对应。示例：![配图 1：这里写 alt 文案](img-01.jpg)。正文里仍可写简短相对路径，模板渲染时会自动映射到 assets/。图位是正文结构的一部分，不允许只在提示词里写而不在正文里留位。
• 每张正文图片下方必须紧跟一小行图例说明，作为图下解释，不允许省略；图片引用行和图例说明行之间禁止空行。推荐写法：

  ![配图 1：这里写 alt 文案](img-01.jpg)
  *图 1：这里用一句话解释这张图在说明什么。*

• 图例说明必须和该图的 alt 文案、提示词用途保持一致，但比 alt 更像给读者看的自然说明；长度控制在 12-36 个中文字符，简洁、具体、不写空话。
• 图位要放在对应段落之后，和提示词中的插入位置完全一致；image-prompts.md 与 article.md 必须互相能对上。
• 提示词必须使用中文撰写，输出的是可直接投喂中文生图工具的完整提示词，不是零散关键词。
• 反 PPT 审美硬规则：image2 / gpt-image-2 能力足够强，提示词必须按“可直接发布的中文商业媒体视觉作品”来写，不能生成“单调背景 + 居中大字 + 几个装饰图标”的敷衍图。每张图必须有具体视觉主体、视觉类型、前景 / 中景 / 背景层次、材质、光线、镜头或视角、空间纵深和审美验收点；标题和标签只能是版式的一部分，不能替代画面主体。
• 每篇视觉必须有变化：封面和内文图保持同一色调体系，但不能每张都长成深蓝 PPT 信息卡；至少混合 2 种视觉类型，例如杂志级信息图、场景摄影感、3D 静物装置、数据新闻图、编辑部插画、拼贴海报。提示词里必须明确禁止 PPT 模板感、纯色/渐变背景加大字、空背景、大字报、廉价科技光效。
• 只要图中涉及数字、图表、榜单、时间线、标签、结论，必须写入具体数据内容：数值、单位、时间、对比关系、来源名、图表类型、排版位置，禁止写成“若干数据”“一些图表”。
• 只要图中出现文字，必须明确要求：仅使用简体中文，中文必须准确、完整、清晰可读，禁止乱码、错别字、异体字、繁简混用、无意义符号、拼音代替汉字。
• 每张图至少包含：用途、对应段落、画面目标、必须出现的数据清单、必须出现的中文文案清单、版式说明、色调/风格、正向提示词、负向提示词；如果担心工具文字能力不稳，再额外给出后期覆字说明。
• 生图额度保护硬规则：提示词不合格时禁止调用生图 API。每个待生图槽位必须先做“提示词可执行性预检”，确认画面主体、构图比例、主体占比、必须出现/禁止出现元素、中文文字清单、数据清单、版式层级、失败反例都写清楚；否则先重写提示词，不得用 API 试错。
• 提示词必须写反失败约束：凡是信息图、价格卡、时间线、对比图，正向提示词必须明确写入“这不是抽象背景图/不是渐变壁纸/不是装饰图/不是 PPT 大字背景图”，并用硬约束描述主体占比（如主体占画面 80% 以上）、卡片数量、卡片位置、标题位置、数据行数、每行文字和数字。负向提示词必须点名排除：PPT 模板感、空白背景、纯渐变背景、无卡片、无数据、错误数字、乱码、密集小字、无意义图标。
• 信息图优先少字高确定性：如果一张图需要精确中文或精确数字，最多保留 2-4 个核心数据块；超过这个数量先拆成多张图或改为正文卡片，不允许把大量小字塞给 image2 赌运气。

6b. 先为封面和所有内文图生成本地占位图文件，并保存回 {article_dir}/assets/。

• 占位图是默认交付物的一部分，即使没有生图 API 也必须存在。
• 使用稳定文件名创建占位图：assets/cover-wide.jpg、assets/cover-square.jpg、assets/img-01.jpg、assets/img-02.jpg……
• 占位图要和对应提示词绑定，至少能让用户在预览里看见版面位置、顺序和图位规模，后续只需直接覆盖同名文件即可替换。
• 可调用：python3 {skill_dir}/scripts/make_placeholder_image.py --output {article_dir}/assets/img-01.jpg --label "IMG 01" --size article
• 横版封面占位图：python3 {skill_dir}/scripts/make_placeholder_image.py --output {article_dir}/assets/cover-wide.jpg --label "COVER 2.35:1" --size cover
• 方形封面占位图：python3 {skill_dir}/scripts/make_placeholder_image.py --output {article_dir}/assets/cover-square.jpg --label "COVER 1:1" --size square

6c. 只有在 skip_image_gen = false 时才调用 image_gen.py 生成图片，并直接覆盖同名目标文件；不要额外改 Markdown 路径。

• OpenAI-compatible image2 路线已验证可用时，config.yaml 的图片段可设为：image.provider: openai、image.model: gpt-image-2、image.base_url: https://xlabapi.com/v1、image.quality: low|medium|high、image.output_format: jpeg。API key 只能放在本地私密配置或临时环境变量中，禁止写进 SKILL.md、文章正文或提示词文件。
• 对 gpt-image-* 模型，toolkit/image_gen.py 必须按 Image API 的 base64 返回格式处理图片；如果网关返回 URL，也要兼容下载并覆盖同名槽位。
• API 生图必须使用本 skill 生成的提示词，这是硬约束，不是建议：调用 image2 / OpenAI-compatible 图片 API 时，必须以 Step 6a 已生成并保存到 {article_dir}/generated/image-prompts.md 的对应槽位提示词为准。禁止临场绕过 image-prompts.md 手写一段新 prompt 直接调用 API；如果需要改 prompt，先改 generated/image-prompts.md，再按文件里的版本调用 API。
• 提示词变更必须先落盘：如果生成结果不合格，需要优化提示词，必须先更新 {article_dir}/generated/image-prompts.md 中对应槽位的正向提示词、负向提示词和验收约束，再用更新后的提示词重新调用 API。API 调用内容必须能在 image-prompts.md 中追溯。
• 槽位一一对应：每次 API 生图前必须确认槽位编号、目标文件名、正文图位、alt 文案、图例说明和 image-prompts.md 中的提示词一致；不得用 A 图提示词生成 B 图文件，不得把未记录在提示词文件里的临时创意覆盖正式槽位。
• 禁止批量盲跑：使用 image2 生图时必须按槽位逐张生成、逐张验收，不能一次性批量生成全部图片后才检查。优先顺序：cover-wide.jpg → cover-square.jpg → img-01.jpg → img-02.jpg……每张通过后再进入下一张。
• 单张验收门槛：生成后必须查看图片文件，按提示词逐项验收：主体是否存在、是否不是抽象背景、文字是否基本可读、关键数字是否出现且未明显错误、图像是否和正文图例一致、是否适合手机端阅读。验收不通过时，只重写该槽位提示词并覆盖该槽位，禁止重跑已经合格的图片。
• 额度节省策略：同一槽位最多连续重试 2 次；第 1 次失败必须先指出失败原因并改提示词，第 2 次仍失败时保留当前最优图和提示词，向用户说明风险，不得继续无上限消耗额度。除非用户明确要求“继续重试”。
• 不允许用本地排版伪装生图结果：用户要求 image2 生图时，失败修复必须通过优化 image2 提示词重新生成；本地脚本排字、PIL 合成、截图式替代只能在用户明确同意时使用。

降级：生图失败或无 API → 保留 {article_dir}/generated/image-prompts.md 和同名占位图作为降级交付物，可以继续生成预览；但这属于 warning，不能算通过，不能推草稿箱，除非用户明确接受降级且本次结果标记为 DONE_WITH_CONCERNS。

---

Step 7: 预检 + 排版 + 发布

7a. Metadata 预检（发布前必须通过）：

检查项	标准	不通过时
H1 标题	存在且 5-64 字节	自动修正；修不掉则 BLOCKED
摘要	存在且 ≤ 120 UTF-8 字节	converter 自动生成；仍不合格则 BLOCKED
封面图	assets/cover-wide.jpg 与 assets/cover-square.jpg 都存在	立即补齐；无封面不允许推送
正文字数	≥ 200 字	立即补写；内容过短不允许作为 warn 放行
图片数量	≤ 10 张且所有本地图片存在	立即修正；缺图或超量不允许发布

预检全部通过且 warning 数为 0 后才进入排版。任何 warning 都必须改成 pass，不允许“先发再说”。

7b. 排版 + 发布：

如果 skip_publish = true → 直接走 preview。

• 先读取：{skill_dir}/references/template-workflow.md，发草稿时一律以这份规则为准。
• toolkit/cli.py publish 不再是默认草稿发布入口；默认发布只走 scripts/publish_wechat_article.ps1。

读取: {skill_dir}/references/wechat-constraints.md
读取: {skill_dir}/references/layout-playbook.md

Converter 自动处理：CJK 加空格、加粗标点外移、列表转 section、外链转脚注、暗黑模式、容器语法。

• 预览和发布都基于 article.md 中已经插入好的图位执行，因此占位图和正式图都必须使用正文中的同一路径。
• 草稿箱发布默认使用 draft-metadata.json 里的 cover_image；未显式指定时默认取 assets/cover-wide.jpg，配套方封面保存在 assets/cover-square.jpg。
• scripts/render_wechat_article.ps1 会自动补跑 quality-gates；scripts/publish_wechat_article.ps1 会以零容忍严格模式再次执行，出现任何 fail、warn 或 skip 都直接中止发布。
• 发布器直接走 Python 微信 API，不依赖 md2wechat.exe；需要显式配置时给 scripts/publish_wechat_article.ps1 传 -Config "<config.yaml 路径>"。
• 发布前可用 -DryRun 验证入口、配置解析、渲染、质量门禁和预检，不上传素材、不创建或更新草稿。
• 跨平台入口保留 PowerShell wrapper，但 Python 与路径解析按平台分支处理：macOS/Linux 优先 .venv/bin/python，Windows 优先 .venv\Scripts\python.exe；不要在脚本里硬编码混用 / 和 \。
• 发布前再做一次排版验收：开头 4 段内是否已经亮出冲突/判断；全文是否至少有 2 种非纯正文模块；是否存在连续 3 个大段纯正文；图位和图例是否都已经补齐；layout_diversity 是否没有重复最近 2 篇的主题/版式/模块序列。任意一项不满足都算 warning，必须修复到 0。
• 如果用户强调“排版别太单调”或当前成稿明显偏平，先额外生成 {article_dir}/theme-gallery.html 对比不同主题渲染效果，再决定最终 --theme

# 本地渲染 / 预览
powershell -ExecutionPolicy Bypass -File {skill_dir}/scripts/render_wechat_article.ps1 -ArticleDir "{article_dir}"

# 单独查看质量门禁报告
powershell -ExecutionPolicy Bypass -File {skill_dir}/scripts/check_wechat_article.ps1 -ArticleDir "{article_dir}"

# 发布到公众号草稿箱
powershell -ExecutionPolicy Bypass -File {skill_dir}/scripts/publish_wechat_article.ps1 -ArticleDir "{article_dir}"

# 指定配置并只做干跑验证
powershell -ExecutionPolicy Bypass -File {skill_dir}/scripts/publish_wechat_article.ps1 -ArticleDir "{article_dir}" -Config "{config_path}" -DryRun

---

Step 8: 收尾

8a. 写入历史（推送成功或降级都要写，文件不存在则创建）：

# → {skill_dir}/history.yaml
- date: "{日期}"
  title: "{标题}"
  topic_source: "热点抓取"  # 或 "用户指定"
  topic_keywords: ["{词1}", "{词2}"]
  framework: "{框架}"
  theme: "{本次 theme}"
  theme_mode: "{auto/fixed}"
  layout_family: "{本次 layout_family}"
  layout_variant: "{本次 layout_variant}"
  module_pattern: "{本次 module_pattern}"
  word_count: {字数}
  media_id: "{id}"  # 降级时 null
  writing_persona: "{人格名}"
  dimensions:
    - "{维度}: {选项}"
  stats: null

8b. 回复用户：

• 最终标题 + 2 备选 + 摘要 + 5 标签 + media_id
• 本次文章目录：{article_dir}；其中至少包含 article.md、draft-metadata.json、assets/、generated/image-prompts.md、article-body.template.html
• 编辑建议："文章有 2-3 个编辑锚点，建议花 3-5 分钟加入你自己的话，效果更好。"
• 飞轮提示："编辑完成后说**'学习我的修改'**，下次初稿会更接近你的风格。"

8c. 后续操作：

用户说	动作
润色/缩写/扩写/换语气	编辑文章
封面换暖色调	重新生图
用框架 B 重写	回到 Step 4
换一个选题	回到 Step 2c
看看有什么主题	python3 {skill_dir}/toolkit/cli.py gallery
换成 XX 主题	重新渲染
看看文章数据	读取: {skill_dir}/references/effect-review.md
学习我的修改	读取: {skill_dir}/references/learn-edits.md
做一个小绿书/图片帖	python3 {skill_dir}/toolkit/cli.py image-post img1.jpg img2.jpg -t "标题"
诊断配置 / 检查反AI / 为什么AI检测没过	python3 {skill_dir}/scripts/diagnose.py --json + LLM 交叉分析

---

错误处理

步骤	降级
环境检查	逐项引导，设降级标记；降级产物只能 DONE_WITH_CONCERNS，不能 DONE
热点抓取	WebSearch 替代；若素材不足导致 warning，必须补足后继续
选题为空	请用户手动给选题
SEO 脚本	LLM 判断仅作临时分析；最终 seo-report.json 不得有 warn
素材采集（WebSearch）	LLM 训练数据中可验证的公开信息；必须明确标注素材不足，不能作为发布通过
维度随机化	history 空时跳过去重；不得产生 quality-gates warning
Persona 文件不存在	先修复 persona 配置；不得静默回退后继续通过
去 AI 验证	3 次重写不过则 BLOCKED，不允许跳过该项
生图失败	保留提示词和占位图仅作降级交付；发布通过仍要求 warn=0
推送失败	本地 HTML 可作为降级产物，但不能 DONE
历史写入	写入失败必须报告并重试；仍失败则 DONE_WITH_CONCERNS
效果数据	告知等 24h
Playbook 不存在	先生成或说明阻塞；不得把缺失 playbook 当作通过状态