
Ljg Paper River
Trace a paper’s citation line backward (up to five layers) and forward to latest work, then narrate problem evolution in Org-mode for deep technical due diligence.
Overview
ljg-paper-river is an agent skill most often used in Idea research (also Validate scoping) that traces a paper’s predecessors and successors to tell a problem-driven evolution story in Org-mode.
Install
npx skills add https://github.com/lijigang/ljg-skills --skill ljg-paper-riverWhat is this skill?
- Recursive backward trace of criticized/improved prior papers capped at five layers.
- Forward pass to post-target advances when sources exist.
- Org-mode template: problem river, ASCII evolution map, per-paper problem/solution/fix narrative, insights and heuristics
- Feynman-style explanations aimed at non-specialist comprehension along the chain.
- Triggers on 倒读, 论文溯源, paper river, paper connects, and explicit lineage requests.
- Backward recursion depth up to 5 layers of prior papers
Adoption & trust: 3.2k installs on skills.sh; 5.5k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have one flagship paper but cannot see how the research line evolved or what problem each hop actually solved.
Who is it for?
Indie technical founders validating ML/AI bets who want lineage context before committing engineering months.
Skip if: Users who only need a two-paragraph paper summary with no citation archaeology or Org output.
When should I use this skill?
User shares a paper and wants intellectual lineage, citation chain, problem evolution, or uses 倒读 / 论文溯源 / paper river / trace back / 这篇论文的来龙去脉.
What do I get? / Deliverables
You receive a sourced Org-mode river document with maps, narratives, frontier notes, and practical heuristics for what to build or read next.
- Org-mode paper-river document with ASCII maps
- Per-paper problem/solution narrative
- Insights and actionable research heuristics
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Intellectual lineage mapping belongs on the Idea shelf when you are still choosing what to build or which approach to bet on. Research subphase covers competitor and prior-art understanding before you freeze architecture or model choices.
Where it fits
Anchor on a viral ML paper and map five layers of predecessors to see if the idea is saturated.
Find what work followed the target paper to spot open problems worth productizing.
Use the river’s ‘洞见’ section to decide whether your MVP differs from the latest frontier.
Document model lineage for an agent feature README citing the evolution narrative.
How it compares
Use this structured river narrative instead of a one-shot “summarize this PDF” prompt.
Common Questions / FAQ
Who is ljg-paper-river for?
Solo builders and researcher-founders who need prior-art chains and problem evolution, not just abstracts, when exploring papers.
When should I use ljg-paper-river?
In Idea when surveying a field from one anchor paper; in Validate when scoping whether your approach is novel; anytime the user says 倒读, paper river, or asks for 论文溯源.
Is ljg-paper-river safe to install?
It drives literature search and external URLs—review the Security Audits panel on this page and treat fetched papers as untrusted content.
SKILL.md
READMESKILL.md - Ljg Paper River
#+title: paper-river-{简短标题} #+date: [{YYYY-MM-DD Day HH:MM}] #+filetags: :paper:river: #+identifier: {YYYYMMDDTHHMMSS} #+source: {用户提供的论文 URL 或来源} #+authors: {目标论文作者} #+venue: {发表场所/年份} * 问题之河 {一句话勾出这条研究线的核心问题——让外行也想知道答案的那种。} {这个问题为什么难?卡在哪里?为什么一代一代人前赴后继?} * 溯源地图 {ASCII 图:画出论文之间的演化链。} {格式示例:} #+begin_example [2017] Vaswani et al. - Attention Is All You Need | | 问题: RNN 太慢,序列必须一个接一个算 | 解法: 扔掉 RNN,纯注意力机制 v [2018] Devlin et al. - BERT | | 问题: Transformer 只朝一个方向看 | 解法: 让它同时看左看右(双向) v [2020] Brown et al. - GPT-3 ... #+end_example * 演化叙事 {从最老的论文开始,以问题为主线,一路讲到目标论文。} {每篇论文一个小节,结构:} ** {年份} | {论文简称}: {一句话概括它干了什么} *** 它看到了什么问题 {前人方案哪里不行?具体到什么场景下会出什么毛病。} *** 它的解法 {核心思路是什么?用类比或例子讲清楚。} *** 为什么这招管用(以及哪里埋了新坑) {解法的直觉解释。同时指出它留下的局限——这个局限就是下一篇论文的起点。} * 前沿延伸 {目标论文之后,这个问题又被谁往前推了?} {如果找到了后续论文,用同样的结构讲。没有就说「截至目前,这是这条线的最新进展」。} * 一张图看懂 {用 ASCII 画一张「问题-解法」演化图,把整条线压缩到一屏以内。} {横轴是时间,纵轴是不同的解法维度。让人扫一眼就知道这个领域是怎么长出来的。} * 洞见 {读完整条演化线,你看到了什么?} {不是复述每篇论文的结论,是你自己看到的规律——这条线背后真正在发生什么变化?下一步最可能往哪走?} * 启发 {这条演化线对「怎么做研究」「怎么找问题」有什么启发?} {落点在"能用":这意味着你可以___。} --- name: ljg-paper-river description: "论文倒读法:给一篇论文,递归找出它批判和改进的前序论文(最多5层),再找它之后的最新进展,从源头正向讲述问题演化史。以问题为轴,费曼式讲解每篇论文看到的问题和解法创新。Use when user shares a paper and wants to understand its intellectual lineage, citation chain, problem evolution, or says '倒读', '论文溯源', '论文脉络', 'paper river', 'paper connects', 'trace back', '这篇论文的来龙去脉', '论文演化'. Also trigger when user wants to understand how a research problem evolved across multiple papers." user_invocable: true version: "1.0.0" --- # ljg-paper-connects: 倒读法 一篇论文不是孤岛。它站在前人的肩上,也踩着前人的伤疤。倒着挖到根,再正着看过来——问题怎么长出来的,每个人看到了什么别人没看到的,解法怎么一步步逼近真相。 ## 核心逻辑 读论文最常见的错:只看眼前这一篇,不知道它从哪来。倒读法反过来——先找到这篇论文在批判谁、改进谁,再找那篇论文又在批判谁,递归五层,挖到源头。然后掉头,从源头正向读回来。 这样读完,你拿到的不是一篇论文的知识,是一整条问题演化线的理解。 ## 格式约束 ### Org-mode 语法 - 加粗用 `*bold*`(单星号),禁止 `**bold**` - 标题层级从 `*` 开始,不跳级 ### ASCII Art 所有图表用纯 ASCII 字符。允许:`+ - | / \ > < v ^ * = ~ . : # [ ] ( ) _ , ; ! ' "` 和空格。禁止 Unicode 绘图符号。 ### 模板权威性 输出结构依据 `references/template.org`。 ### Denote 文件规范 - 时间戳:`date +%Y%m%dT%H%M%S` - 可读时间:`date "+%Y-%m-%d %a %H:%M"` - 文件名:`{时间戳}--paper-river-{简短标题}__paper_river.org` - 输出目录:`~/Documents/notes/` ### Org 文件头 ``` #+title: paper-river-{简短标题} #+date: [{YYYY-MM-DD Day HH:MM}] #+filetags: :paper:river: #+identifier: {YYYYMMDDTHHMMSS} #+source: {URL 或来源描述} #+authors: {目标论文作者} #+venue: {发表场所/年份} ``` ## 红线 1. *问题为轴* — 整篇文章的主线是"问题怎么演化的",不是"论文怎么排列的"。论文是配角,问题是主角 2. *口语检验* — 你会这样跟朋友讲一个领域的发展史吗?不会就改 3. *差异为核* — 每篇论文的讲解重心是"它和前一篇的差异在哪",不是独立地介绍每篇论文 4. *零术语* — 先用大白话落地,再顺带提术语名 5. *逻辑不断链* — 从第一篇到最后一篇,因果链条不能断。读者能感受到"所以他们才会这样做" 6. *诚实* — 找不到五层就说找到几层。论文之间的关系不确定就说不确定。不编造引用关系 ## 写作原则 1. *差异驱动叙事* — 不要给每篇论文写独立摘要再拼起来。以"这篇看到了前一篇的什么问题"作为每段的开头,让差异本身推动叙事往前走 2. *变形替代定义* — 讲两个方案的区别时,把方案A连续变形成方案B。"如果你把X去掉,再加上Y,你就得到了Z"——比"Z和X的区别是..."有力十倍 3. *推理外显* — 每个解法出现前,先让读者感受到"不这么做不行了"的压力。模拟发现的过程,不是汇报发现的结果 4. *一张图胜千言* — 在演化叙事之前画溯源地图,在叙事之后画压缩总览图。让读者先有全景再入细节,细节看完再回全景 ## 执行 ### 1. 获取目标论文 - arxiv URL → WebFetch - PDF → Read(注意 pages 参数限制) - 论文名称 → WebSearch 找到全文 确保拿到:标题、作者、摘要、引言(尤其是 related work / introduction 中对前人工作的批判)。 ### 2. 提取批判链线索 仔细读目标论文的引言和相关工作部分。找出: - 它明确说"前人方法 X 有问题 Y"的地方 - 它声称自己改进了哪篇/哪几篇论文 - 它对比的 baseline 是谁 从中锁定 *被批判/被改进的核心论文*(通常 1-3 篇,选最直接的那条线)。 ### 3. 递归溯源(深度研究) 对第 2 步找到的核心前序论文,重复同样的过程:它又在批判谁?改进谁? 递归规则: - 最多递归 5 层(到第 5 层或到该领域的奠基论文为止) - 每层只追 *问题最相关的那条线*,不发散 - 如果某层找不到明确的被批判对象,停在那里 使用 Research skill(deep research 模式)获取每层论文的关键信息。每篇论文至少拿到:标题、作者、年份、核心问题、核心解法、对前人的批判点。 ### 4. 前沿延伸 反方向:目标论文之后,有没有新论文在批判/改进它? 同样用 Research skill 搜索: - 引用了目标论文的后续工作 - 同一问题上的最新进展 找到最相关的 1-3 篇后续论文,获取同样的信息。 ### 5. 构建演化线 把第 3、4 步的结果整理成时间线: ``` [最老] Paper_0 → Paper_1 → ... → [目标论文] → [后续论文] ``` 每条箭头标注:后者看到了前者的什么问题。 ### 6. 正向费曼叙事 从最老的论文开始,正向讲述。关键:不是逐篇独立介绍,而是以问题演化为线索串联。 每篇论文讲三件事(以差异为重心): 1. 它看到了前人方案的什么具体问题(用例子或场景说明) 2. 它的解法核心思路(用类比讲清楚) 3. 这个解法又留下了什么新的问题(自然过渡到下一篇) ### 7. 画图 两张图: - *溯源地图*:放在演化叙事之前,展示论文间的引用/批判关系 - *问题-解法总览*:放在叙事之后,把整条线压缩到一屏。让人扫一眼就知道这条线怎么长出来的 ### 8. 提炼洞见 读完整