---
name: xbtlin/wechat-article
source: https://app.decimal.ai/s/xbtlin-wechat-article@1/SKILL.md
source_sha256: 10ba673d76d1
---

## Codex adapter note

This skill is generated from `skills/wechat-article.md` so Claude Code and Codex users share one canonical workflow.

- Treat `$ARGUMENTS` as the user's request in the current Codex thread.
- When the source mentions Claude-only surfaces such as Task, Agent, WebSearch, Bash, Read, or Write, use the closest Codex capability available in this session: subagents when available, web search when needed, shell commands for local tools, and normal file edits for workspace files.
- Use shared project tools from `tools/` in this repository. Prefer running commands from the repository root with paths like `python3 tools/financial_rigor.py ...`; if the current thread starts outside the repo, locate the actual checkout path first instead of assuming a fixed home-directory path.
- Before starting research, run the `date` command to confirm today's date; treat it as the baseline for "latest" data and state the data cutoff date in the report header. Never assume the current date from training data.
- Preserve the research quality rules from `AGENTS.md`: cross-check financial data, use exact arithmetic tools for valuation/math, and clearly label uncertainty and source gaps.

# 微信公众号文章：作者-编辑-读者三Agent协作

对 $ARGUMENTS 进行深度研究，产出一篇可直接发布的微信公众号文章。三个Agent各司其职：作者写深度初稿，编辑精修结构和表达，读者从目标受众视角审读。

**支持输入格式**：主题描述，例如：`大模型OPD技术解读`、`Qwen3技术报告解读`、`为什么巴菲特不买科技股`

---

## 设计理念

一篇好的公众号文章需要同时满足三个维度：
1. **深度**——对得起花时间读完的人（作者负责）
2. **可读性**——结构清晰、节奏好、不劝退（编辑负责）
3. **真的能看懂**——目标读者不会在中途放弃（读者负责）

单人写作容易"自嗨"——写的人觉得清楚，读的人看不懂。三Agent协作的本质是**强制引入外部视角**。

---

## 阶段一：研究与素材收集

### 第一步：明确文章定位

在开始写作之前，先确认以下信息（如用户未指定则主动询问）：

| 维度 | 需要确认 | 默认值 |
|------|---------|--------|
| **目标读者** | 技术背景程度 | 有点技术背景但非该领域专家 |
| **文章深度** | 科普/中深度/硬核 | 中深度（有公式但要解释清楚） |
| **文章长度** | 字数范围 | 3000-4000字 |
| **是否需要下载原始论文/资料** | 需要PDF/配图 | 是 |
| **写作风格** | 正式/对话式/犀利 | 对话式（像写给聪明的朋友） |

### 第二步：深度研究

使用 Agent 工具**并行**启动2-3个研究Agent，收集足够的素材：

**研究Agent A：核心内容研究**
- 如果是论文解读：下载论文PDF、提取核心贡献、关键图表、实验结果
- 如果是技术主题：搜索最新进展、关键论文、技术细节
- 如果是商业/投资主题：搜索最新数据、行业报告、竞争格局

**研究Agent B：行业背景与应用**
- 搜索该技术/主题的行业落地情况
- 哪些公司在用？效果如何？
- 最新的发展趋势和里程碑事件

**研究Agent C（可选）：竞品/对比研究**
- 同类方法/产品的对比
- 历史发展脉络
- 未来演进方向

### 第三步：整理素材框架

研究Agent全部完成后，整理出：
1. **核心论点**（一句话概括文章要传达的核心信息）
2. **关键数据**（3-5个最有冲击力的数据点）
3. **配图清单**（需要哪些图，来源是什么）
4. **文章大纲**（6-8个章节的标题和核心内容）

---

## 阶段二：作者Agent写初稿

使用 Agent 工具启动**作者Agent**，给出详细的写作指令。

### 作者Agent的Prompt模板

```
你是一位深度技术写作者（Author Agent），需要写一篇微信公众号文章。

## 目标读者
{根据第一步确认的读者画像}

## 写作风格要求
- 纯中文表达，避免中英文夹杂（技术术语首次出现时给英文，后续用中文）
- 像写给聪明的朋友看的技术科普，不是学术论文翻译
- 用类比帮助理解，但类比要贴切、不俗套
- 关键公式/数据要有，但每个都要用大白话解释
- 不用emoji
- 段落不超过4行（公众号阅读环境）

## 核心内容
{整理好的素材、数据、论点}

## 文章结构要求
1. **开头（前3段）**：必须有强钩子——用数据冲击力或反直觉的结论开场，不要用温和的类比开场
2. **背景**：为什么这件事重要？解决什么问题？
3. **核心内容（2-3节）**：技术深度在这里体现，但每个技术点都要有"大白话翻译"
4. **实证/案例**：用数据和案例说话，不要空谈
5. **行业影响/展望**：这件事对行业意味着什么
6. **结尾**：一句有传播力的判断收束，适合被截图转发

## 配图要求
- 论文解读类文章：必须从论文PDF中提取原图，直接用 `![描述](相对路径)` 插入文章，不要用 [图X：描述] 占位符
- 提取方法：用 pdftoppm 将PDF页面渲染为高分辨率PNG（至少900 DPI），再用 PIL 裁切目标图表区域
- 每张图不小于500KB，确保高清
- 图片统一存放在 `assets/{主题简称}/` 目录下
- 非论文类文章：如需配图，搜索并下载合适的图片，同样直接插入

## 公式要求
- 所有数学公式使用 LaTeX 格式：行内用 `$...$`，独立公式用 `$$...$$`
- 禁止用纯文本写公式（如 `> D_KL(P || Q) = ...`），必须用 LaTeX 渲染格式
- 每个公式后面仍然要配"大白话翻译"

请写出完整的文章初稿，约{目标字数}字。
```

