Wechat Article Pipeline

SKILL.md

---
name: wechat-article-pipeline
description: 编排微信公众号文章从写作策略、HTML 主稿、确认后 AI 写作风险审核、配图确认、样式审核到微信排版预览的完整流水线。适用于用户要求一条龙生成公众号文章、先写再查 AI 痕迹再排版、生成可复制到微信后台的文章、公众号文章流水线、写作-审核-配图-排版闭环；开头询问是否自动执行所有流程，用户选择自动执行后中间不再反复确认，直接调用 `ai-writing-risk-review` 独立审核、默认调用 `article-image-research` 调研配图；其中 AI 风险审核必须由独立子代理执行。
---

# 微信文章完整流水线

## 用途

用这个技能作为入口，顺序编排微信公众号文章生成流程：以 `wechat-article-writer` 的写作标准作为写作指南，再用 `wechat-article-formatter` 直接生成第一版 HTML 主稿；随后从 HTML 中复制或抽取正文纯文本，交给独立子代理调用 `ai-writing-risk-review` 审核 AI 写作风险；审核完成或用户确认跳过后，进入配图确认环节，默认调用 `article-image-research` 调研配图，也允许用户自行提供图片；配图确认后围绕同一份 HTML 主稿做内容修订和样式审核，最后交付可复制到微信后台的 HTML 或本地预览页。

这个技能是一个流程编排器，不替代三个子技能的专业判断。执行时默认使用本文的固定顺序和验证门槛；开始时先询问用户是否自动执行所有流程。用户选择自动执行后，把后续门控视为一次性授权，按默认策略连续执行到最终交付；用户选择不自动执行或未明确选择时，继续使用逐步确认的现有流程。只有用户明确要求跳过某一步时，才说明风险并按用户要求调整。

## 自动执行开关

进入流水线后，第一步必须先向用户询问：

```text
是否自动执行所有流程？选择“是”后，我会按默认策略连续完成大纲、HTML 主稿、AI 风险审核、配图调研、样式审核、修订复审和最终交付，中间不再逐步确认；选择“否”则每个关键节点继续按现有流程请你确认。
```

- **用户选择自动执行**：记录为 `auto_run: true`，后续不再因大纲确认、AI 审核确认、配图搜索计划确认、样式修订或复审而停下来等待用户。按默认策略执行：大纲自动通过、AI 风险审核自动执行、没有用户自供图片时默认启动 `article-image-research`，并在调用该能力模块时明确传入“用户已选择自动执行，不需要搜索前二次确认，输出计划后直接搜索”。最终交付本地预览页或可复制 HTML。
- **用户选择不自动执行**：记录为 `auto_run: false`，所有关键节点继续按本文的确认门控执行。
- **用户已经明确说“全自动”“不用确认”“直接跑完”“按默认方案执行”**：可视为 `auto_run: true`，但仍在开头用一句话回显“已按自动执行处理”，不再停下等待。
- 自动执行不绕过工具凭据、文件缺失、合规限制、事实核验或高风险内容边界；遇到无法合理假设的问题时，说明阻塞点并暂停。

## 执行清单

开始后用这张清单跟踪进度，并在每一步完成后更新状态：

- [ ] 任务卡：整理主题、读者、目标、资料、限制和交付形态。
- [ ] 自动执行选择：询问并记录 `auto_run`；若用户已明确要求全自动，则回显并继续。
- [ ] 写作策略与框架大纲：按 `wechat-article-writer` 规则确定标题承诺、大纲结构、声口和事实边界，并生成标题备选。
- [ ] 大纲确认：`auto_run: false` 时将文章大纲/框架及标题备选反馈给用户，停下来并明确获得用户确认；`auto_run: true` 时输出简短大纲记录后继续。
- [ ] HTML 主稿：大纲确认或自动通过后，用 `wechat-article-formatter` 生成第一版可预览 HTML。
- [ ] 正文抽取：从 `article#wechatArticle` 抽取纯文本。
- [ ] 审核确认：`auto_run: false` 时向用户确认是否需要进行 AI 写作风险审核；`auto_run: true` 时默认执行审核。
- [ ] 独立审核：确认后或自动执行模式下启动子代理，用 `ai-writing-risk-review` 审核 AI 写作风险（若用户选择跳过，则标记为已跳过）。
- [ ] 配图确认：AI 审核完成或确认跳过后，`auto_run: false` 时向用户确认配图方案；`auto_run: true` 时按用户已给图片或默认 `article-image-research` 找图继续。
- [ ] 样式审核：检查 HTML 主稿结构、视觉层级、本地图片内联（由 formatter 处理）和已确认配图的呈现。

