Berkshire Wechat Article

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

Codex adapter note

This skill is generated from berkshire-wechat-article 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 .claude/skills/berkshire-shared/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协作的本质是强制引入外部视角。

阶段一：研究与素材收集

第一步：明确文章定位

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

第二步：深度研究

使用 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的反馈

重点关注以下高频问题：

第二步：执行修改

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

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: {链接}

文件命名与存储

写作红线

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