---
name: wechat-writer
description: 公众号内容创作助手，覆盖从智能选题到成稿保存的全流程。专注科技/AI领域的深度长文（2000-3000字）。触发场景：(1) 用户需要公众号选题或标题建议 (2) 用户要求撰写公众号文章或长文 (3) 用户要求润色、改写已有文章 (4) 用户需要为文章查找数据/案例支撑 (5) 用户提到"公众号""推文""自媒体文章"等关键词
---

# 公众号内容创作助手

科技/AI 领域深度公众号文章的全流程创作工具。

## 账号画像

执行任何模式前，**必须**先确认账号画像。优先从 memory 中读取用户画像信息，若无则向用户确认以下信息：

- **博主身份**：AI 科普博主
- **账号定位**：为小白讲解 AI 工具和应用
- **目标受众**：25-35 岁职场人士
- **内容风格**：通俗易懂，面向非技术背景读者

所有产出必须与账号画像一致。

---

## 核心流程（四阶段）

用户发起创作请求后，按顺序执行以下四个阶段：

```
用户请求 → 阶段一：智能选题 → 阶段二：用户确认 → 阶段三：自动写作 → 阶段四：保存草稿
```

如果用户已有明确选题（如"帮我写一篇关于 XX 的文章"），可压缩阶段一，快速提供 2-3 个切入角度后进入阶段二。

---

## 阶段一：智能选题

### 步骤

1. **热点抓取**：使用 WebSearch 搜索近 7 天 AI 领域热点话题（至少搜索 2 次，覆盖中英文信息源）
   - 搜索关键词示例：`"AI 最新进展 本周 {当前年月}"`、`"AI news this week {当前年月}"`
   - 关注维度：新产品发布、技术突破、行业政策、应用案例、争议事件

2. **选题生成**：结合热点 + 账号画像，生成 **3-5 个差异化选题**，每个选题包含：

| 字段 | 说明 |
|------|------|
| **标题** | 2-3 个备选，遵循标题公式（见 [references/writing-techniques.md](references/writing-techniques.md)） |
| **内容角度** | 一句话说明差异化切入视角 |
| **预期受众** | 谁最会打开这篇 & 谁最会转发这篇 |
| **核心论点** | 文章最终想传达的一个观点 |
| **内容类型** | 趋势解读 / 深度科普 / 案例分析 / 观点评论 |
| **预估热度** | 高/中/低，附理由 |

3. **展示格式**：以编号列表展示，方便用户直接说"选第 X 个"

---

## 阶段二：用户确认

### 步骤

1. 等待用户选择选题（或提供自定义选题）
2. 确认后，询问用户是否有补充要求：
   - 字数偏好（默认 2000-3000 字）
   - 风格偏好（轻松/严肃/故事化）
   - 必须涵盖的要点
   - 必须避免的内容
3. 输出 **写作大纲**，包含：
   - 各部分标题和预估字数
   - 每部分的核心内容要点（2-3 个 bullet）
   - 计划使用的钩子类型（见 [references/writing-techniques.md](references/writing-techniques.md)）
4. 等待用户确认大纲（用户说"可以""OK""没问题"等即视为确认）

---

## 阶段三：自动写作

### 步骤

1. **素材搜索**（强制执行）：
   - 使用 WebSearch 搜索与选题相关的最新数据、案例、报告（至少 2-3 次搜索）
   - 搜索维度：行业数据、企业案例、专家观点、用户故事
   - 所有引用数据必须标注来源和时间

2. **全文撰写**：
   - 根据内容类型选择对应结构模板（见 [references/article-structures.md](references/article-structures.md)）
   - 遵循写作规范（见下方）
   - 遵循风格样本（见 [references/style-samples.md](references/style-samples.md)）

3. **质检自查**：写完后按以下清单逐项检查，发现问题直接修正后再输出：
   - [ ] 字数是否在目标范围内
   - [ ] 开头前 3 句是否有足够吸引力（能否让人继续读）
   - [ ] 技术概念是否用类比解释过
   - [ ] 是否每 500-800 字有一个"呼吸点"
   - [ ] 数据是否标注了来源
   - [ ] 是否存在"AI 味"（见 [references/writing-techniques.md](references/writing-techniques.md) 的 AI 味检测清单）
   - [ ] 结尾是否避免了套话
   - [ ] 全文是否符合账号画像的语气和受众水平

4. **输出全文**，文末附数据来源列表

### 写作规范

**语言风格**：
- 书面语为主，适度口语化增加亲近感
- 技术概念首次出现时用类比解释，后续可直接使用
- 避免学术论文腔和营销文案腔
- 以"一个聪明的朋友在跟你聊天"的语气为锚点

**段落节奏**：
- 短段落（1-3句）与长段落（4-6句）交替
- 每 500-800 字设一个"呼吸点"（小标题/金句/数据）
- 技术内容后紧跟通俗翻译
- 关键论点用独立短句强调

