Paper Explainer

Paper Explainer Skill

这是一个专门用于解读 AI/CS 领域技术论文的技能。

目标读者：产品经理、运营、业务负责人——对 AI 感兴趣，但没有算法/工程背景。 核心目标：去掉学术腔和工程术语，用”讲故事”的方式说清楚三件事：

1. 这个技术在解决什么痛点？
2. 它怎么做到的？（用类比，不用公式）
3. 对我们的产品/业务意味着什么机会？

核心能力

1. 故事化叙事：不复述摘要，而是从”旧方案有什么死穴”开始讲，讲到”新突破怎么绕过去的”。
2. 视觉化解构：对最难懂的概念画”极简对比图”或”流程演进图”，让不懂技术的人看一眼就明白。
3. 沉浸式研报：生成莫兰迪配色的 HTML 单文件，带关键数字卡片、结论高亮块，提供优质的阅读体验。

依赖说明

• 图像生成：本技能将直接生成 SVG 矢量图代码，无需外部 API 调用。这能确保生成的图表精准、清晰且风格统一。
• 联网搜索：需要调用 WebSearch 或 WebFetch 工具来处理 URL 输入。

工作流程 (Workflow)

当用户提供一篇论文（PDF、文本或 URL链接）并要求解读时，在开始之前先读取 prompts/narrative.md 和 prompts/visual.md，然后按以下步骤执行：

Step 0: 内容获取

• 本地文件：直接读取。
• URL：用 WebFetch 抓取；内容截断时用 WebSearch 找 arXiv 纯文本页重新抓取；过滤导航/广告，只保留正文。

Step 1: 理解论文，构建叙事脉络

读完全文后，在内存中整理三个问题的答案：

1. 旧方案的死穴是什么？（对应 Phase 1）
2. 新方案的核心思路是什么？最适合用什么类比解释？（对应 Phase 2）
3. 对 PM 而言最重要的结论和机会点是什么？（对应 Phase 4）

同时标记 2-3 个”视觉锚点”：最抽象、用文字说不清楚、但画一张图就能秒懂的概念。优先考虑 Before/After 对比图。

Step 2: 按叙事框架撰写正文

严格按照 prompts/narrative.md 的五个 Phase 撰写，写到视觉锚点时直接内联生成 SVG（参考 prompts/visual.md 的规范）。

SVG 生成要点：

• 先选图表类型（对比图/流程图/模块图），再动笔
• SVG 直接嵌入文档，不保存为外部文件
• 每张图只讲一个概念，不超过 5 个元素

Step 3: 生成 HTML 研报

按照 prompts/html_style.md 的规范将正文转为完整 HTML：

1. Phase 0 之后必须插入 stat-cards，展示 1-3 个最重要的对比数字
2. Phase 4 的”选型建议”必须用 insight-box 呈现
3. 代价/风险用 warning-box 标出
4. SVG 直接内联到 HTML 中，不使用 `` 外链
5. 保存为 ./output/{paper_keyword}_report.html

文件管理规范 (File Management)

• 输出根目录：./output/ (相对于当前项目工作目录)
• 图片存储路径：./output/assets/images/ (自动创建)
• 图片命名格式：{paper_keyword}_{concept}.svg
• 例如：deepseek_r1_grpo.svg
• HTML 报告路径：./output/reports/ (建议新建此目录)
• 提示词记录：(可选) 将生成的 prompt 保存到 ./output/assets/prompts/ 以便复用。

资源索引 (相对于本技能文件夹)

• 叙事框架：prompts/narrative.md
• 绘图规范：prompts/visual.md
• HTML 样式：prompts/html_style.md

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: PompeiiChan
• Source: PompeiiChan/skills-ExplainPaper
• License: MIT

Install and usage instructions live in the source repository linked above.