wechat-article

name	wechat-article
description	AI Berkshire skill: 微信公众号文章：作者-编辑-读者三Agent协作. Source: skills/wechat-article.md.

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 文件，文件末尾附上论文/资料原文链接：

**论文原文：**
- 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. 结尾必须有传播力。最后一句话要值得被单独截图转发