# Wechat Super Power

> 内容全流程助手：topic → 相关文章列表 → 知识库 → 爆点分析 → 框架 → 写作 → 配图/图文。 适用于围绕公众号/微信文章场景，从选题出发完成资料抓取、知识沉淀、观点提炼、 框架组织、写作推进与图文成稿。 触发关键词：公众号、微信文章、推文、选题、知识库、爆点分析、文章框架、写作、配图、图文、首图、封面图。 不应被纯 blog、邮件、PPT、短视频脚本等泛内容任务触发，除非用户明确要走本文档定义的内容工作流。

- Skill: `jacoobwang/wechat-super-power` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add jacoobwang/wechat-super-power`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jacoobwang/wechat-super-power/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jacoobwang (https://skillmd.com/u/jacoobwang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jacoobwang/wechat-super-power

---


# Wechat Super Power

## 行为声明

**角色**：用户的内容研究与写作流程 Agent。

**默认模式**：
- 默认按 6 步主流程推进，不把任务拆成零散回答。
- 当用户要求“图文”“配图”“首图”“封面图”或“能直接发”的成稿时，扩展执行 Step 7。
- 能用脚本完成的步骤直接执行，不停在“建议”层。
- 不能用脚本完成的步骤，由 agent 基于已有知识库内容继续分析与产出。

**范围边界**：
- 当前仓库已经实现的“可执行能力”主要覆盖 Step 1-3。
- Step 4-7 主要依赖 prompt、知识库内容、agent 推理和 Codex 可用的图像生成能力，不依赖额外脚本。

**降级原则**：
- 搜索失败：明确报错，不伪造文章列表。
- 单篇抓取失败：保留失败原因，继续处理其他文章。
- 爆点分析阶段如果知识库内容不足：明确指出证据不足，再给出保守分析。
- 框架、写作与配图阶段如果上游素材质量不足：先说明不足，再基于已有内容继续推进。
- 配图阶段如果当前 Codex 环境没有可用图像生成工具：输出可直接复制使用的配图方案与图像提示词，不伪装已经生成图片。

**完成协议**：
- `DONE`：已经完成当前请求要求的步骤，且输出可直接进入下一步。
- `DONE_WITH_CONCERNS`：已完成，但存在资料不足、抓取失败、反爬限制等问题。
- `BLOCKED`：关键输入缺失或知识库为空，无法继续。

**路径约定**：
- `{skill_dir}` 指当前 SKILL.md 所在目录。
- topic 对应的知识库目录默认位于 `./knowledge-base/<topic-slug>/`。

---

## 主管道（Step 1-7）

### Step 1: 用户输入 topic

目标：
- 明确本轮内容生产围绕什么主题展开。

执行原则：
- 如果用户已经提供 topic，直接进入 Step 2。
- 如果用户没有提供 topic，但语义中存在明确主题，就把该主题作为 topic。
- 如果完全没有 topic，先向用户确认 topic，再继续。

输出：
- 一个明确的 `topic`

---

### Step 2: 抓取相关文章列表

执行方式：

```bash
node scripts/skill-entry.js search "<topic>" --limit <数量>
```

默认数量：
- 未指定时默认取 3 条

这一阶段应做什么：
- 围绕 topic 搜索相关文章列表
- 返回候选文章的标题、摘要、来源、发布时间、链接
- 为 Step 3 做输入准备

失败处理：
- 若搜索失败，直接说明失败原因，不伪造候选列表

输出：
- 结构化文章候选列表

---

### Step 3: 知识库沉淀

执行方式：

```bash
node scripts/skill-entry.js build-kb "<topic>" --limit <数量> --delay 3000 --output-dir <目录>
```

这一阶段应做什么：
- 把候选文章抓取为 Markdown
- 将成功文章写入 topic 对应知识库目录
- 保留成功/失败结果

这一阶段完成后，agent 应知道：
- 知识库目录位置
- 哪些文章抓取成功
- 哪些文章失败以及原因

输出：
- 知识库目录
- 成功保存的文章列表
- 失败文章列表

---

### Step 4: 爆点分析

这一阶段**不调用脚本**。

执行方式：
- 读取 topic 对应知识库目录下的 Markdown 文章
- 使用 [hotspot-analysis-prompt.md](references/hotspot-analysis-prompt.md) 作为分析提示词
- 基于知识库内容提炼：
  - 选题价值
  - 冲突点
  - 传播点
  - 可写角度
  - 证据来源

执行要求：
- 不要复述文章
- 结论优先
- 每个判断尽量回到具体文章内容或案例
- 如果知识库只有少量文章，要明确说明结论的置信度有限

输出结构建议：
- `选题价值`
- `冲突点`
- `传播点`
- `可写角度`
- `证据来源`

---

### Step 5: 输出文章框架

这一阶段**不调用业务脚本**，由 agent 基于 Step 4 的分析结果继续推进。

执行方式：
- 读取 [frameworks.md](references/frameworks.md)
- 根据 topic、爆点分析结果、目标读者判断最合适的框架
- 输出一套明确可写的文章结构

框架输出至少应包含：
- 开头策略
- 文章主线
- 段落安排
- 每段要写什么
- 哪些证据应放在哪一段

默认要求：
- 不只给框架类型名，要给可执行的大纲
- 如有必要，可给 2-3 套候选框架供用户选择

输出：
- 一套或多套文章框架

---

### Step 6: 写作

这一阶段由 agent 基于 Step 4 和 Step 5 继续完成。

执行方式：
- 读取 [writing-guide.md](references/writing-guide.md)
- 使用 topic、知识库内容、爆点分析结论、文章框架
- 直接输出文章初稿或按用户要求输出局部内容

写作要求：
- 优先遵守 [writing-guide.md](references/writing-guide.md) 中的写作规范
- 不要脱离知识库证据胡乱发挥
- 保留内容策划阶段确定的冲突点和传播点
- 文章应能自然承接前面框架，而不是重新起炉灶

输出：
- 文章初稿 / 局部段落 / 标题方案 / 开头方案

---

### Step 7: 配图与图文成稿

这一阶段由 agent 基于 Step 4-6 继续完成。用户明确要求“配图”“图文”“首图”“封面图”“能直接发”时必须执行；完整流程默认不强制生成图片，除非用户要求图文交付。

执行方式：
- 读取 [image-guide.md](references/image-guide.md)
- 基于 topic、爆点分析、文章框架和最终文稿，设计图片清单
- 优先生成：
  - `首图/封面图`：1 张，承担点击与主题表达
  - `文内配图`：2-4 张，分别服务于关键段落、冲突点、数据/案例或情绪转折
  - `社交分享图`：可选，适合朋友圈/社群转发

Codex 内直接使用要求：
- 如果当前 Codex 会话可用 `imagegen` skill 或图像生成工具，agent 应直接调用它生成图片，而不是只给提示词。
- 生成图片前先把文稿拆成可视化场景，不要把整篇文章塞进一个提示词。
- 每张图都应有明确用途、放置位置和图像提示词。
- 如果需要真实人物、品牌、产品、地标或新闻现场图，优先使用用户提供素材或可核验的真实图片；不要编造“真实截图”。
- 默认生成 bitmap 图片，不用 SVG 当公众号配图。

图片风格原则：
- 公众号商业/知识类文章：克制、清晰、有叙事焦点，避免廉价海报感。
- 观点/评论类文章：用隐喻场景、人物关系、空间张力表达冲突，不要把标题文字硬贴满画面。
- 教程/方法类文章：优先信息图、流程图、操作场景图，图像服务理解。
- 情绪/故事类文章：优先电影感场景、细节特写、人物状态，图像服务共情。

输出结构：
- `图文成稿`：正文中用 `[配图：图片名]` 标记插入位置
- `图片清单`：文件名 / 用途 / 放置位置 / 画面说明 / prompt
- `生成结果`：如已调用图像工具，展示或列出生成图片路径；如未能调用，说明原因并保留 prompt

完成标准：
- 图片与正文观点一致，不喧宾夺主
- 每张图都能解释为什么出现在对应段落
- 封面图独立看也能表达选题张力
- 文内图片不重复同一种构图或同一种情绪

---

## 辅助能力

### 单篇抓取

当用户已经给出具体文章链接，而不是让你先搜再沉淀时，运行：

```bash
node scripts/skill-entry.js fetch "<文章链接>"
```

适用场景：
- 用户给出 `mp.weixin.qq.com/...`
- 用户给出具体网页文章链接并要求提取正文

### 直接批量入库

当用户已经有一批文章链接，希望直接写入知识库时，运行：

```bash
node scripts/skill-entry.js save-articles "<topic>" "<链接1>" "<链接2>" --output-dir <目录>
```

---

## Agent 执行规范

1. 如果用户请求是完整内容流程，优先按 Step 1-6 顺序推进，而不是只执行局部步骤。
2. 如果用户只请求其中一步，就只执行那一步以及必要前置步骤。
3. Step 1-3 用脚本，Step 4-7 用 prompt、agent 推理和 Codex 可用的图像生成能力。
4. 做 Step 4 时，必须优先读取知识库内容，不要脱离资料直接分析。
5. 做 Step 5、Step 6 和 Step 7 时，必须继承 Step 4 的结论，不要与上一步脱节。
6. 做 Step 6 时，必须先读取 [writing-guide.md](references/writing-guide.md)，再开始写作。
7. 做 Step 7 时，必须先读取 [image-guide.md](references/image-guide.md)，再设计或生成图片。
8. 如果知识库为空或文章过少，应明确说明，不要假装分析充分。
9. 如果用户只要“配图”或“图文”，先确认是否已有正文；有正文则直接进入 Step 7，没有正文则先完成必要的 Step 4-6。

---

## 文件地图

- `scripts/skill-entry.js`：统一 CLI 入口
- `scripts/search_wechat.js`：相关文章搜索
- `scripts/fetch_wechat_article.js`：文章抓取与 Markdown 转换
- `scripts/build_knowledge_base.js`：围绕 topic 搜索并沉淀知识库
- `scripts/save_web_articles.js`：将文章链接直接写入知识库
- `references/hotspot-analysis-prompt.md`：Step 4 爆点分析 prompt
- `references/frameworks.md`：Step 5 框架生成参考
- `references/writing-guide.md`：Step 6 写作规范与 prompt
- `references/image-guide.md`：Step 7 配图策略与图像 prompt 规范

---

## 快速响应模式

### 用户要“做完整流程”

按顺序推进：
1. 明确 topic
2. 搜索文章列表
3. 搭建知识库
4. 做爆点分析
5. 输出框架
6. 写作

如果用户同时说“图文”“配图”“能直接发”，继续：
7. 设计图片清单并在 Codex 中直接生成图片

### 用户只要“爆点分析”

不要调用新脚本，直接：
1. 找到知识库目录
2. 读取 Markdown 文章
3. 使用 [hotspot-analysis-prompt.md](references/hotspot-analysis-prompt.md)
4. 输出 `选题价值 / 冲突点 / 传播点 / 可写角度 / 证据来源`

### 用户只要“框架”

先确认是否已有 Step 4 的分析结果：
- 有：直接基于分析结果输出框架
- 没有：先做 Step 4，再给框架

### 用户只要“配图 / 图文”

先确认是否已有正文：
- 有正文：直接读取 [image-guide.md](references/image-guide.md)，进入 Step 7。
- 没有正文但已有框架/分析：先写出必要正文或段落，再进入 Step 7。
- 没有任何上游素材：先从 Step 1 开始走必要流程。

输出时优先给用户可直接使用的图文结果：
- 正文插图位置
- 图片文件或图片路径
- 图片说明
- 备用 prompt