wxmp-workflow

name: wxmp-workflow preamble-tier: 4 version: 1.0.0 description: | 微信公众号全流程工作流 — 从发现灵感、撰写文章到创建草稿。 覆盖选题策划、竞品分析、文章撰写、HTML 排版、API 创建草稿、数据统计全链路。 个人订阅号无认证时发布会引导用户去后台手动操作。 Use when: "公众号", "写文章", "发文", "选题", "涨粉", "内容运营", "草稿箱", "帮我写篇公众号", "最近公众号没什么灵感", "公众号文章", "发布到公众号". Proactively suggest when the user mentions writing articles, content creation, or WeChat Official Account related tasks. triggers: - 公众号 - 写文章 - 发文 - 选题 - 内容运营 - 草稿箱 - 涨粉 allowed-tools: - Bash - Read - Write - Edit - WebSearch - WebFetch

微信公众号工作流

一站式完成公众号内容创作：选题（三模式扫描）→ 大纲 → 调研 → 写稿 → 打磨 → 配图 → 排版 → 发布 → 复盘。

核心约束

一个对话只做一篇文章。 第一次创建草稿时记住 media_id，后续所有操作（修改、发布）都复用它。如果用户想写新文章，提示"请开一个新对话"。

运行模式

半自动卡点： 选题确认、大纲确认、初稿审阅、配图确认、体检报告、标题选择、发布确认

全自动策略： 优先选信息差最大 + 受众匹配度最高的选题、按大纲直接写、根据体检报告自动优化、优先选爆款潜力最高的标题（口语法 > 好奇法 > 痛点法 > 数字法 > 对比法 > 权威法）、标题与内容对齐、打磨完成后跳过预览。草稿在排版阶段创建，打磨/配图可能修改 HTML，发布前用 --media-id 更新草稿确保内容是最新的。注意：全自动只能创建草稿，发布仍需用户去公众号后台手动操作（个人订阅号无 API 发布权限）。

全自动失败处理： 某个步骤失败时不中断全流程——跳过失败步骤继续，最后汇总报告哪些步骤成功、哪些失败。常见情况：图片生成失败 → 跳过配图继续排版；信源访问失败 → 用其他信源的结果。

步骤状态标记： 每完成一个步骤，MUST 输出状态标记，格式为 ✅ 步骤 N：步骤名 — 一句话说明结果。示例：

✅ 步骤 1：选题 — 推荐 3 个选题，已确认「AI 写作工具对比」
✅ 步骤 2：大纲 — 4 章结构，已确认
✅ 步骤 3：调研 — 搜集 5 条素材
✅ 步骤 4：写初稿 — 2100 字，已审阅

这让用户随时知道进度到哪了，也防止 AI 跳步骤。

意图路由

如果不确定用户意图，直接问。

完整流程

1. 选题

三种发现模式综合扫描，每种都执行，综合推荐 3-5 个选题：

• 热点速报（默认）：当日新闻 + 热搜验证，找有流量基础的话题
• 深度选题：原始信源（GitHub Trending、Hacker News、Product Hunt、TradingView 等）提前发现线索，找信息差
• 预判选题：周期性事件（大会、财报、新品发布）提前准备内容

三种模式结果汇总后去重排序，每个选题标注来源路线和推荐理由。

访问外部信源时使用连通性缓存（config/connectivity.json），自动探测并记录每个信源的最佳访问方式（直接/代理/搜索），无需预设哪些站被墙。

半自动： 展示选题清单，让用户选择 全自动： 自动选信息差最大 + 受众匹配度最高的选题

详细流程见 references/wxmp-inspiration.md

2. 大纲

根据选题生成结构化大纲，确定文章要讲什么、分几部分。大纲确认后再调研和写稿，避免返工。

半自动： 展示大纲等用户确认 全自动： 生成大纲后直接进入调研

大纲格式见 references/wxmp-outline.md

3. 调研

拿着大纲，按每个章节搜集写作素材。不要凭空编造，用真实数据和案例支撑文章。

