paper-reading
Skill0 starsChanged 29 days agoMITView on GitHub
做读一篇文献并留下可复用笔记时用。单篇文献的日常精读——选什么读、读到什么程度、笔记怎么写、怎么回填成可复用的文献表。核心是「证据标签五态」([Paper]/[External]/[Analysis]/[Hypothesis]/[User])——把「原文说的」与「我推断的」在笔记里当场分开,从源头拦截「二手陈述当一手证据」。含三级阅读深度、定位方式三态(页码可靠/结构可靠/仅摘要)、笔记模板、15 列文献表回填与 P→A 段的搬运衔接。当用户说「精读」「读这篇」「这篇文献帮我看看」「文献笔记」「这篇讲了什么」「论文精读」「读文献」「文献表」,或拿到一篇 PDF/DOI/摘要要做结构化笔记时使用。即使用户只是丢一篇文献过来说「读一下」,只要要产出可复用的笔记,就应主动调用。与 literature-pipeline(A 段批量调研)互补:本 skill 管**单篇深读**,不替代它;与 nature-paper-card(16 模块卡)、nature-reader(中英对照)可配合,本 skill 管的是**本库的口径与回填**。
20 other projects use a version of this.
Adopted by
Most recently taken up by
- paratrooper-vincent/paper-readingtheir own version, first seen Nov 1, 2026
- xiaofengShi/paper-reading-skilltheir own version, first seen Oct 26, 2026
- jinxiy1104/Obsidian_Paper_Ingestion_Skilltheir own version, first seen Oct 20, 2026
- BH2-4/paper-craft-pipelinetheir own version, first seen Oct 20, 2026
- techdou/paper-readingtheir own version, first seen Oct 20, 2026
- Agentchengfeng/paper-reading-skillstheir own version, first seen Oct 20, 2026
Other versions20 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 20
- voidful/academic-skills★ 126same name
- jxtse/scientific-research-skills★ 68same name
- Immortalqx/my_codex_skills★ 54same name
- Agentchengfeng/paper-reading-skills★ 28same name
- Kingslayer-bot/paper-reading-skill★ 28same name
- a1henu/paper-reading-skill★ 11same name
- xiaofengShi/paper-reading-skill★ 11same name
- Shen-An/learn-skill★ 5same name
- techdou/paper-reading★ 5same name
- JinukMoon/agent-skills★ 4same name
10 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
Files
日常精读(P 段)
读什么
- 读一篇文献 → 本文件 §三级阅读深度;模板在
references/note-schema.md - 回填文献表 15 列 →
references/table-schema.md - 看写法样例 →
references/examples.md
本 skill 管什么
一篇文献,从「要不要读」到「读成能复用的笔记」。
P 段不占档——它是跨项目的常驻活动,为 A/B/C/D 各段共同供料。 它的价值在于把工作量前移:等真要写综述时,读过的文献已过人工筛选与理解, 对接 A2 时是搬运,不是重做。
选文献 → 读全文 → 写笔记 → 回填文献表
↓
文献精读/_文献表.xlsx(15 列)
↓ 按主题筛选 → 补「对本课题的意义」
A2 证据表(12 列)上下游接口
工序地图上本 skill 是 P 段(日常精读)。
上游给我什么
| 从哪来 | 交接物 | 具体是什么 |
| 课题本身 | 选题需求 | 读什么、读到什么程度。P 是本链起点 |
literature-pipeline | 待精读的文献集 | 检索筛出来的条目 |
我给下游什么
| 交给谁 | 交接物 | 下游拿它做什么 |
literature-pipeline | 文献表(15 列) | 作为证据表的上游,转成 12 列 |
转法与流程图见「五、对接 A 段(P → A2)」。
什么状态算交出去了
15 列填满。其中第 12 列「对本课题的意义」必须人工填——它需要课题上下文,不能由脚本推断,也不能由 AI 代填。
开工前确认(先做这一步)
读之前先问清四件事:读多深、为什么读、能拿到什么、要不要回填。用网页表单问完再读。
python scripts/confirm.py --spec references/confirm-spec.json \
--out <项目目录>/confirm_answers.json --intake <项目目录>/原料/每项答案的下游动作
表内每一行都得真的改变后续动作。改变不了的,从表单里删掉。
| 答案 | 下游动作 |
depth | 决定定位方式与可用的引用形式。扫读不得写页码,不得推断未见的方法与结果 |
purpose | 评估竞争文献时必写威胁评估;抄方法学模板时只看设计与统计 |
grounding | 只有摘要时按 source-limited 处理,引用写 [Paper: Abstract] |
backfill | 要回填时产出 15 列记录,前 11 列与证据表同名同序 |
deliverable | 决定停在判断、要点笔记还是完整笔记 |
外部工具:读的两条外挂(2026-10-19 已验证)
| 工具 | 干什么 | 什么时候用 |
nature-reader | 出中英对照全文:逐段对应、图表归位、参考文献照录 | 论文是英文且要逐段吃透时 |
nature-paper-card | 出 16 模块卡:结构化拆解,带 [Paper: PDF p.N] 页码指针 | 要做卡片式速览或与同领域横向对照时 |
分工:它们负责把原文读开;本 skill 负责定口径——证据标签五态、定位方式三态、笔记结构、文献表回填。它们产出的内容不能直接当笔记,必须过一遍标签。
已知限制(实测):
nature-paper-card的自动图表识别为 0——prepare_paper.py匹配不到 PDF 图注,卡片里的图与表要人工补。用前先核图表数量。nature-reader会把原文的缺陷标出来(拼写、语法、口径不一致),不要把这些标注当成自己的判断,它们属于[External]。
不用它们的场合:只有摘要、页码不可靠、或只想扫读。此时直接按三级深度自己读,别为了一张卡片去解析整份 PDF。
〇、⭐ 证据标签五态(本 skill 的核心)
笔记里每一条断言,都要标出它是哪一类。 标注每条断言的类别,就是把「原文说的」和「我推断的」 当场分开——本库代价最大的一类问题(把二手陈述当一手证据)就是从笔记里漏出去的。
| 标签 | 含义 | 必须带什么 |
[Paper] | 论文明确报告或声称的 | 定位(页 / 章 / 图 / 表 / 式) |
[External] | 论文以外的来源支持的 | 直接引用或链接 |
[Analysis] | 我从已识别证据推断的 | 推理 + 相关出处 |
[Hypothesis] | 可检验但未验证的解释或想法 | 提议的检验 + 可能证伪条件 |
[User] | 用户提供的判断或关联 | 用户原话或链到的知识 |
🔴 不标 = 默认是
[Paper],而「不标即当[Paper]」是最危险的默认。 一条你推断出来的话,混在一堆论文原话里,三个月后你自己分不出来。
为什么是五个而不是「原文 / 我说的」两个:
[Analysis] 可以是错的但有理据;[Hypothesis] 是还没验的;
[User] 是别人的判断。三者混成一类,日后就没法判断哪条能直接引、哪条要先验。
一、选什么读(判据)
⚠️ 不设「必读清单」——读什么由课题需要驱动,但选与不选要有判据, 不能凭「看着眼熟」。
该读的
| 信号 | 说明 |
| 竞争文献 | 同一个问题上别人也在做的——优先级最高 |
| 方法学模板 | 设计 / 范式 / 统计写得好、可照着做自己研究的 |
| 立论接口 | 能支撑你某个论点的关键证据 |
| 领域现状 | 权威综述 / 共识——只用于背景,不当作一手证据 |
不该读的(或只扫读)
| 信号 | 处置 |
| 只与主题沾边 | ❌ 不读 |
| 结论已被更新的研究取代 | ❌ 不读(除非要写「研究演变」) |
| 只能拿到摘要 | ⚠️ 可读,但必须标「仅摘要」(见 §二) |
| 二次转述 | ❌ 不读——追到原始文献 |
⚠️ P 段是拦截「二手陈述」的第一道关。 在 P 段读原文, 比在 A3 阶段再发现强得多。
二、读到什么程度(三级 + 定位方式)
| 级 | 读到哪 | 产出 |
| 扫读 | 标题 → 摘要 → 图表 → 结论 | 一句话 + 值不值得深读的判定 |
| 泛读 | 扫读 + 方法 + 结果 | 要点笔记 |
| 精读 | 全文逐段 + 批判性思考 | 完整笔记(见 §三) |
⭐ 定位方式三态——引用形式由源可靠性决定
读多深,决定你能写出什么形式的引用。 「读多深决定引用形式」不是风格问题,是不许越界:
| 态 | 条件 | 引用可以写成 |
| page-grounded | PDF 页码可靠 | [Paper: PDF p.3, Fig.2] |
| structure-grounded | 页码不可靠,但章节 / 图表 / 公式可靠 | [Paper: 方法·符号解析] [Paper: Fig.2] — 不写页码 |
| source-limited | 只有摘要 / 元数据 | [Paper: Abstract] — 不写页码,也不推断未见的方法与结果 |
🔴 「读的深度」要写进笔记,否则日后会把「只读了摘要」当成「读过全文」。
实测教训:某篇 SMART-CAT 研究全文未获取,笔记按 🟢摘要 / 🟡注册库 / 🟡方案论文 / 🟡院方通稿 四源交叉并逐条标来源等级。 四源交叉并逐条标来源等级,应成为惯例。
深度 → 能支撑什么(超出即越界):
| 读到 | 能支撑 | 不能支撑 |
| 仅标题 | ❌ 几乎不能 | 任何实质断言 |
| 仅摘要 | 作者自述的结论 | 方法细节、局限、亚组 |
| 全文 | 精确范围与条件 | (仍需判语境:待检证据是否真的支持对应论断) |
三、笔记怎么写
3.1 命名
<项目名>/精读笔记_<第一作者><年份>_<主题>.md3.2 结构
完整模板与逐字段说明见 references/note-schema.md。
骨架:
## <论文标题>
**PMID / DOI / 年份 / 期刊**(用英文原名)
**标签**:#主题 #方法 #人群
**阅读深度**:全文 / 摘要 / 前三页
**定位方式**:page-grounded / structure-grounded / source-limited
### 一句话结论
### 研究设计 设计类型 / 样本 / 干预或暴露 / 主要结局
### 关键结果 指标 | 效应量 | 95%CI/P ← 每个数字带 [Paper: <定位>]
### 方法亮点与局限
### 与本项目的关联
### 可引用的关键句3.3 三条硬规则
① 每个数字必须能指向原文的具体位置。 指不出 → 不能写成断言。
② 转述必须回读完整段落,尤其「作者说…」这类归因句。
实测教训:局限性段落的开头讲样本量小,后半段才写着 "limiting the usefulness of this model"——只读前半段会误判。
③ 竞争文献要写「威胁评估」——不只是笔记,要回答: 它做到了什么、没做到什么、我们的差异在哪。
四、回填文献表
4.1 真源与生成物
_文献表.json ← 真源(日常追加它)
_文献表.xlsx / .md ← 生成物(15 列)4.2 15 列 = 11 对齐 + 4 管理
| # | 列 | 备注 |
| 1–11 | 文献·DOI / 作者·年份 / 研究设计 / 人群(P) / 干预暴露(I/E) / 对照(C) / 主要结局(O) / 关键结果 / 局限 / 期刊 IF / 期刊分区 | 与证据表前 11 列同名同序 |
| 12–15 | 主题标签 / 精读状态 / 笔记链接 / 入库日期 | 管理列 |
⭐ 前 11 列与证据表对齐,是 P 段设计的核心——对接 A2 时只需补第 12 列 「对本课题的意义」+ 按叙事重组,不是重做。
列定义、质量线与回填流程见 references/table-schema.md。
4.3 质量线(必须守,否则对接时仍返工)
- 「关键结果」回全文核对——摘要常不载样本量与效应量,而精读的价值恰在于有全文
- 「人群」列填全样本量
- IF 用官方 JCR 值并标年份:
6.6 (2025 JCR) - 分区写「中科院(标版本)+ JCR」:
中科院医学2区(2025) / JCR Q1——不写口径等于没写 - 中文刊 / 预印本 / 新刊查不到 → 允许留空,不硬填
精读状态取值:⬜未读 / 🔄在读 / ✅已精读 / 📝笔记完成
五、对接 A 段(P → A2)
文献表.xlsx(15 列)
│ ① 按「主题标签」筛选相关条目
│ ② 补第 12 列「对本课题的意义」
│ ③ 按叙事分区组织 → 模块X_evidence.json
│ ④ build_evtab.py --data 模块X_evidence.json --module 模块X
▼
证据表_模块X.xlsx(12 列)⚠️ 第 ② 步必须人工——「对本课题的意义」需要课题上下文, 不能由脚本推断,也不能由 AI 代填(补「对本课题的意义」是判断,不是搬运)。
Anti-Patterns
- Never 在笔记里混写「论文说的」与「我推断的」而不加标签——不标就等于把推断混作原文
- Never 用
[Paper]标注一条实际是推断的话 - Never 在
source-limited(仅摘要)下写出方法细节或亚组结果——属于编造 - Never 在
structure-grounded下写页码引用——页码不可靠就不写页码 - Never 把「只读了摘要」在笔记里记成「读过全文」
- Never 读二次转述而不追原文——P 段是拦截二手转述的第一道关
- Never 让「关键结果」列停在摘要——摘要常不载效应量与样本量
- Never 没写「对本课题的意义」就对接 A2——写「对本课题的意义」是人工判断,脚本与 AI 都不代填
- Never 因影响力低就跳过对本课题关键的文献
脚本
随包自带(运行版;开发版与测试在 research-workflow 的 scripts/):
| 脚本 | 干什么 |
scripts/build_daily_ref.py | 由 _文献表.json 生成 15 列 _文献表.xlsx / .md |
scripts/check_note.py | 笔记机检:必备字段齐 / 断言带证据标签 / 定位方式与引用形式一致 |
scripts/check_skill_structure.py · scripts/selfcheck.py | skill 自检 |
脚本只做可自动化的部分。「这条推断合不合理」「这篇值不值得读」——脚本答不了。
参考文件
| 文件 | 何时读 |
references/note-schema.md | 写笔记时——完整模板、五态标签细则、定位方式、示例 |
references/table-schema.md | 回填时——15 列定义、质量线、真源与生成物、对接 A2 流程 |
references/examples.md | 正反样例:一份完整笔记(坏 vs 好,含「读摘要却写出 r 与 p」这类越界)、标签误用五组、定位方式三种越界、文献表一行对照 |
来源与署名
方法整理自作者 2026-09 的精读手册与真实项目沉淀(含 SMART-CAT 四源交叉的实测教训)。
其中两处设计取自本机已装的第三方 skill,按其思路重写、未照搬文本:
| 内容 | 来源 |
证据标签五态([Paper]/[External]/[Analysis]/[Hypothesis]/[User]) | nature-paper-card |
| 定位方式三态(page-grounded / structure-grounded / source-limited) | nature-paper-card |
只取方法与结构,未照搬文本——来源未声明许可,故按本库口径重写。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