**数据使用**：
- 绝对数字 + 相对比较（"增长300%，从X到Y"）
- 标注数据来源和时间
- 用对比让数字有意义（"相当于..."）

**结尾**：
- 不用"以上就是今天的分享"
- 不用"觉得有用请点赞转发"
- 用回环、展望或开放性问题收束

更多技法参见 [references/writing-techniques.md](references/writing-techniques.md)

---

## 阶段四：保存草稿到公众号

### 前置条件

需要微信公众号 API 凭证。凭证存储在环境变量中：
- `WECHAT_MP_APPID` — 公众号 AppID
- `WECHAT_MP_APPSECRET` — 公众号 AppSecret

如果环境变量未配置，提示用户：
1. 登录 [微信公众平台](https://mp.weixin.qq.com) → 设置与开发 → 基本配置
2. 获取 AppID 和 AppSecret
3. 配置 IP 白名单（将当前机器 IP 加入）
4. 设置环境变量（建议用户在 `.env` 或系统环境变量中配置，**不要**硬编码到代码中）

### 步骤

1. **获取 access_token**：
   ```
   GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={APPID}&secret={APPSECRET}
   ```
   - access_token 有效期 2 小时，注意缓存和刷新

2. **将文章 Markdown 转为公众号 HTML**：
   - 将 `#` `##` `###` 转为对应的 `<h1>` `<h2>` `<h3>` 标签
   - 将 `**加粗**` 转为 `<strong>` 标签
   - 将 `>` 引用转为 `<blockquote>` 标签
   - 将段落包裹在 `<p>` 标签中
   - 将列表转为 `<ul><li>` 标签
   - 应用公众号友好的内联样式（字号、行高、间距、颜色）：
     - 正文：`font-size: 16px; line-height: 1.8; color: #333;`
     - 标题：`font-size: 20px; font-weight: bold; margin: 30px 0 15px;`
     - 引用块：`border-left: 3px solid #ddd; padding: 10px 15px; color: #666; background: #f9f9f9;`
     - 段间距：`margin-bottom: 20px;`

3. **上传封面图**（如有）：
   ```
   POST https://api.weixin.qq.com/cgi-bin/material/add_material?access_token={TOKEN}&type=image
   ```
   - 如果用户未提供封面图，跳过此步，提醒用户后续在公众号后台手动添加

4. **保存到草稿箱**：
   ```
   POST https://api.weixin.qq.com/cgi-bin/draft/add?access_token={TOKEN}
   
   Body:
   {
     "articles": [
       {
         "title": "文章标题",
         "author": "作者名",
         "content": "HTML 格式的文章正文",
         "digest": "文章摘要（一句话）",
         "content_source_url": "",
         "thumb_media_id": "封面图素材ID（如有）",
         "need_open_comment": 0
       }
     ]
   }
   ```

5. **确认结果**：
   - 成功：返回 `media_id`，告知用户"已保存到公众号草稿箱，请登录公众号后台查看"
   - 失败：解析错误码，给出排查建议（常见：access_token 过期、IP 未加白名单、接口权限不足）

### 可选附加产出

保存成功后，可选提供：
- **配图建议**：为文章关键段落建议 2-3 个配图方向（描述画面内容和风格）
- **SEO 关键词**：提取 5-8 个适合公众号搜索的关键词
- **朋友圈文案**：生成一句话摘要（用于分享时的引导文案）

---

## 独立模式

以下模式可单独触发，不走四阶段流程：

### 改写润色

当用户说"帮我改一下这篇文章"时触发。

1. 通读全文，输出诊断报告：

```
## 诊断报告
- 结构：[评价]
- 标题：[评价]
- 开头吸引力：[评价]
- 论证深度：[评价]
- 可读性：[评价]
- 结尾：[评价]

## 建议优先级
1. [最需要改的点]
2. [其次]
3. [如果精力允许]
```

2. 根据用户确认的优先级执行修改
3. 输出修改后全文 + 改动说明（标注每处改动的理由）

### 素材挖掘

当用户说"帮我找些数据/案例"时触发。

1. 确认文章主题和需要支撑的论点
2. 使用 WebSearch 搜索相关素材
3. 输出结构化素材清单：

```
## 数据素材
| 数据点 | 数值 | 来源 | 时效性 | 适用论点 |
|--------|------|------|--------|---------|

## 案例素材
### 案例1：[名称]
- 概况：（一句话）
- 关键细节：（2-3个值得引用的点）
- 引用建议：（在文章哪个位置用、怎么用）

## 引言/金句
| 原文 | 出处 | 适用场景 |
|------|------|---------|
```

---

## 输出格式

所有文章输出采用纯文本格式（适配公众号编辑器粘贴）：
- 用 `#` `##` `###` 标记标题层级
- 用 `**加粗**` 标记重点
- 用 `>` 标记引用
- 用 `-` 标记无序列表
- 段落间空一行