agentleFS
crce-uxcrce-ux/paper-reading/SKILL.md

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

The file

Files
SKILL.md

日常精读(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-groundedPDF 页码可靠[Paper: PDF p.3, Fig.2]
structure-grounded页码不可靠,但章节 / 图表 / 公式可靠[Paper: 方法·符号解析] [Paper: Fig.2] — 不写页码
source-limited只有摘要 / 元数据[Paper: Abstract] — 不写页码,也不推断未见的方法与结果

🔴 「读的深度」要写进笔记,否则日后会把「只读了摘要」当成「读过全文」。

实测教训:某篇 SMART-CAT 研究全文未获取,笔记按 🟢摘要 / 🟡注册库 / 🟡方案论文 / 🟡院方通稿 四源交叉并逐条标来源等级。 四源交叉并逐条标来源等级,应成为惯例。

深度 → 能支撑什么(超出即越界):

读到能支撑不能支撑
仅标题❌ 几乎不能任何实质断言
仅摘要作者自述的结论方法细节、局限、亚组
全文精确范围与条件(仍需判语境:待检证据是否真的支持对应论断)

三、笔记怎么写

3.1 命名

<项目名>/精读笔记_<第一作者><年份>_<主题>.md

3.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.pyskill 自检

脚本只做可自动化的部分。「这条推断合不合理」「这篇值不值得读」——脚本答不了。


参考文件

文件何时读
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

只取方法与结构,未照搬文本——来源未声明许可,故按本库口径重写。

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.