### 1. 制定写作策略与大纲框架确认

先用 `wechat-article-writer` 的规则确定文章策略与大纲结构（包括目标读者、文章目标、标题承诺、文章类型、主声口、开头钩子、3 到 5 个正文部分大纲结构和结尾动作），并准备至少 3 个标题备选。

`auto_run: false` 时，**在此阶段必须停下来将上述大纲框架反馈给用户。明确获得用户确认并达成一致后，方可进入下一步撰写正文 HTML 主稿。**

`auto_run: true` 时，不等待确认；只输出简短大纲记录和采用的标题方向，然后继续生成正文 HTML 主稿。

### 2. 生成第一版 HTML 主稿

大纲框架获得用户确认或在自动执行模式下自动通过后，用 `wechat-article-formatter` 根据确认或自动采用的大纲、资料和写作目标生成第一版 HTML 主稿。交付给下一步前，主稿至少包含：

- 选定的主标题和至少 2 个备选标题。
- 可选摘要。
- 可直接预览和复制的 HTML 主稿，正文集中在 `article#wechatArticle`。
- 主要正文、小节标题、摘要块、引用块、重点提示等读者可见结构。
- 图片占位或配图说明。
- 对关键事实、引用、数据和不确定处的备注应作为内部复核材料或最终回复说明；除非用户明确要求、原文已有、或正文必须向读者展示引用，不要把来源清单、引用备注、发布前风险等内部整理内容写进 `article#wechatArticle`。

第一版就应该接近最终阅读形态。写作质量必须以 `wechat-article-writer` 的文章策略和中文语感规则为准，不要为了样式牺牲事实准确和自然表达。
- 文章目标：打开率、读完率、收藏转发、建立信任、转化或公告通知。
- 资料来源、必须保留的事实、禁用表达和口吻要求。
- 期望长度、标题数量、是否需要摘要、配图计划、是否需要本地 HTML 预览。
- 排版主题；没有指定时让 `wechat-article-formatter` 使用默认主题。

如果关键信息缺失但可以合理推进，先写明假设再继续。涉及强时效事实、政策、金融、医疗、法律或具名争议事件时，先核验资料再进入正文写作。

## 默认策略

- 默认生成本地完整 HTML 预览页；用户明确要求正文片段或后台复制用 HTML 时，交付 `article#wechatArticle`。
- 默认不向正文写入内部复核材料、来源清单、发布前风险或审核报告；这些内容放在最终回复说明。
- 默认保留用户提供的原文事实、观点、专有名词、口吻限制和必须出现的信息；修订只围绕表达、结构、AI 风险和微信排版适配进行。
- 默认最多两轮 AI 风险复审；第二轮仍为中高风险时停止最终排版交付，改交风险报告和修订稿。
- 默认在 AI 审核完成或用户确认跳过 AI 审核后进入配图确认；用户可自行提供图片，未提供时默认使用 `article-image-research` 调研候选图。
- 默认以 HTML 主稿为唯一正文主稿；不要维护 Markdown 和 HTML 两份正文。
- 自动执行模式下默认开启 AI 风险审核和配图调研；最终只进入预览或 HTML 交付。

## 常见误用

