# Ljg Paper

Explain research papers to readers without a specialist background: what the paper...

- Repository: https://github.com/lijigang/ljg-skills (7607 stars)
- Category: Documents
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add lijigang/ljg-skills --skill ljg-paper -g -a claude-code -y`
Codex: `npx skills add lijigang/ljg-skills --skill ljg-paper -g -a codex -y`
Cursor: `npx skills add lijigang/ljg-skills --skill ljg-paper -g -a cursor -y`
Gemini CLI: `npx skills add lijigang/ljg-skills --skill ljg-paper -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add lijigang/ljg-skills`

## Description

Explain research papers to readers without a specialist background: what the paper studies, what the authors contribute, how the findings follow, and what the evidence does not establish. USE WHEN the user shares an arXiv link, paper URL, PDF, local paper, or paper title, or asks to read, explain, analyze, or understand a paper. Defaults to a saved Markdown note. NOT FOR reproduction, formal peer review, benchmark tables, or literature surveys.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# ljg-paper：讲清论文，让读者理解结论是怎样得来的

默认读者有一般生活经验和理解能力，但不熟悉论文所属行业，也不知道该行业常用的对象、工具和工作方式。用户指定了读者背景时，以其指定为准。

从读者能够直接理解的事情出发，讲清谁在什么条件下做了什么、为什么遇到困难、作者改变了哪个环节，以及结果怎样变化。专业名称在有助于识别论文贡献时引入；读者在记住名称之前，应已理解它指向的事情。

读者最终既能用普通话解释论文的思想，也能说清作者实际研究了什么、做出了什么贡献。生活案例承担解释时，应明确对应论文中的角色与关系，并区分假想示例和真实实验。

全文围绕论文能够支持的具体问题，让读者看见问题为何需要解决、原有判断有何依据，以及证据怎样支持新的判断。具体对象和动作应持续承担解释；随着解释深入，可以更换案例或场景，但要交代它补充了什么。现场感来自与理解有关的细节，不靠虚构心理或夸大结论。

完整的解释应给读者留下亲自解释或迁移的空间。文章写出了判断重构的过程，仍不能证明读者实际经历了这一过程。依据论文组织解释，允许补充、确认、区分和保留未知，不强求反转、统一机制或固定四段结构；默认完整交付，互动按用户意愿进行。

当关键关系需要读者在脑中自行拼装时，优先考虑 ASCII 图来呈现信息流向、前后状态或不同维度，再沿具体例子读图。是否用图、用几幅，由它能否减少理解负担决定，不固定故事或图数。

## Workflow Routing

| 输入 | 必读材料 | 输出 |
|---|---|---|
| arXiv、PDF、论文链接、本地论文 | `ReadingGuide.md`、`references/template.org`、`references/paper-map.md` | 一份 Org 解读笔记和一份 paper-map 研究记录 |
| 只有论文标题 | 找到可靠原文后，读同一组文件 | Org 笔记和 paper-map |
| 明确只要口头解释 | `ReadingGuide.md` | 直接解释，不保存文件；仍满足下面三个目标 |

Org 默认保存到 `~/Context/`。文件名沿用 Denote：`{YYYYMMDDTHHMMSS}--paper-{方法名或论文关键词}__paper.org`；时间戳由 `date +%Y%m%dT%H%M%S` 生成。改写已有笔记时，保留原文件与 identifier，核对原文，不另建重复笔记。

## 解读要达到的三个目标

- **说清论文做了什么。** 读者能说出研究问题、作者的主要贡献、方法或关系如何起作用，以及关键证据的适用范围。读到前两节时，就应知道论文在研究什么、作者做了什么。论文中不可省略的研究问题也要有所交代。
- **让读者理解证据怎样调整或巩固判断。** 从具体问题出发，说明一种有依据的理解，再用论文证据展示它哪里仍然成立、哪里需要补充或修正。结尾交代现在能够怎样判断、还有什么无法确定；确认原有认识也可以构成收获，无须制造戏剧性的反转。
- **让读者能够自己解释结果。** 如果论文提出了能解释多个发现的机制，读者应能用它说明至少两个不同发现，并推想改变相关条件后会发生什么。区分论文验证过的结论与依据机制作出的预测。论文没有统一解释时，如实说明各项发现之间的关系和仍未解决的问题。

三个目标分别检查。讲得流畅、内容准确、能够解释结果，各有要求，不能相互替代。

## 容易出错的地方

The rest: https://github.com/lijigang/ljg-skills/blob/HEAD/skills/ljg-paper/SKILL.md