关于 digest-paper
digest-paper 是面向 SOTA 研究项目的论文整理技能,引导研究者通过 MCP 核验来源、通读全文并记录引文。其全有或全无规则可避免留下未完成的整理结果。
主要功能
- 01预检 MCP 服务能力
- 02解析论文身份与版本
- 03获取并通读 PDF 全文
- 04创建综述与 BibTeX 记录
- 05记录引文并更新索引
- 06运行项目校验
适用场景
- 01向现有 SOTA 添加论文
- 02整理前检查学术来源
- 03创建可追溯的论文综述
- 04校验已完成的论文记录
MCP 相关
需要 arxiv MCP 服务提供全文,并需要 semantic-scholar、dblp 或 openalex 中至少一个提供书目信息。技能还通过 MCP 查询引文和论文元数据;所需能力不可用时会停止。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ vincenzoimp/ academic-research-skills --skill digest-paper安装后在 Claude Code 中输入/digest-paper确认已加载。
附带文件references/bibliography-rules.md
详细介绍
论文摘要整理
将一篇论文从头到尾整理到 sota/papers/<citekey>/。这是 SOTA 工作的基本单元:要么完整完成,要么就不执行。绝不留下不完整的摘要整理结果。
首先阅读
sota/README.md— 综合分析格式和摘要整理规则(格式由脚手架规定)references/bibliography-rules.md— 引用键、版本判定、交叉验证
MCP 预检(硬性门槛)
在进行任何其他操作之前,分别用一个简单查询(例如搜索一个已知标题)测试学术 MCP 服务。门槛取决于能力,而非 API 密钥——缺少密钥只会限制功能,不会阻止操作:
- 必需:
arxiv(全文)必须响应,且至少一个文献来源——semantic-scholar、dblp或openalex——必须响应。 - 如果无法使用这些必需能力:停止,报告哪些服务失败,并请用户修复 MCP 配置。
- 如果某个可访问的来源不可用,但已达到门槛,则继续,并在综合分析中注明交叉核对有所减少。
绝不回退到模型记忆、网页搜索或抓取。只有 MCP 查询返回的引用才算存在。
流程
- 确认论文身份:根据给定的标题/DOI/arXiv/PDF,通过 semantic-scholar(计算机科学论文还要通过 dblp)查找论文。只有在匹配结果确实存在歧义时才询问用户。
- 确定最权威的版本:按
references/bibliography-rules.md,优先级为已发表版本 > 最新 arXiv 修订版 > 其他预印本。如果 DOI 和 arXiv id 都存在,则两者都记录。 - 选择引用键(
<firstauthor><year><topicword>,小写),并检查其尚未使用:references.bib中不存在,且没有sota/papers/<citekey>/文件夹。 - 创建
sota/papers/<citekey>/,并通过备用流程获取全文 PDF,优先选择最权威且合法的来源:(1) arXiv 论文使用 arxiv MCP;(2) 否则使用 paper-search,其备用来源依次为出版商/DOI 开放获取 → Unpaywall → 绿色开放获取仓库(Europe PMC/PMC、CORE、OpenAIRE、Zenodo、HAL、SSRN 等)→ Sci-Hub(最后手段)。 将最终 URL 记录到metadata.yaml(pdf_source)。PDF 仅用于阅读:引用和权威版本始终以学术 MCP 的结果为准(通过 DOI 对齐),与 PDF 的获取来源无关。如果连最后手段也无法获取,则停止、删除该文件夹,并在sota/queue.md中记录该候选论文,决策标记为unresolvable-via-mcp。禁止仅基于摘要进行整理。 - 阅读论文全文——从头到尾阅读 PDF,而不只是摘要。
- 按照
sota/README.md中准确的章节顺序编写synthesis.md。对照 PDF 核实每个精确数字和引文。 - 在
references.bib的 SOTA 部分写入 BibTeX 条目,字段须来自 MCP,并按照references/bibliography-rules.md进行交叉核对。绝不凭记忆填写字段。 - 通过 semantic-scholar 获取引用:被引文献和引用该论文的文献。选择相关条目,而非全部收录。根据
sota/README.md中的架构,在metadata.yaml中填写所有字段,包括必需的verified:块。对于已纳入 SOTA 的论文使用引用键,否则使用外部 id。 - 将一行追加到
sota/index.md,状态设为digested。 - 将
cites/cited_by和综合分析“Citation leads”部分中符合范围的线索作为pending条目添加到sota/queue.md,并注明来源。 - 从项目根目录运行
make check,并修复它报告的所有问题。
规则
- 要么全部完成,要么全部回退:如果任何步骤无法完成,则撤销不完整的文件夹,并在
queue.md中记录该论文。 - 一篇论文 = 一个文件夹 = 一个 Bib 条目 = 一个索引行(1:1:1)。
- 整理期间,对其他论文文件夹唯一允许的编辑,是在其
cites/cited_by列表中将外部 id 升级为引用键。
完成条件
sota/papers/<citekey>/中包含paper.pdf、synthesis.md、metadata.yamlreferences.bib和sota/index.md各新增一条条目make check通过
评论
支持 Markdown