- 不要先写 Markdown 再转换，除非用户明确要求 Markdown 交付；本流程第一版主稿就是 HTML。
- 不要在 `auto_run: false` 时未向用户反馈大纲并获得确认就擅自生成/撰写 HTML 主稿。必须先获得用户的大纲确认门控。
- 不要在 `auto_run: false` 时未向用户确认就擅自启动 AI 写作风险审核。必须引导用户确认后再执行。
- 不要把自动执行理解成微信后台自动操作；本流程只交付本地预览页或可复制 HTML。
- 不要让主线程自己完成 `ai-writing-risk-review` 审核；AI 写作风险必须由独立子代理判断。
- 不要把 HTML 标签、预览工具栏、脚本或样式说明发给 `ai-writing-risk-review`；送审文本必须是读者可见纯文本。
- 不要把“资料来源”“引用和备注”“发布前复核”“AI 风险报告”写成正文固定章节，除非用户明确要求或文章语境必须展示。
- 不要在最终阶段新增事实、观点或大段重写；最终阶段只做清理、主题化和复制适配。

## 顺序流程

### 1. 写作指导下的排版首稿：生成第一版 HTML 主稿

先用 `wechat-article-writer` 的规则确定文章策略，再用 `wechat-article-formatter` 直接根据任务卡、资料和写作目标生成第一版 HTML 主稿。

`wechat-article-writer` 在这里负责提供写作参考

- 目标读者、文章目标、标题承诺、文章类型和主声口。
- 开头钩子、正文结构、段落节奏、标题备选和结尾动作。
- 事实准确、中文语感、去 AI 腔、具体细节和作者判断。

`wechat-article-formatter` 负责把上述写作判断直接落实成可预览、可复制的 HTML 主稿。交付给下一步前，主稿至少包含：

- 主标题和至少 2 个备选标题。
- 可选摘要。
- 可直接预览和复制的 HTML 主稿，正文集中在 `article#wechatArticle`。
- 主要正文、小节标题、摘要块、引用块、重点提示等读者可见结构。
- 图片占位或配图说明。
- 对关键事实、引用、数据和不确定处的备注应作为内部复核材料或最终回复说明；除非用户明确要求、原文已有、或正文必须向读者展示引用，不要把来源清单、引用备注、发布前风险等内部整理内容写进 `article#wechatArticle`。

第一版就应该接近最终阅读形态。写作质量必须以 `wechat-article-writer` 的文章策略和中文语感规则为准，不要为了样式牺牲事实准确和自然表达。

### 3. 正文抽取：抽取正文送审

审核前先从 HTML 主稿中抽取纯文本：

- 复制或抽取 `article#wechatArticle` 内的正文文本，去掉所有 HTML 标签、样式属性、预览工具栏、批注气泡和脚本。
- 保留标题、摘要、小标题、正文、列表、引用和正文中自然出现的事实限定。
- 不要为了送审额外把内部来源清单、引用备注、发布前风险说明加入待审稿；这些内容只在它们已经是读者可见正文时抽取。
- 把抽取后的纯文本作为 `ai-writing-risk-review` 的待审稿；不要把 HTML 标签当作待审文本。

如果 HTML 结构本身可能影响文章可信度或阅读节奏，把相关问题留给后面的样式审核，不要混进 AI 写作风险审核。

### 4. 审核确认与独立审核：确认后审核 AI 写作风险

正文抽取完成后，`auto_run: false` 时**必须先向用户询问并确认是否需要进行 AI 写作风险审核**；`auto_run: true` 时默认直接执行 AI 写作风险审核：

- **用户确认审核**：启动一个独立子代理执行审核。子代理的任务是调用 `ai-writing-risk-review`，只做 AI 写作风险和文本证据审核，不负责重写文章。
- **用户确认跳过**：说明可能存在的 AI 痕迹风险，并标记本步骤为“已跳过”，直接进入“配图确认”阶段。

给子代理的上下文只包含：

- 任务卡。
- 从 HTML 主稿抽取出的完整纯文本待审稿。
- 需要特别关注的口吻、目标读者和平台场景。
- 明确要求：使用 `ai-writing-risk-review` 输出风险等级、主要证据、反证解释和修订建议。

不要把主线程的自评、希望通过的结论或拟定修订方案发给子代理。审核完成前不要做最终交付确认。

