mcpField
P
paper-to-intuition

paper-to-intuition

github.com/ghostscientist生产力587 次安装8 周前更新
代码仓库

关于 paper-to-intuition

将学术论文转化为分层讲解和可视化直觉的技能，适合希望从入门到研究者层面理解论文的读者。它结合关键公式解析、交互式图示和组件失效分析。

主要功能

  1. 01生成四个层次的论文讲解
  2. 02提炼论文的核心见解
  3. 03逐项解释关键公式
  4. 04生成交互式 HTML 图示
  5. 05分析组件移除后的失效情况

适用场景

  1. 01快速理解一篇新论文的核心思路
  2. 02为不同背景的读者准备解释
  3. 03梳理论文方法的公式与取舍
  4. 04通过可视化检查方法的失效场景

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ghostscientist/skills --skill paper-to-intuition

安装后在 Claude Code 中输入/paper-to-intuition确认已加载。

详细介绍

从论文到直觉

通过层层深入的讲解和直观的可视化，将晦涩的学术论文转化为真正的理解。

流程

  1. 获取论文 - 请求 arXiv 链接、PDF 或论文标题
  2. 提炼核心 - 用一句话概括唯一的关键洞见
  3. 搭建阶梯 - 创建 4 个层次的讲解
  4. 可视化直觉 - 生成交互式图表
  5. 压力测试理解 - “如果移除 X，会出什么问题？”

讲解阶梯

在每个层次生成讲解，每个层次都建立在前一层的基础上：

第 1 层：小学生也能懂（1 段）
  • 不用术语，不写方程
  • 使用日常生活中熟悉的类比
  • 一个好奇的 10 岁孩子应该能大致理解
第 2 层：本科生（2-3 段）
  • 假设读者掌握微积分、基础线性代数和机器学习入门知识
  • 引入关键术语并给出定义
  • 联系他们熟悉的教科书概念
第 3 层：研究生（3-4 段）
  • 假设读者掌握机器学习基础、优化和概率论
  • 讨论与先前工作的关系
  • 解释朴素方法为何行不通
  • 介绍关键方程，并用通俗易懂的语言逐一说明
第 4 层：研究人员（2-3 段）
  • 假设读者具备该领域的专业知识
  • 讲解细微的技术贡献
  • 说明局限性和开放问题
  • 解释这如何拓展了可能性

关键方程解析

对每个重要方程：

[Equation in LaTeX]

In words: [Plain English translation]

Each term:
- [symbol]: [what it represents] [why it's there]

Intuition: [Why this mathematical form? What would change if we used a different form?]

直觉可视化产物

生成一个独立的 HTML 文件，包含：

  • 架构图 - 用方框和箭头展示信息流
  • 交互式滑块 - 调整关键参数并观察效果
  • 前后对比 - 展示该方法相较于基线的改进
  • 失败案例可视化 - 展示方法在何时以及为何失效

使用 SVG 绘制图表，使用原生 JavaScript 实现交互。采用深色主题和简洁的字体排版。

<!DOCTYPE html>
<html>
<head>
  <title>[Paper Name] - Visual Intuition</title>
  <style>
    :root { --bg: #1a1a2e; --text: #eee; --accent: #4f8cff; }
    /* Clean, research-aesthetic styling */
  </style>
</head>
<body>
  <h1>[Paper Title]</h1>
  <p class="tldr">[One-sentence insight]</p>

  <section id="architecture">
    <svg></svg>
  </section>

  <section id="interactive">
    
  </section>

  <section id="comparisons">
    
  </section>
</body>
</html>

“会出什么问题？”分析

对于每个主要组件，说明：

  1. 它的作用 - 该组件承担什么角色
  2. 没有它会出什么问题 - 具体的失败模式
  3. 为何选择这个方案 - 考虑过哪些替代方案，以及为何最终选择此方案
  4. 权衡取舍 - 采用此方案的代价（计算量、复杂性、假设条件）

输出结构

以结构化文档的形式交付：

# [Paper Title]

**TL;DR:** [One sentence]

**Why it matters:** [One paragraph on significance]

## The Explanation Ladder

### ELI5
[...]

### Undergraduate Level
[...]

### Graduate Level
[...]

### Researcher Level
[...]

## Key Equations

### Equation 1: [Name]
[Breakdown as specified above]

## What Breaks If We Remove...

### [Component 1]
[Analysis]

### [Component 2]
[Analysis]

## Visual Intuition

[Link to or embed HTML artifact]

## Further Reading

- [Prerequisite paper 1]
- [Follow-up work 1]

质量标准

  • 每个类比都必须准确，而不只是有趣
  • 必须解释方程，而不只是翻译
  • 可视化必须揭示结构，而不只是装饰
  • 面向研究人员的部分应包含洞见，而不只是总结
  • 如果原论文确实令人困惑或解释不清，应如实说明

评论

支持 Markdown