agentleFS
BH2-4BH2-4/paper-craft-pipeline/skills/paper-reading/SKILL.md

paper-reading

Skill1 starsChanged 3 months agoApache-2.0View on GitHub

研究论文阅读 Skill。将研究论文转化为清晰、决策导向的笔记:按用户阅读目标在 6 种模式(速读 / 精读 / 对比 / 文献图谱 / 复现备忘 / HTML 阅读页)中选择合适输出,并以 6 种分析视角(方法 / 基准数据集 / 系统 / 评测质量 / 可复现性 / 迁移)判定哪些点真正值得记,最终给出可支撑后续动作(继续读 / 借鉴 / 复现 / 忽略)的结构化笔记。

20 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Paper Reading

研究论文阅读 Skill,定位:把一篇或多篇研究论文转化为决策导向笔记——不是复述论文,而是帮用户判断"这篇论文对我意味着什么、下一步该做什么"。

核心约束:

  • 决策导向:每份笔记必须落到一个明确的下一步动作(继续精读 / 只记概念 / 看基线 / 复现 / 借鉴 / 忽略)。
  • 以视角定重点:不在每个维度平均用力,按论文类型和用户目标选择分析视角。
  • 忠于原文 + 显式推断:直接 claim 与读者的推断/质疑要可视区分。

When to Activate

触发条件:

  • 用户提供论文(PDF / Markdown / HTML / URL / 截图)要求阅读、做笔记、总结
  • 用户说"帮我看看这篇"、"读一下"、"这篇值不值得读"、"做个笔记"
  • 用户给多篇论文要求对比、做 mini-survey、文献综述入门
  • 用户问"这篇能不能复现"、"我要不要借鉴这个方法"、"复现风险在哪"
  • 用户要求把论文做成可视化阅读页 / 网页版笔记

不应触发:

  • 用户自己写论文 → 交给 copilot / paper-enhance
  • 用户要求排版 / 格式化已写好的文稿 → 交给 formatter
  • 仅查某个事实性信息(如"这篇用的什么数据集")→ 直接回答即可,不必走完整 Skill

Workflow

输入论文 → 1. 澄清阅读目标 → 2. 选模式 → 3. 选视角 → 4. 产出笔记 → 5. 给决策动作
  1. 澄清阅读目标:若用户未明说,先判断目标——triage?深度理解?对比选型?调研入门?复现?做成可分享页面?目标不明时主动问一句,不要默认走 Deep Read。
  2. 选模式:从下方 6 种模式中选最轻量且匹配目标的一种。默认从 Quick Read 开始,按需升级。
  3. 选视角:根据论文类型(方法 / 基准 / 系统)和用户目标(理解 / 复现 / 迁移)挑选 2–3 个分析视角深读,其余视角轻量带过。
  4. 产出笔记:按模式对应模板输出(见 references/output-formats.md)。
  5. 给决策动作:每份笔记结尾必须给"建议动作",落到可执行的一步。

6 种阅读模式

模式即输出形态。详细模板见 references/output-formats.md,此处给出选型摘要。

#模式适用场景核心产出
1Quick Readtriage、第一遍、判断"值不值得看"一句话判断 + 核心内容 + 最大疑点 + 建议动作
2Deep Read用户要完整拆解一篇论文定位 + 贡献拆解 + 方法机制 + 关键图解 + 实验证据 + 我的判断 + 对用户的价值
3Comparison Read用户给多篇论文对比表 → 关键差异 → 主参考 → 组合阅读顺序
4Literature Seed Mapmini-survey、新主题入门主题切分 + 代表论文 + 推荐阅读顺序 + 当前空白
5Reproduction Memo用户关心实现价值,不只是理解复现目标 + 必需资源 + 高风险缺口 + 图里藏什么 + 实施路径 + 预期难度
6HTML Reading Page用户要可视化阅读产物Hero / Problem / Method / Evidence / Limits / Decision 六段式页面

选型原则:

  • 用最轻量的模式匹配需求,不要默认全量拆解。
  • 模式之间可组合:例如先 Quick Read 多篇 →筛出主参考→ 对主参考做 Deep Read 或 Reproduction Memo。

6 种分析视角

视角决定"读的时候看什么、信什么、疑什么"。不要对每篇论文都套全部视角,按论文类型和用户目标挑选。详见 references/reading-lenses.md。

视角适用论文关键提问(摘要)
Method Paper Lens提出新方法 / 新框架真正新的成分是什么?ablation 是否隔离了新成分?增益是否跨场景稳定?
Benchmark / Dataset Paper Lens提出新基准 / 新数据集测的是真实能力还是构造产物?标注是否有泄漏?分数是否与下游价值相关?
System Paper Lens系统型论文系统贡献在哪?是否讨论了成本 / 延迟 / 可靠性?失败处理是否暴露?
Evaluation Quality Lens任何带实验的论文(必查)baseline 是否忠实复现?指标是否合适?增益是否可被额外数据/工具/调参解释?
Reproducibility Lens用户有意复现数据/预处理/prompt/语料/工具 API/超参/模型版本/算力/评测脚本 是否齐全?缺 2 项以上则精确复现可疑。
Transfer Lens用户想用于真实项目论文假设哪些在用户环境成立?增益是否抵得过复杂度?哪些可直接借鉴、需简化、需先验证?

视角 → 模式映射建议(非强制):

  • Quick Read / Deep Read → Method / Benchmark / System Lens + Evaluation Quality
  • Comparison Read → 按 paper 类型各自挑 lens,但 Evaluation Quality 必查以公平对比
  • Reproduction Memo → Reproducibility Lens + Transfer Lens
  • Literature Seed Map → 弱化 lens,重主题切分与脉络
  • HTML Reading Page → 沿用所选模式对应的 lens,但呈现重点在视觉

通用规则(所有模式适用)

Evidence Markers(证据标记)

关键陈述旁按需打标,让读者知道"这是论文说的还是我推的":

  • 论文明确说明 — 原文直接 claim
  • 合理推断 — 基于原文的推断
  • 论文未说明 — 重要但原文缺失的点

复现备忘与批判性段落里尤其要用,但不要泛用。

Figure Analysis Rule(图表分析规则)

凡提到论文中的图/表,不能只引用编号,必须说明三点:

  1. 这张图表里有什么
  2. 作者想用它证明什么
  3. 它是否真的支撑了那个论点

HTML Reading Page 额外要求:

  • 关键 Figure / Table 尽量直接展示论文原图,而非仅文字描述
  • 优先高分辨率区域裁图,不默认整页截图
  • 尽量保留原始 caption;图与 caption 分开时页面里要明确补上

决策动作(强制收尾)

每份笔记必须以可执行的下一步收尾,至少给出一个动作。可选动作词汇:

  • 继续精读 / 升级到 Deep Read
  • 只记概念,不必深挖
  • 看基线 / 看附录
  • 进入 Reproduction Memo
  • 借鉴某机制 / 忽略整篇
  • 组合阅读顺序中的下一篇

References

  • references/output-formats.md — 6 种模式的完整模板与字段定义
  • references/reading-lenses.md — 6 种分析视角的完整提问清单与红旗信号

模式与视角的具体提问、红旗、字段一律以 references 为准;本 SKILL.md 仅做选型与编排,不重复定义细节。

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.