推荐子代理提示词：

```text
使用 $ai-writing-risk-review 审核下面这篇微信公众号草稿的 AI 写作风险。请输出：结论一句话、风险等级和证据强度、样本限制、主要证据、反证或可替代解释、下一步修订建议。不要重写正文。
```

### 5. 配图确认：确认图片来源和正文使用方式

AI 写作风险审核完成后，或用户确认跳过 AI 审核后，**必须进入配图确认环节**。此步骤先决定图片来源和使用方式，再进入样式审核。

- **用户提供图片**：接收用户提供的本地路径、URL、素材说明或封面/正文图片区分；确认图片分别支撑哪一段、是否需要图注、是否存在版权或肖像风险。
- **用户未提供图片**：默认调用 `article-image-research` 调研候选图。`auto_run: false` 时调用前按该能力模块要求先输出搜索计划，让用户确认或调整后再搜索；`auto_run: true` 时传入“用户已选择自动执行，不需要搜索前二次确认，输出计划后直接搜索”。
- **用户明确不需要配图**：记录为“已确认不配图”，保留必要的图片占位说明或删除不需要的占位。

配图确认输出至少包含：

- 正文图片清单：每张图片对应的小节、用途、来源、授权/归因、风险标记和推荐图注。
- 封面候选：如果用户需要封面，记录封面图路径、URL 或待用户提供项。
- 处理决策：哪些图片进入正文、哪些作为备选、哪些拒绝使用。

不要把未确认授权、来源或上下文的图片写入 `article#wechatArticle`。AI 生成图只能按 `article-image-research` 的规则作为低优先级备选，并必须标记为生成图。

### 6. 样式审核：检查微信正文结构

配图确认完成后，在主线程对 HTML 主稿做一次样式审核。样式审核不判断 AI 痕迹，只检查微信文章结构、视觉层级和已确认配图的呈现：

- `article#wechatArticle` 或可放入该节点的 HTML 片段是否干净，没有重复嵌套、脚本、外部样式依赖或调试内容。
- 正文默认不包含一级标题 `h1`；主标题用于预览页标题、公众号后台标题或最终交付说明。除非用户明确要求、原文已有且必须保留，或交付物就是需要自带标题的独立正文，否则从 `article#wechatArticle` 删除重复的 H1 或大型标题。
- 主要 H2 上方是否有短 `moduleLabel` 序号标签，如 `01 / 问题入口`，且序号不塞进 H2。
- 主要 H2 是否尽量采用自然中文的两段式标题，能同时说明主题和判断、张力或收益。
- 段落是否有阅读节奏，是否存在连续大段、空泛标题、机械小标题或样式堆叠。
- `quote`、`callout`、`summary`、列表、图片说明是否用在真正需要的地方。
- 已确认图片是否使用稳定的 `figure` / `img` / `figcaption` 结构，图注是否贴近图片并保留必要来源。
- **本地图片资源处理**：对于所有使用本地图片（如封面或正文插图）的文章，在交付或生成预览前，必须通过 `wechat-article-formatter` 处理将相对路径图片内联为 Base64 Data URL，彻底防止本地 `file://` CORS 跨域限制导致的微信后台图片失效。
- 是否删除未确认、无来源、无授权或只作装饰的图片占位。
- 是否误把内部复核材料写成读者可见章节，如“资料来源”“引用和备注”“发布前复核”；若用户未要求且正文不需要，直接从 `article#wechatArticle` 删除。
- 是否适合微信复制：没有未闭合标签、横向滚动风险、外部 CSS/JS 依赖、不可复制的交互组件。

样式审核发现的问题，直接修改 HTML 主稿。需要改正文含义时，也优先在 HTML 主稿中修改；只有遇到大幅重写、标题策略重做或中文表达整体失衡时，才参考 `wechat-article-writer` 的写作规则辅助修订。

### 7. 修订门控：根据审核结果决策

根据子代理审核结果处理：