素材来源： 竞品同类文章、行业报告/数据、权威引用、用户案例/故事

半自动： 展示素材清单，问用户是否补充 全自动： 直接整理好素材包供写稿使用

详细流程见 references/wxmp-research.md

4. 写初稿

按大纲撰写 Markdown 全文。口语化、适合手机阅读、1500-3000 字。遵循中文文案排版指北（references/chinese-copywriting-guidelines.md）的盘古之白、全角标点规范，以及排版设计规范（references/wxmp-typography.md）的字号、间距、视觉节奏、开头策略。英文术语按 references/wxmp-writing.md 的英文处理规则判断保留/翻译/音译。涉及数据/事件/他人观点时标注来源，外链用上标脚注引用、文末统一列出（微信不支持正文内可点击外链），截图比链接更好。

半自动： 写完让用户审阅 全自动： 写完直接进入打磨

详细写作要求见 references/wxmp-writing.md

5. 打磨

写完初稿后，先去 AI 味，再跑体检报告，针对性优化，最后生成标题和摘要。每一步都是必经步骤，MUST NOT 跳过。

去 AI 味： 优先使用 Humanizer（去 AI 痕迹）+ StopSlop（质量打磨），否则用内置 4 轮扫描：

1. 查特征词：替换 AI 高频词（赋能/深耕/打造）、删除套话（值得注意的是/在当今社会）
2. 查结构：打破刻板结构、排比堆砌、段落雷同
3. 查风格：加情绪起伏、换口语称呼、补具体案例
4. 加人味：补个人经历、明确立场、加入口语感和幽默感

详细打磨流程见 references/wxmp-polish.md

体检维度： 开头吸引力、段落可读性、结构清晰度、金句密度、结尾引导力

生成标题和摘要： MUST 调用 references/wxmp-tools.md 的爆款标题生成器和摘要生成器。NEVER 自己编标题——必须用生成器产出 12 个候选标题 + 3 个摘要版本，交给用户选择。这是半自动模式的强制卡点。

半自动： 展示体检报告问用户要不要改 → 展示标题/摘要候选让用户选 全自动： 根据报告自动优化 → 按策略自动选标题（口语法 > 好奇法 > 痛点法）

体检报告用法见 references/wxmp-tools.md

6. 配图

在合适的位置添加图片，增强文章表现力。

风格生成： 根据文章内容和情感基调决定风格。概念型配图（开头、结尾、隐喻、案例）走 references/wxmp-style-generator.md 的流程。证据截图、数据图表、步骤图直接写 prompt。

适合加图的位置： 开头配图、数据图表、步骤截图、结尾引导图

图片来源： 用户自己提供 / AI 生成（Agnes 或 SenseNova）

底线： 图片中不能有文字、不能有真人、不能有图表/流程图。AI 生成时 prompt 末尾加 no real people, no human faces, no text, no labels, no chart, no diagram

AI 生成： prompt 格式 = 视觉描述 + 场景 + 底线。优先 Agnes，失败切 SenseNova：

bash scripts/wx-generate-image.sh \
  --prompt "Warm orange and golden yellow tones, soft light from above. A ladder extends from bottom center up into soft clouds. no real people, no human faces, no text, no labels, no chart, no diagram" \
  --size 1024x768
bash scripts/wx-generate-image-sensenova.sh \
  --prompt "Warm orange and golden yellow tones, soft light from above. A ladder extends from bottom center up into soft clouds. no real people, no human faces, no text, no labels, no chart, no diagram" \
  --size 2752x1536

上传：

bash scripts/wx-upload-image.sh /path/to/image.jpg          # 正文配图
bash scripts/wx-upload-image.sh /path/to/cover.jpg thumb     # 封面图

半自动： 风格展示给用户确认 → 生成配图 全自动： 直接生成

详细规则见 references/wxmp-images.md

7. 排版

将 Markdown 文章转为公众号兼容的 HTML 格式，保存到 output/。

5 个精美模板可选：