### 作者Agent完成后

检查初稿文件是否生成，阅读全文确认内容完整性。

---

## 阶段三：编辑Agent + 读者Agent并行审阅

初稿完成后，使用 Agent 工具在**同一条消息**中启动编辑Agent和读者Agent。

### 编辑Agent的Prompt模板

```
你是一位资深公众号编辑（Editor Agent）。请对以下文章进行精修审阅。

## 审阅标准
1. **标题**：是否在朋友圈能吸引点击？是否会被截断（超过30字）？
2. **开头**：前3段能否留住读者？钩子是否足够强？
3. **结构**：逻辑链是否流畅？有无跳跃或断层？
4. **深度与可读性平衡**：公式/技术部分是否真的通俗？有无"假装通俗但没解释清楚"的地方？
5. **节奏**：有无太长的段落？每节长度是否合适？
6. **配图**：图片是否已实际插入（非占位符）？位置是否在读者最需要视觉辅助时出现？
7. **结尾**：有无传播力？读者看完会想转发吗？

## 文章全文
{完整初稿}

## 输出格式
1. 总体评价（3-5句话）
2. 标题修改建议（给2-3个备选）
3. 逐节修改建议（给出"原文→建议修改为"的具体对照）
4. 最关键的3个改进点
```

### 读者Agent的Prompt模板

```
你是一位{目标读者画像}（Reader Agent）。请从读者视角审读以下文章。

## 你的背景
{具体描述目标读者的知识水平和阅读习惯}

## 文章全文
{完整初稿}

## 请回答以下问题
1. 读完前3段，你会继续读下去吗？为什么？
2. 哪些地方"看不懂"或"需要重读才能理解"？具体是哪句话？
3. 技术/公式部分你看懂了吗？"大白话翻译"是否帮到你了？
4. 文章的核心类比贴切吗？有更好的类比吗？
5. 太长还是太短？会在哪里失去耐心？
6. 读完后你能用一句话概括文章核心观点吗？
7. 你会转发这篇文章吗？转发时你会说什么？
8. 有没有你想了解但文章没覆盖的问题？
```

---

## 阶段四：定稿

### 第一步：综合两个Agent的反馈

重点关注以下高频问题：

| 问题类型 | 编辑常见反馈 | 读者常见反馈 | 处理方式 |
|---------|------------|------------|---------|
| 开头太弱 | 钩子不够强 | 前3段没动力继续 | 用数据/反直觉结论重写开头 |
| 技术段劝退 | 公式太密集 | 某段需要重读3遍 | 删公式或图片化，加更直觉的类比 |
| 节奏拖沓 | 某节太长 | 某处失去耐心 | 合并或删减（尤其是后半段重复的技术解释） |
| 结尾无力 | 缺传播力 | 不会转发 | 重写为一句可截图传播的判断 |
| 概念跳跃 | 逻辑有断层 | 某处"突然看不懂了" | 补过渡句或背景解释 |

### 第二步：执行修改

根据反馈重写文章。核心修改原则：

1. **编辑和读者都指出的问题，必须改**
2. **只有编辑指出的问题，大概率要改**（编辑的专业判断通常准确）
3. **只有读者指出的问题，视情况改**（读者反馈代表真实体验，但不一定每条都需要响应）
4. **两者矛盾时，偏向读者**（编辑追求完美，但读者体验是最终标准）

### 第三步：提取配图

论文解读类文章必须在定稿前完成配图提取：

1. **渲染**：`pdftoppm -png -r 900 -f {页码} -l {页码} 论文.pdf /tmp/page`（900 DPI起步，如果图片不到500KB则升到1200或1500 DPI）
2. **定位**：先用150 DPI渲染全页，目视确认各图表的像素坐标
3. **裁切**：用 PIL 按坐标裁切，`compress_level=1` 保存，确保每张 ≥ 500KB
4. **存储**：保存到 `assets/{主题简称}/` 目录，命名为 `fig{序号}-{描述}.png`
5. **插入**：文章中用 `![描述](../../assets/{主题简称}/fig{序号}-{描述}.png)` 引用

### 第四步：产出最终文件

将定稿保存为 md 文件，文件末尾附上论文/资料原文链接：

```markdown
**论文原文：**
- arXiv: {链接}
```

---

## 文件命名与存储

| 类型 | 路径 | 命名格式 |
|------|------|---------|
| 技术主题 | `reports/AI产业研究/` | `公众号-{主题关键词}-{YYYYMMDD}.md` |
| 投资主题 | `reports/{公司名}/` | `{公司名}-公众号-{YYYYMMDD}.md` |
| 通用主题 | `reports/` | `公众号-{主题关键词}-{YYYYMMDD}.md` |

---

## 写作红线

1. **不虚构数据**。引用的数据必须有来源，搜不到就标注"估计"
2. **不用AI腔调**。禁止"让我们一起来看看"、"值得关注的是"、"不得不说"等套话
3. **不过度承诺**。技术文章不说"颠覆性的"、"革命性的"，用数据说话
4. **公式必须配大白话**。每个公式后面都要有一段"翻译成人话就是……"
5. **公式必须用LaTeX**。`$$...$$` 格式，禁止纯文本公式
6. **配图必须实际插入**。论文解读类从PDF提取高清原图（≥500KB），禁止用 `[图X]` 占位符
7. **表格括号注释要精确**。描述概念时用准确的定义，不用模糊的动宾短语（如"文本来自教师"而非"学教师的文本"）
8. **类比要一以贯之**。全文用一个主线类比，不要每节换一个新类比
9. **结尾必须有传播力**。最后一句话要值得被单独截图转发