- `低风险` 或 `证据不足`：保留 HTML 主稿，只修正明确的错别字、事实标注、轻微表达问题和样式审核发现的结构问题。
- `中风险`：直接修改 HTML 主稿，重点补足具体细节、作者判断、材料出处、段落节奏和不机械的小标题；修订后重新抽取纯文本，再次让子代理审核，并复查样式。
- `高风险`：不要直接交付。先说明风险点，再在 HTML 主稿中重写相关段落或全文；完成后重新抽取纯文本，再次让子代理审核，并复查样式。

最多连续两轮修订。第二轮后仍为中高风险时，停止排版并把风险报告、已修订稿和建议交给用户。

### 8. 最终确认：交付可用结果

只有通过修订门控后，才交付最终 HTML 或预览页。

- 以已通过审核（或确认跳过审核）、配图确认和样式审核的 HTML 主稿为唯一正文主稿，不再回写 Markdown。
- 保持已通过审核（或确认跳过审核）的正文含义，不做实质性改写。
- 最终阶段只做主题化、行内样式、预览页、复制能力和必要的 HTML 清理。
- 用户要后台复制用 HTML、接口交接或正文片段时，输出 `article#wechatArticle`。
- 用户只说生成、预览、排版或没有指定交付形态时，默认生成本地完整 HTML 预览页。
- 若用户指定主题，把主题要求传给 `wechat-article-formatter`；没有指定则使用其默认主题。

## 最终交付

最终回复应包含：

- 正文是否经过独立子代理审核（或经用户确认跳过）。
- 若进行了审核，最终 AI 写作风险等级和一句话证据摘要。
- 配图确认结果：用户自供图片、`article-image-research` 搜索结果或确认不配图；若使用图片，说明来源、授权/归因和风险。
- 样式审核是否通过，以及是否存在需要用户确认的视觉或结构问题。
- 排版交付物路径或 `article#wechatArticle` 结果说明。
- 若有未核验事实、图片版权、引用来源或发布前风险，在最终回复中明确列出；不要默认写入可复制正文。

不要把审核报告全文塞进最终回复，除非用户要求。保留高信号摘要即可。

## 验证闭环

最终交付前按以下顺序自检；发现问题就回到对应步骤修正：

1. 流程验证：确认已询问并记录 `auto_run`；`auto_run: false` 时确认在撰写正文前已向用户反馈并获得大纲框架确认，且已向用户征询 AI 审核和配图确认；`auto_run: true` 时确认已按默认策略连续执行。
2. 内容验证：确认最终 HTML 没有引入审核（或确认跳过）后新增的大段事实、观点或未经用户确认的材料。
3. 结构验证：确认 `article#wechatArticle` 干净、可复制、无脚本、无外部 CSS/JS 依赖。
4. 风险验证：确认最终回复包含 AI 风险（或跳过说明）、配图来源与版权风险、样式审核结论和未核验风险。
5. 交付验证：确认用户能直接使用交付物进行微信后台复制或本地预览。

## 成功标准

- 流程顺序固定为：`自动执行选择 -> wechat-article-writer 制定策略与大纲框架 -> 大纲确认或自动通过 -> wechat-article-formatter 第一版 HTML 主稿 -> 正文抽取/复制 -> AI 审核门控或自动审核 -> 子代理(ai-writing-risk-review，若确认或自动执行) -> 配图确认或自动调研(用户自供或默认 article-image-research) -> 样式审核 -> HTML 修订门控 -> 最终交付`。
- AI 写作风险审核必须在独立子代理中完成，主线程只接收并执行审核建议。
- AI 写作风险审核使用从 HTML 主稿抽取出的纯文本；配图确认发生在 AI 审核完成或确认跳过之后；样式审核使用已完成配图确认的 HTML 主稿。
- 修订阶段以 HTML 主稿为准，不维护 Markdown 和 HTML 两份正文。
- 最终交付阶段不引入新的事实、观点或大段重写。
- 来源、引用、事实风险、发布前注意事项默认作为交付说明输出给使用技能的用户，不作为文章正文模块输出。
- 交付物能直接用于微信后台复制或本地预览。