Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
lijigang avatar

Ljg Paper

  • 6.3k installs
  • 6.7k repo stars
  • Updated August 4, 2026
  • lijigang/ljg-skills

ljg-paper is an agent skill for Paper reader for non-academics. Reads a paper and tells it back as one continuous story — the life of the paper's core proposition (命题), told on a seven-beat spine (主角 / 困境 / 旧路 /

About

Paper reader for non-academics. Reads a paper and tells it back as one continuous story - the life of the paper's core proposition (命题), told on a seven-beat spine (主角 / 困境 / 旧路 / 转折 / 解法 / 结局 / 内核): born in a bind on a base-rate ruler, crystallized as a bold conjecture, argued through mechanism and evidence, distilled into a new way of seeing, then walked out of the paper - life-tested and cashed --- name: ljg-paper description: "Paper reader for non-academics. Reads a paper and tells it back as one continuous story - the life of the paper's core proposition (命题), told on a seven-beat spine (主角 / 困境 / 旧路 / 转折 / 解法 / 结局 / 内核): born in a bind on a base-rate ruler, crystallized as a bold conjecture, argued through mechanism and evidence, distilled into a new way of seeing, then walked out of the paper - life-tested and cashed into falsifiable predictions (检验).

  • ljg-paper: 把一篇论文当一个故事讲
  • 困境 - - 主角面前那道坎(具体到一个例子),以及这个问题域的水位(base rate:现状到哪、典型一步多大)
  • 命题 - - 作者敢押的那句大胆猜想,一句话说出来
  • 论证骨架 - - 机制怎么动、证据怎么撑(含最反直觉的副发现 - - 往往是这故事最有意思的那拍)
  • 内核 - - 带得走的那个新视角:原来还能从这个角度看

Ljg Paper by the numbers

  • 6,259 all-time installs (skills.sh)
  • +105 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #248 of 2,153 Testing & QA skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

ljg-paper capabilities & compatibility