全自动： AI 根据文章类型自动选择模板（选择策略见 templates/README.md） 半自动： MUST 列出 5 个模板让用户选择。NEVER 替用户选模板——即使你觉得某个模板明显更适合，也必须让用户确认。

公众号 HTML 的关键约束：只能用内联 style，不能用外部 CSS/JS，图片必须是微信 CDN 地址。

模板详情见 templates/README.md，转换方法见 references/wxmp-html.md

8. 发布

⚠️ 个人订阅号通常没有个人认证，预览和发布 API 不可用。但创建草稿和查询数据不需要认证。

读取 config/wxmp.json 的 verified 字段确定走哪条路。如果字段不存在，按 false 处理。

默认路径（verified: false）：用 API 创建草稿，引导手动发布

# 1. 获取 token（自动缓存 2 小时）
bash scripts/wx-auth.sh

# 2. 上传封面图（注意 thumb 类型）
bash scripts/wx-upload-image.sh /path/to/cover.jpg thumb

# 3. 创建草稿（记住返回的 media_id）
bash scripts/wx-draft.sh --title "标题" --content output/xxx.html --thumb MEDIA_ID \
  --author "作者" --digest "摘要" --comment 1

# 4. 如果后续修改了内容，更新草稿（复用 media_id）
bash scripts/wx-draft.sh --media-id DRAFT_MEDIA_ID --title "新标题" \
  --content output/xxx.html --thumb MEDIA_ID

草稿创建成功后，引导用户去公众号后台完成剩下的操作：

1. 内容管理 → 草稿箱 → 找到草稿
2. 在手机上预览效果
3. 确认无误后点击发布

已认证账号（verified: true）：可用 API 预览和发布

# 预览（发到用户微信号）
bash scripts/wx-preview.sh --media-id DRAFT_MEDIA_ID --wx-name 微信号

# 发布（异步操作，脚本自动轮询状态）
bash scripts/wx-publish.sh --media-id DRAFT_MEDIA_ID

查数据（无需认证）：

bash scripts/wx-stats.sh --recent 7          # 最近 7 天每日汇总
bash scripts/wx-articles.sh --count 20       # 最近 20 篇，用 --offset 翻页
bash scripts/wx-article-stats.sh --recent 7  # 最近 7 天单篇详情

半自动： 创建草稿 → 引导用户去后台预览 → 用户确认后（手动）发布 全自动： 自动创建草稿，告知用户"草稿已就绪，去公众号后台手动发布"

详细流程见 references/wxmp-publishing.md

9. 复盘

用户回来说"帮我查数据"时启动。先读 config/wxmp.json 的 verified 字段。

• verified: false（无认证）： 告知用户"未认证账号无法通过 API 查询数据，去公众号后台的数据统计页面查看。"
• verified: true（已认证）： 正常执行复盘流程：

1. 跑 wx-articles.sh 拉已发布文章列表
2. 用户选择要复盘的文章
3. 检查发布时间是否已过 1 天
4. 跑 wx-article-stats.sh 查数据
5. 输出 HTML 复盘报告

详细流程见 references/wxmp-publishing.md 的复盘章节

增强工具

随时可调用，不绑定特定阶段：

详细用法见 references/wxmp-tools.md

配置说明

首次使用需要配置。配置文件 config/wxmp.json 支持两个位置（当前目录优先）：

详细流程见 references/wxmp-setup.md

• 当前项目目录：{项目}/config/wxmp.json
• Skill 目录：skill 安装位置下的 config/wxmp.json

cp config/wxmp.example.json config/wxmp.json
# 然后填入真实的 AppID 和 Secret

获取方式：微信公众平台 → 我的业务与服务 → 公众号 → 开发密钥

配置文件包含敏感信息，已在 .gitignore 中排除。

用户说"帮我配置"或"配置助手"时，先检查 config/wxmp.json 中哪些已配置、哪些缺失，只引导用户配置缺失的部分。可选功能（Humanizer、StopSlop、Agnes AI、Reddit）逐个询问是否需要，用户说不要就跳过。