paper-analyzer
将学术论文转化为深度HTML长文。6轮强制工作流、代码仓库搜索、公式渲染、Mermaid图表。 3种写作风格，输出可直接分享的精美HTML页面。
By zsyggg · 1,013 installs
npx skills add zsyggg/paper-craft-skills --skill paper-analyzer
Source repository · Upstream listing
Paper Analyzer — 学术论文深度解析
⚠️ 这是生产级指令。你的唯一任务：产出一篇让读者觉得"比我读论文还清楚"的深度HTML长文。
快速使用
强制工作流（每一步必须执行，不可跳过）
Round 1：获取论文全文 ⛔
输入 执行
arxiv URL 同时读 arxiv.org/abs/（摘要）和 arxiv.org/html/（全文HTML）
PDF路径 用PDF读取工具读全文。分多次直到全部获取
文本 全部使用
自检 ：有没有完整内容？没有 → 换方式继续。
Round 2：搜索开源代码 ⛔
1. 从论文中提取代码仓库链接（通常在页脚或 Introduction 末）
2. 没有则用论文标题+作者名搜索 GitHub
3. 克隆： git clone depth 1 <url /tmp/paper code
4. 阅读 README → 核心源码文件 → 配置文件
根据代码状态分支处理 ：
状态 处理 文章体现
✅ 已发布 读核心文件，找 ≥2 处论文方法↔源码对应 贴代码段（≤30行），标注 文件路径:行号
⏳ 待发布 检查 README/Release 标记 标注状态+仓库链接
❌ 无代码 搜索替代实现/相关项目 注明"本文未提供公开代码"
Round 3：深度分析 ⛔ 内部完成，不展示过程
1. 核心创新：论文做了什么别人没做的？（1 3个，每个一句话提炼）
2. 方法细节：输入→处理→输出→为什么更好（每个创新画清楚这条线）
3. 关键实验：哪个结果最有说服力？为什么？
4. 论文弱点：作者自述 + 你的判断
5. 代码对应：每个 component 对应哪个文件/函数
Round 4：询问用户 ⛔
必须问风格选择，用户未回则默认 academic。
Round 5：写作输出HTML ⛔
按选定风格的要求写，输出完整HTML。模板见下文。
Round 6：自我审查 ⛔
逐项检查，不通过则修改直到通过。
三风格详细要求
storytelling（故事型）— 像一篇公众号爆文
硬标准 ：
字数 ≥ 3000
段落 ≥ 15
引用论文原文 ≥ 3 处
生动类比/比喻 ≥ 2 个
结尾金句 1 句
结构要求（按顺序，缺一不可） ：
写法要求 ：
多用"你"和读者对话（"你有没有想过""你猜怎么着"）
段落短，一段不超过 4 句话
技术词出现时要立刻给"人话解释"
数据要翻译成可感知的东西（"15 斤荔枝"而不只是"15 斤"）
academic（学术型）— 比论文更清晰的深度解析
硬标准 ：
字数 ≥ 4000（⚠️ 学术型必须长于故事型）
段落 ≥ 20
论文公式引用 ≥ 5 处（用 KaTeX 渲染）
论文图片/图表引用 ≥ 3 处（标注 Figure number）
实验数据表格 ≥ 2 张
代码段 ≥ 2 段（如有代码）
指出局限 ≥ 2 处
结构要求 ：
写法要求 ：
保持学术严谨但不死板——比论文好读
每个公式后要跟一句"人话"解释：这个公式在说什么
引用论文的 Fig/Table/Section 编号
表格数据要有解读，不只贴数据
数学符号首次出现要解释含义
concise（精炼型）— 最快掌握核心
⚠️ 精炼 ≠ 敷衍。精炼是信息密度极高、但该有的全有。
硬标准 ：
字数 ≥ 1200（不能低于这个数）
必须有：核心摘要盒 + 表格 + 可视化图表 + 金句
⚠️ 必须包含至少 1 个 Mermaid 图表 （架构图或对比图）
结构要求 ：
Mermaid 图表示例 （⚠️ 节点文本避免中文特殊字符，用英文或简单ASCII。用 <br/ 换行）：
HTML 输出模板
生成HTML时使用此模板，确保含 KaTeX 公式渲染 + Mermaid 图表支持：
公式用 $$...$$ 或 $...$ ，KaTeX 自动渲染。
✅ 正确： $H^I$ 、 $H^{I}$ 、 $\mathbf{q} {t,j}^I$
❌ 错误： $H^\I$ （ \I 未定义）、 $H^I$ 写在 <pre 标签内
Mermaid 图用 <pre class="mermaid" ...</pre 包裹。节点文本避免中文标点和特殊字符。
自我审查清单（Round 6）
生成后逐条检查，不通过则修改：
通用
[ ] 字数达标？（story≥3000 / academic≥4000 / concise≥1200）
[ ] 引用论文原文 ≥ 3 处？
[ ] 每个核心创新独立深度展开？
[ ] 至少 1 个实验结果做深入解读？
[ ] 代码状态已提及？
[ ] 有代码则源码 ≥ 2 段 + 文件路径？
[ ] 指出局限 ≥ 2 处（至少 1 处是作者自述的）？
[ ] HTML 格式完整，可在浏览器打开？
[ ] 无 AI 套话（"深入探讨""至关重要""值得注意的是"）？
storytelling 专属
[ ] 有钩子开头？
[ ] 有 ≥ 2 个类比/比喻？
[ ] 用"你"和读者对话？
[ ] 有收束段落形成闭环？
[ ] 有金句？
academic 专属
[ ] 字数 ≥ storytelling？
[ ] 公式 ≥ 5 处（KaTeX 渲染）？
[ ] 论文图/表引用 ≥ 3 处（Fig/Table 编号）？
[ ] 实验数据表 ≥ 2 张？
[ ] 方法部分 ≥ 8 段？
concise 专属
[ ] 有 Mermaid 图表？
[ ] 有核心摘要盒？
[ ] 有对比数据表？
[ ] 有金句？
[ ] 字数 ≥ 1200？
参考文件
styles/storytelling.md — 故事型补充规范
styles/academic.md — 学术型补充规范
styles/concise.md — 精炼型补充规范
styles/with formulas.md — 公式详解
styles/with code.md — 代码分析规范
scripts/generate html.py — HTML生成辅助脚本