Capabilities
ljg paper: 把一篇论文当一个故事讲 · 困境——主角面前那道坎(具体到一个例子),以及这个问题域的水位(base rate:现状到哪、典 · 命题——作者敢押的那句大胆猜想,一句话说出来 · 论证骨架——机制怎么动、证据怎么撑(含最反直觉的副发现——往往是这故事最有意思的那拍) · 内核——带得走的那个新视角:原来还能从这个角度看
Use cases
documentation
From the docs

What ljg-paper says it does

--- name: ljg-paper description: "Paper reader for non-academics.
SKILL.md
Output opens with a scannable 速读 card (一句话 / 大想法 / 只记三件事) that compresses the whole story three ways for the time-poor reader and the six-months-later self, then tells the full story.
SKILL.md
The job is storytelling that makes the paper land, not academic critique.
SKILL.md
npx skills add https://github.com/lijigang/ljg-skills --skill ljg-paper

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs6.3k
repo stars6.7k
Security audit2 / 3 scanners passed
Last updatedAugust 4, 2026
Repositorylijigang/ljg-skills

When should developers use ljg-paper and what problem does it solve?

Paper reader for non-academics. Reads a paper and tells it back as one continuous story - the life of the paper's core proposition (命题), told on a seven-beat spine (主角 / 困境 / 旧路 / 转折 / 解法 / 结局 / 内核.

Who is it for?

Developers working with ljg-paper patterns described in the skill documentation.

Skip if: Skip when cached docs are empty or the task is outside the skill's documented scope.

When should I use this skill?

Paper reader for non-academics. Reads a paper and tells it back as one continuous story — the life of the paper's core proposition (命题), told on a seven-beat spine (主角 / 困境 / 旧路 / 转折 / 解法 / 结局 / 内核):

What you get

Grounded guidance and workflows from SKILL.md for ljg-paper.

Files

SKILL.mdMarkdownGitHub ↗

ljg-paper: 把一篇论文当一个故事讲

读一篇论文,最难的不是看懂,是讲明白。讲给一个不懂这个领域的聪明人——讲到他能复述出来——你才算读完。

这是一个讲故事的活。一篇论文背后,有主角、有困境、有撞墙、有转折、有解法、有结局、有内核。把这副脊柱先立起来,再往上挂内容;不然写出来就是十份独立汇报拼成的合订本,读者翻两页就走神。

故事真正的主角是论文的命题——作者敢押的那句大胆猜想。整篇讲的就是这个命题的一生:在困境里诞生(前人被两难卡住,水位摆在那儿),在论证里站住(机制和证据把它撑起来),最后走出论文——过博导的审,下生活的水,朝未来押一注。论文讲完,命题不散场。

总目标(先看这个)

让一个不懂这个领域的聪明人听完,能把这篇论文当一个故事再讲一遍——讲出五件事:

1. 困境——主角面前那道坎(具体到一个例子),以及这个问题域的水位(base rate:现状到哪、典型一步多大) 2. 命题——作者敢押的那句大胆猜想,一句话说出来 3. 论证骨架——机制怎么动、证据怎么撑(含最反直觉的副发现——往往是这故事最有意思的那拍) 4. 内核——带得走的那个新视角:原来还能从这个角度看 5. 检验——命题拿到生活里哪儿站住、哪儿破;它要是对,接下来该看到什么

任一件让听众卡住 = 故事讲砸了。凝练只在 title 上追求;正文该展开就展开——目标不是短,是让人从听不懂走到能复述。

这五件事,文章分两层给你:顶上一张速读卡先给地图(一句话 / 大想法 / 只记三件事),下面的故事带你把领土走一遍。速读卡是这五件事压成三句、给两种人看的——还没决定要不要读全文的,和半年后回来只想要核心的。卡片写在最后、放在最前:先读懂全文,才压得出那三句。

故事骨架

把论文讲成故事,脊柱是这七拍。不是七个子标题,是节奏要求:

1. 主角 — 谁在这个故事里?这个领域的研究者、一个具体的模型、一个用户、一个系统、甚至论文要回答的那个问题本身。开场两句先把主角领上台。 2. 困境 — 主角面前撞着什么?解不了会怎样?把"利害"摆给读者——读者要看见值得为这件事坐下来听完。 3. 旧路 — 前人怎么试的?他们不傻——把卡住他们的那个两难摆出来,读者才信这堵墙是真的。顺手立一把尺:这个问题域的水位(base rate)——现有做法到哪、典型一篇论文能往前挪多少。后面结局的数字全靠这把尺称轻重。开创性问题没有前作,两难可以省,尺照立——「之前没人敢碰」也是一种水位。 4. 转折 — 作者看到了别人没看到的什么?把它凝成一句命题——作者敢押的大胆猜想,敢到让人想反驳。整篇论文都是在为这句话作证。这是故事的腰,整副脊柱靠它撑住。 5. 解法 — 带着命题,作者怎么把它撑起来?机制、设计选择的理由——一步步把方法在那个例子上铺开,让读者跟着推。这不只是"他们做了什么",这是论证骨架的主体:每个组件都是命题底下的一根柱子。 6. 结局 — 证词时间。挑两三组最说明问题的数字,放回旧路立的那把尺上称——领域典型一步挪多少,这篇挪了多少,读者才掂得出轻重。最反直觉的副发现单独留一拍呈现。 7. 内核 — 故事真正留下的那颗东西。不是论文结论的复述,是听众走出门带走的那个新视角:原来还能从这个角度看。说出这个角度,再说出它除了这篇论文还能看什么。

七拍讲完,纸内的故事收了;命题的故事还差最后一程——出门。先过博导的审(站不站得住),再下生活的水(哪儿灵、哪儿破),最后朝未来押一注(它要是对,该看到什么)。这一程不归脊柱管,归「博导审稿」「检验」「启发」三节管。

执行 11 步对应到故事弧上:

故事拍在执行哪一步
主角 + 困境 + 旧路(立尺)「问题」整段
转折预告 → 命题登场「问题」收尾 → 「翻译」开头
解法(论证骨架)+ 结局(回尺)「翻译」主体
故事道具「核心概念」
内核(视角)「洞见」
故事评审「博导审稿」
命题出门(生活测 + 押未来)「检验」
听众的故事「启发」

速读卡不在这张表里——它不是七拍中的一拍,是七拍走完后把整篇压出来的(最后写,最前放)。

写完默读:这读起来像一个人在跟我讲一个故事,还是十段独立汇报?后者 → 重写。

七拍落在一篇论文上长什么样

拿 LenVM(让模型一边写一边知道还要写多远)举例:

  • 主角:一个写长答案的语言模型——它在写 GSM8K 的解题过程
  • 困境:模型不知道什么时候该收尾,结果要么没说完就停,要么啰嗦到 token 烧光
  • 旧路:之前的做法是直接训长度限制,硬卡;可一卡,推理质量就掉——省 token 和保质量,两头按不住。尺也立在这儿:到此为止,省长度就得赔精度,没人两头都占住
  • 转折:命题登场——"长度本来就是一种剩余距离,能像价值一样被实时预测出来"。模型每写一字都该知道还差多远
  • 解法:在 RL 训练里加一个 length value head,用 -1 constant reward 让它学到"少写一字省一字"——这根柱子直接长在命题上
  • 结局:回尺——推理长度降 30%,准确率不降反升,两头占住了;token 词云里 "wait/think" 让位给 "finalize/confirm"
  • 内核:原来"知道止"不是天分,是可以被监督出来的能力——监督模型"知道止",比监督它"会答"更值

命题出了论文还能走两步:生活里,演讲台上有倒计时牌的人收得住,没有的人拖堂——站住了;押一注:往后一两年,长度控制会从"卡死上限"转向"预测剩余"。

写出来不是七个段落,是一条线——把这七拍藏在「问题→翻译→核心概念→洞见」的连续叙述里,读者只感受到一个故事在走。

格式约束

Org-mode 语法

  • 加粗用 *bold*(单星号),禁止 **bold**
  • 标题层级从 * 开始,不跳级

ASCII Art

所有图表用纯 ASCII 字符。允许:+ - | / \ > < v ^ * = ~ . : # [ ] ( ) _ , ; ! ' " 和空格。禁止 Unicode 绘图符号。

模板权威性

输出结构依据 references/template.org。禁止参考 ~/Documents/notes/ 中已有论文文件的章节结构——旧文件可能使用过期模板。

章节命名

Section 名固定:速读 / 问题 / 翻译 / 核心概念 / 洞见 / 博导审稿 / 检验 / 启发。「速读」是 v6.1 新增(一句话 / 大想法 / 只记三件事 三件套),「检验」是 v6 新增,其余沿用——这些名字已沉淀 craft 含义。不重命名为"第一幕/第二幕"。故事弧体现在每段的写法和衔接上,不在标签上。禁止英文戏剧术语外露(protagonist / climax / resolution 等),框架词全中文。

Denote 文件规范

  • 时间戳:date +%Y%m%dT%H%M%S
  • 可读时间:date "+%Y-%m-%d %a %H:%M"
  • 文件名:{时间戳}--paper-{简短标题}__paper.org
  • 输出目录:~/Documents/notes/

Org 文件头

#+title:      {一句精练语句提炼论文核心思想或发现}
#+subtitle:   {论文原始标题,通常英文}
#+date:       [{YYYY-MM-DD Day HH:MM}]
#+filetags:   :paper:
#+identifier: {YYYYMMDDTHHMMSS}
#+source:     {URL 或来源描述}
#+authors:    {作者列表}
#+venue:      {发表场所/年份}
title 这一句怎么写

title 是这篇笔记的灵魂句——读者扫一眼就知道这篇论文带走什么。它不是文件名,不是方法名,是故事内核的凝练表达

不是"把一段话压成一句话",是用最少的字把整个故事的内核取出来。抽出 title 贴墙上,它本身就该像一句警句、一个篇名、一句能记住的话。

写作约束(按优先级)

1. 中文母语凝练 — 像汪曾祺、王小波、阿城、李娟的标题:短、净、有刃。

  • 写完默问:「一个没读过翻译小说的中国人会这样说吗?」不像 → 重写。
  • 完整反翻译腔自查表:~/.claude/PAI/USER/AI_WRITING_PATTERNS.md(必扫 Layer A)。
  • 杀句式:被动句("被锁在…里")、"是…的"句、长定语后置("那个由…引起的…")、"进行+名词"、"让我们…"。

2. 零中英混杂 — title 不出现英文术语(RL / HR / Agent / Multi-agent / token 等都不行)。术语放正文展开,title 只放思想。例外:人名、产品名(GPT、Claude)。

3. 6-15 字 — 短到能记住,长到能承得住一个发现。超过 15 字基本就是没炼到位——回去再砍。

4. 动词为骨,名词具体 — 形容词能砍就砍("重大的""根本的""惊人的"全删)。每个字都得干活。

5. 自带张力,三种姿态任选其一

  • 反直觉 — 「学会反成枷锁」
  • 对仗或并置 — 「教人如教己」「记得太牢,想不出新」
  • 转折或反讽 — 「答得越准,看见越少」

6. 不复述题目,不当方法名

  • ✗「关于强化学习预训练空间转移的探索性研究」(学术腔)
  • ✗「PreRL:把强化学习搬进预训练空间」(方法名 + 方法描述)

正例对照(看转化方向)

论文核心思想✗ 翻译腔 / 口语化✓ 中文凝练
奖励信号把模型锁在已会轨迹里,擦掉题目就解锁奖励信号会把模型锁死在已会的轨迹里,擦掉题目就解锁了学会,反成枷锁
只用错样本做 RL,反思能力自己长出来只用错样本做 RL,反思能力自己长出来错处长出反省
模型在向量空间里思考比生成 token 更省更准模型在向量里想,比一边想一边写更省、更准、更快默想胜出口
多智能体缺的是组织协调而非个体智能Multi-agent 缺的不是聪明,是 HR——成功率 69 跳到 85多智不如善织
老师与学生看待问题的角度不同导致教学失败老师比学生高分还教不会,是因为他想问题的姿势跟学生不一样高分难为师
写作时预测剩余长度让模型知道何时收尾把"还要写多长"做成一个值函数,模型每写一个 token 就知道离收尾还有多远知止方能落笔

注意正例的共性:

  • 4-8 字主干为多,节奏接近成语 / 古文标题
  • 动词带刃:「锁」「长」「默」「善」「止」
  • 有古意但不晦涩;有判断但不抒情
  • 单独抽出能立住

自检三问(写完默念)

1. 抽出来贴墙上,像不像一句篇名 / 警句? 2. 一个中文母语者会这样说吗?(汪曾祺会这么写吗?) 3. 删掉任何一个字会不会塌?

任一答 No → 回去重写,不要凑合发布。

可识别性测试(必须过)

把 title 单独贴出来,给一个没读过这篇论文的人看,问:「这论文大概在讲什么?」——他不需要给出准确答案,但应该有方向感。

如果答得出方向 → title 通过。 如果完全猜不到(典型是高度凝练的古文式 title),必须用中文 subtitle 兜底,让它承担解释功能。英文 subtitle 只是论文原标题,不算兜底:

#+title:      字未出,止已现
#+subtitle:   把"还要写多远"做成一个 value 函数 — Length Value Model: ...

凝练和可识别性必须共存。只凝练 = 6 个月后自己也认不出是哪篇;只可识别 = 退化回 28 字啰嗦句。两个测试都过才发布。

与其他字段的关系

  • title 与「洞见」section:先写完「洞见」section,回头从那段话里取骨(不是压缩,是取核)填进 title。
  • title 与文件名:denote 文件名 paper-{简短标题} 的「简短标题」是方法名 / 核心概念名(如 prerldsrl),用于文件检索;title 是故事内核句,用于内容入口——两者不同字段,互不替代。

文件写入后报告路径。

红线(每条必须过)

1. 口语检验 — 你会这样跟朋友讲一篇论文吗?不会→改。学术腔是默认敌人 2. 零术语 — 先用大白话落地,再顺带提术语名。如果必须用原文术语才能解释,说明还没懂 3. 短词优先 — 能用两个字说的不用四个字。「本文提出了一种新的框架」→「他们做了个东西」 4. 一句一事 — 每句只推一步 5. 具体 — 名词看得见,动词有力气。形容词能砍就砍 6. 开头给理由 — 问题部分的第一句让人想知道答案 7. 不填充 — 删学术套话(「近年来随着...的发展」「值得注意的是」)。每句干活 8. 信任读者 — 正文里说一遍够了,不回头重复结论。唯一例外是顶上那张「速读」卡:卡片和正文是两个高度,卡片给方向、正文给细节,两处不用同一句话 9. 诚实 — 论文有硬伤就说有硬伤。看不懂的部分说看不懂 10. 6 个月后的我看得懂吗? — 每个术语首次出现必须落地("value function = 给定当前状态预测未来累积奖励"),每个公式必须翻译成自然语言,每个引用都要说明对外行的意义。自检:默想"半年后我在 denote 里搜到这篇,30 秒内能回想起核心吗?"——不能 → 重写 11. 外行优先于凝练 — 该展开就展开,不要为了"短"砍掉读者真正需要的铺垫。凝练的尺度只针对 title;正文该多长就多长,节奏由让人懂的需要决定,不由"短"的洁癖决定 12. 故事一气 — 整篇读下来,像一个人在跟你讲一件事,不像十份独立汇报拼出来的合订本。章与章之间靠故事弧的牵引力相连:主角刚撞墙,转折就来了;转折刚立,解法接着展开。每一段的最后一句给下一段开口子。自查:把章节标题去掉读全文,故事流还在不在?还在 → 通过;变成碎片 → 重写衔接

写作原则

五条核心原则,决定文章是"一个人在讲故事"还是"机器在汇报内容":

1. 故事流贯到底 — 第一句到最后一句是同一个故事在走:主角立了、困境亮了、旧路撞了、命题来了、论证展开了、结局收了、内核落了,命题出了门。「故事骨架」那七拍是脊柱,所有内容挂在脊柱上。每段末句给下段留个口子——读者读到一半,放不下 2. 一个锚点撑全文 — 「问题」里立的那个具象例子就是锚点。「翻译」「核心概念」都在这个锚点上展开,每段都回到它,让读者一直待在同一个问题域里。换锚点 = 换地图 = 读者前面建立的直觉全丢

  • 「亲历」小节里也只能用一个例子。两个例子 = 切碎读者直觉,即使两例都强,挑最锋利的一个。反例:先用"产品介绍 100 字"再用"LIFEBench"——两条故事线读者大脑要切换两次。正例:从头到尾"GSM8K 200 token"贯穿——读者一直待在同一个困境里

3. 推理外显 — 模拟"一个人想明白的过程",而非呈现"想明白之后的结果"。用"既然 A 是 B,那能不能 C 也是 D?"带读者一起推。让读者觉得结论差一步就是自己想到的 4. 变形替代定义 — 解释两个概念的关系时,把 A 连续变形成 B,不要说"A 和 B 是 XX 关系"。「把 LSTM 变形→看起来像 ResNet」比「LSTM 和 ResNet 是对偶的」有力十倍 5. 落点在能用 — 给出"这意味着你可以___",而非"这让我们重新思考___"。读者听完故事要带走一个能动手的东西,不是一个值得沉思的感慨

工具箱(选用)

讲故事时可以拿的工具,没有哪个是必须的:

  • 类比 — 承重的,方法的关键组件都能映射上。沿着类比走一遍方法
  • ASCII 图 — 展示组件关系、数据流、结构对比。读者有概念脚手架后再画
  • 餐巾纸速写 — 「以前这么想,现在应该这么想」的并排对比
  • 好问题 — 把论文解决的困境变成一个让外行也好奇的问题
  • 递进例子 — 从简单到复杂,一步步搭建理解
  • 反问入链 — 遇到隐含假设,用问题打开

执行

1. 获取内容(幕后:拿到故事的原料)

  • arxiv URL → WebFetch
  • PDF → Read(注意 pages 参数限制)
  • 本地文件 → Read
  • 论文名称 → WebSearch

确保拿到:标题、作者、摘要、核心方法、结果。

如果论文有一张承载全文核心思路的总览图(overview / architecture diagram,通常是 Figure 1),提取并保存到 ~/Documents/notes/images/,文件名 {identifier}--paper-{简短标题}-overview.png

判断标准:这张图让人一看就抓住论文在做什么。不是所有论文都有——没有就跳过,不要硬找。

提取方法:

  • arxiv → 访问 HTML 版(arxiv.org/html/...),找到图片 URL,WebFetch 下载
  • PDF → 截取含图页面保存为图片

2. 问题:搭台——让读者亲历主角的困境(拍 1-3 + 转折预告)

这一节要做的是搭台。三件事按顺序在同一段连续叙述里完成——亲历困境(拍 1+2)、旧路撞墙(拍 3)、转折预告。

不是描述问题,是让读者亲历那个问题。开场给一个具象示例——一个具体场景、一段输入输出、一张失败截图、一个用户故事——让读者在这个例子上看到困境。

不是「大模型在事实回答上存在幻觉问题」,是:「你问 GPT『2023 年图灵奖得主是谁?』它一本正经回答 Yann LeCun。再问一次,它说 Hinton。第三次又变了。」

三拍叙事,同一个例子贯穿:

1. 亲历 (拍 1+2) — 主角谁、面前撞着什么、解不了会怎样。例子最好简单到一两句话能说完 2. 旧路 + 立尺 (拍 3) — 之前的研究者在这个例子上怎么做?卡住他们的两难是什么?把短板用同一例子暴露出来,读者看见"哦,这条路确实卡住了"。顺手立尺:这个问题域的水位——现状能到哪、典型一步多大。后面结局的数字全靠这把尺称 3. 转折预告 (拍 4 的引子) — 本论文作者在这个例子上看到了什么别人没看到的入口?只引出方向,不展开机制,也不把命题整句说破——命题登场是「翻译」开头的事

如果论文没有明确的前作(开创性问题、新领域),两难可以省,尺照立——"之前没人敢碰、公认做不到"也是一种水位——然后直接「亲历→转折预告」。

三拍是节奏要求,不是格式要求——不要硬加 **亲历/**旧路/**转折预告 子标题。问题节用一段连续叙述更有钩力,子标题会把"流"切成"段"。子标题留给翻译节用(机制要分步揭开)。

反例:「本文提出了一种新的 XXX 框架」——这是学术摘要,不是搭台。

3. 翻译:推进——命题登场,论证骨架展开(拍 4+5+6)

「问题」已经把读者带到转折前一刻——这一节不要再重述问题。开头先让命题登场:把作者敢押的那句大胆猜想一句话亮出来,亮到让人想反驳。后面整节就是看作者怎么把这句话撑起来——方法怎么动、证据怎么落。

沿用同一个例子:继续在「问题」里那个具象示例上讲。读者刚刚在那个例子上看到旧路走不通、转折在哪里——你现在带他在同一个例子上一步步打开论文的方法。换例子 = 切语境,读者前面建的直觉就丢了。

唯一豁免:如果同一例子无法支撑机制细节(比如算法过程需要展开数据流),引入"子例子"作为延伸——但子例子必须和父例子在同一问题域里,让读者感觉是"放大镜下看局部",而不是换地图。

开头立锚点:找到一个具象的中心隐喻或画面——锚点描述的是方法在那个例子上的样子。比如「在我们刚才那个图灵奖问题上,方法像一个分诊台:先把不确定的回答拦下来再说」。锚点和「问题」例子焊在一起。

一步步揭开,让读者解锁迷雾:每段往前推一步,每段都给读者一个新视角,"啊,原来如此"的小揭秘累积成对例子的深度理解。揭秘动词:"这时候你看……""于是发生了……""那这一步怎么办呢——他们想到……"。前一段说的事打开后一段的口子。

需要覆盖(都在那个例子上):

  • 命题是什么(拍 4:作者敢押的那句话,开头就亮出来)
  • 解法怎么动(拍 5:核心机制怎么把命题撑住——讲完读者能指着每个组件说"这是哪根柱子")
  • 结局长什么样(拍 6:挑最说明问题的两三组数字,挂回「问题」立的那把尺)
  • 理解全文需要的钥匙概念(如果有)

子标题按内容需要组织,不必固定。

翻译节必有清单(防止"凝练"把肉削了)

1. 承重类比 — 不止是装饰,要能映射方法的关键组件。范本:「跑步选手 + 手表」(把"模型"映射成跑步选手、把"value head"映射成手表,类比能撑住整套机制讲解)。烂例:仅"倒计时表"——没把"训练信号怎么来"映射进去,类比浮在表面 2. 三组以上挂在尺上的数字 — baseline / 改进 / 关键 ablation,每个数字都能回答"相对什么基准、在这个领域算大算小"。裸数字是修辞,挂上尺才是证词 3. 一个反直觉的副发现 — 论文里最让人"哇"的一段,单独成节呈现。范本:LenVM 的"token 词云分析"("think/wait" vs "finalize/confirm")。有就必须保留,不能因为追求凝练砍掉;没有就明说"这篇没有",不要硬挤 4. 论证骨架抽得出来 — 叙述讲完,读者要能用两三句话说出命题靠什么撑着:机制一句、证据一句、消融一句。骨架藏在故事里,但一抽就出来;抽不出来,这节就还没讲完 5. 不放原始公式 — 公式对外行无用。要么用文字翻译("L_len = ... 意思是模型每写一字都被监督一次"),要么留作可选附录 section。主文里不出现 LaTeX / MathJax 风格公式

4. 核心概念:故事道具——主角手里那几件东西

挑出论文中最关键的 3 个概念(方法名、架构组件、数学对象、新定义……),逐个拆解。这些是故事里主角用来转过那个弯的道具——少了任一件,故事就讲不通。

3 个是 floor 不是 ceiling——砍到 2 个通常意味着漏掉了一个隐藏在方法里的关键设计选择(比如 LenVM 的 constant -1 reward——它不是"组件",是让整套机制 work 的设计 trick,必须单独成节讲)。如果论文真的只有 2 个独立关键概念(罕见),明确说明,不硬凑。

每个道具都回到「问题」那个例子上落地——不是孤立讲一个术语,是回到那个例子,让概念在那个语境里浮出水面。读者每解锁一个道具,对那个例子的理解就深一层,迷雾就散一片。

每个道具:

  • 一句话:这东西是什么,干什么用的
  • 回到例子:在那个例子上,这个道具长什么样?少了它在那个例子上会怎样?解释两个概念的关系时,优先用"把 A 变形成 B"而非"A 和 B 是 XX 关系"——变形比定义有力
  • 为什么重要:少了它论文的逻辑链断在哪里

选道具的标准:读者如果不懂这个,后面的内核和故事评审就跟不上。已经在「翻译」里讲透的不重复选。

5. 洞见:内核——故事走完留下的那颗东西(拍 7)

整个故事最值钱的往往就一个点——作者真正找到的那颗新结晶。它多半是一个视角:原来还能从这个角度看。

用一句话把这个角度说出来,再补一句:它除了这篇论文,还能看什么。这句话应该让听众觉得「这个想法我可以带走」,而不是「哦,论文说了这么个事」。

检验标准:把这句话单独抽出来,脱离论文上下文,它还有没有力量?如果只是在复述论文结论,那不是内核。内核是你听完故事之后自己看到的那个东西——论文里未必直说,但逻辑指向它。

说不出来就重读「翻译」节。如果论文确实没有思想火花,直说「这篇论文是工程改进,没有认知层面的新发现」。不要硬挤。

6. 博导审稿:故事评审——这个故事站不站得住

换身份:这个方向上带了二十年研究生的博导。学生拿着论文来找你,你判断这个故事讲得真不真、值不值得认真对待。

用白话说,像在办公室跟学生聊:

  • 选题眼光:主角面前那个困境真实吗?真缺口还是人造缺口?
  • 方法成熟度:解法是巧劲还是蛮力?有没有更自然的做法被忽略?找方法的根本预设有没有问题——不是只看数字漂亮不漂亮,是看作者假设了什么。例:LenVM 假设 sampling 分布在使用 value 信号 nudge 后还稳定——但 nudge 一旦发生分布就变了,value 预测可能失准。这种self-referential 隐忧比"scale 不够"重要十倍。自问:这论文如果错,最可能错在哪一步?错的根源是不是一个未被讨论的预设?
  • 实验诚意:baseline 公不公道?消融到位没?结局那几个数字经不经得起追问?
  • 声称的分量:把结论放回领域的水位上称。这类声称("解决了 X")这个领域一年出多少篇,历史上几篇真站住了?超常的声称要超常的证据——base rate 摆在那儿,不陪作者激动
  • 写作功力:最该说清楚的地方有没有偷懒?
  • 判决:strong accept / weak accept / borderline / weak reject / strong reject,一句话理由

好的说好,差的说差在哪儿。

7. 检验:命题出门——下生活的水,朝未来押注

博导审的是纸内:实验、基线、预设。这一节把命题带出纸外,走两步。

第一步,生活测——拿生活经验当测试场。挑一个读者熟到不用解释的场景,把命题放进去跑:

  • 命中:哪儿站住了?(LenVM 的"知道剩余距离就收得住"——演讲台上有倒计时牌的人不拖堂)
  • 破绽:哪儿失灵了?(人看见倒计时会慌,模型不会——"慌"是命题没覆盖的变量)

失灵处不是命题的污点,是命题的边界。摸到边界,读者才算拥有这个命题,而不是背下它。只用一个主场景,至多加一个对照——例子多了切碎直觉(与「一个锚点撑全文」同理)。命题离生活太远测不了的(纯数学构造、底层硬件),明说"这命题下不了生活的水",不硬测。

第二步,押未来——按命题往前推:X 条件下,该看到 Y。三种形态,至少押一注:

  • 领域走向:命题要是对,往后一两年该看到什么样的工作冒出来
  • 现实行为:把命题搬到论文外的系统或人身上,什么条件下该观察到什么
  • 产品形态:命题要是对,什么工具会变样

押注要敢错——写成能被打脸的样子:有条件,有可观察的结果。打不了脸的("未来会更重视 X")删掉。命题真推不出任何预测,直说——推不出预测的命题多半还没立住,这本身就是个发现。

这一节管"信不信",下一节「启发」管"用不用"。注是押给世界开奖的,启发是今天就动手的——别把注写成启发。

8. 启发:听众的故事——这故事接到我的生活里

落点在"能用",不在"能想"。给出"这意味着你可以___",而非"这让我们重新思考___"。听完故事,听众要带走一件能动手的事。

用三个视角试探连接,命中展开,没命中跳过,全没命中说「没有」:

  • 迁移:论文的某个机制 / 视角能移植升级我体系的某个零件吗?具体怎么接?
  • 混搭:论文的某个组件和我已有的东西组合能产生新东西吗?产出什么?
  • 反转:论文的做法和我的默认假设相反吗?该停下什么、开始什么?

9. 速读:回头把整篇压成三句(写在最后,放在最前)

全文写完,回头压一张速读卡,放到最前。顺序是关键——写在最后,放在最前:没读懂全文,压不出这三句;正像 title 那句灵魂句也是写完「洞见」回头取骨。

三句一句比一句细,是同一篇论文的三档变焦,不是三个零件——一条引子先把它们拢成一个动作:下面那个长故事,就是把这三句一拍一拍展开。

  • 一句话:平实说完整篇——主角卡在什么困境、作者押了什么、结果怎样。和 title 分工:title 是炼成警句的灵魂句(要 subtitle 兜底),这句是谁读一遍都知道"这论文干了什么"的话。别和 title 用同一句。
  • 大想法:只能带走一个想法的话,是哪个。它和「洞见」是同一颗核——这里先亮出来给方向(读者带着目的地往下走,更跟得动),「洞见」在故事走完后落地、再给第二个用处。两处别用同一句话。
  • 只记三件事:半年后忘掉大半,这三条忘不掉——通常是困境为什么值得解、命题靠什么撑住、走出论文带走什么。这是「总目标」五件事压成三件,是重建故事的承重点;不是押注(那在「检验」),不是动手清单(那在「启发」)。

速读是一张卡片(能扫、能记),正文是一个故事(要顺着读)。两种写法各干各的活,不冲突——卡片是故事压出来的,不是另起炉灶。

10. 收口:过红线 + 故事流自查

逐条扫红线。额外检查:

  • 破公式——否定式排比全文不超过两处,三段式改两项或四项
  • 变节奏——长短句交替
  • 杀金句——听起来像可引用的,重写
  • 查跳跃——逻辑每步可追
  • 查速读——三句是同一篇的三档变焦吗?大想法和「洞见」两个高度、没撞词?三件事是承重点、没跟「检验」「启发」串味?

故事流自查(红线 12 的兜底)

  • 把所有章节标题(问题/翻译/核心概念/洞见/博导审稿/检验/启发)暂时盖住,从头读到尾。读起来还像一个人在讲一个故事吗?
  • 章和章交界处那一句,有没有把下一章的口子开开?「问题」末尾要勾出「转折」的影子;「翻译」末尾要让读者已经知道有几件道具在动;「核心概念」末尾要让读者准备好接「内核」那一句;「博导审稿」末尾要把命题送出门,接「检验」。
  • 默问:这十步读下来,七拍故事弧(主角/困境/旧路/转折/解法/结局/内核)加命题出门那一程(博导/检验/启发)走完了吗?哪一拍弱了 → 加。
  • 命题三问:命题那句话在「翻译」开头亮出来了吗?尺在「问题」立了、在「结局」回了吗?「检验」两步都落地了吗——生活测见了破绽,押注能被打脸?

列修改清单确认后生成文件。

11. 生成 Org 文件

按 Denote 规范获取时间戳,读 references/template.org,写入 ~/Documents/notes/

验收

  • 故事感先立 — 通读一遍像一个人在讲一个故事,不像十段独立汇报拼接
  • 七拍齐 — 主角 / 困境 / 旧路 / 转折 / 解法 / 结局 / 内核 都有着落(开创性论文豁免"旧路"的两难,尺照立)
  • 命题在腰 — 「翻译」开头那句命题清晰可指——单独抽出来,读者会想反驳;听众能复述"作者敢押什么"
  • 尺立而后称 — 「问题」立了水位尺,「结局」的数字挂回尺上;全文无裸数字
  • 章际有钩 — 每章末句给下章开口子,标题盖住读全文,故事流还在
  • 问题让人亲历:开场有具象示例,读者在例子上遇到困境;旧路的短板用同一例子暴露
  • 翻译直指要义:不重述问题,重心是"转过弯之后怎么走"——方法、机制、关键 insight
  • 同例贯穿:翻译和核心概念都在「问题」那个例子上展开,读者一直待在同一个问题域里
  • 探索感:每段都给读者一个新视角,"啊原来如此"的小揭秘累积成对例子的深度理解
  • 有锚点:翻译部分锚点描述的是"方法在那个例子上的样子",后续道具围绕它生长
  • 带着推:读者能感受到"一步步想明白"的过程,而非接收打包好的结论
  • 外行能跟:不懂这个领域的聪明人听完能复述故事
  • 博导像博导:有判断力有分寸,最后一句判决
  • 视角句成立:「洞见」说出"原来还能从这个角度看 X",并给出这个角度的第二用途
  • 生活测见边界:「检验」有一个生活场景,既有命中也有破绽(测不了的明说,不硬测)
  • 押注能打脸:预测写成"X 条件下该看到 Y"——有条件、有可观察结果;推不出预测就直说
  • 启发能动手:启发部分的落点是"你可以___",不是"值得思考___";不与「检验」的注重复
  • 外行能复述五件事:困境与水位(具体到一个例子)/ 命题(作者敢押的那句话)/ 论证骨架(机制+证据,含反直觉副发现)/ 内核(带得走的视角)/ 检验(生活里哪儿站住哪儿破 + 押了什么注)。任一件让外行卡住 → 失败
  • title 双过:凝练自检三问 + 可识别性测试都过
  • 速读三档齐:一句话(平实可识别,不是 title 灵魂句)/ 大想法(和「洞见」同核、两个高度、不撞词)/ 只记三件事(重建故事的承重点,不是押注、不是清单)三件都在,像同一篇的三档变焦,不是三个零件
  • 速读是压出来的:三句在正文里都找得到根,写在最后、放在最前,不另起炉灶
  • 翻译节五件齐:承重类比 / 挂尺数字 / 反直觉副发现 / 论证骨架抽得出来 / 无原始公式
  • 核心概念 ≥ 3:包含一个"设计选择"概念(不止"组件")
  • 博导审稿见预设:方法成熟度一项里指出至少一个未被讨论的根本预设 / 隐忧,并把声称放回领域水位上称过
  • 零英文戏剧术语:protagonist / climax / resolution 这类不出现在输出

Related skills

FAQ

What does ljg-paper do?

Paper reader for non-academics. Reads a paper and tells it back as one continuous story — the life of the paper's core proposition (命题), told on a seven-beat spine (主角 / 困境 / 旧路 / 转折 / 解法 / 结局 / 内核): born in a bind on a

When should I invoke ljg-paper?

Paper reader for non-academics. Reads a paper and tells it back as one continuous story — the life of the paper's core proposition (命题), told on a seven-beat spine (主角 / 困境 / 旧路 / 转折 / 解法 / 结局 / 内核): born in a bind on a

Where is the source documentation?

Ground claims in SKILL.md excerpts and linked reference files from the cached docs.

Is Ljg Paper safe to install?

skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.