用途
digest-paper 是 SOTA（State of the Art）学术研究工作中的原子单元，用于将单篇论文完整地消化进 sota/papers/<citekey>/ 目录。它要么完整完成，要么不发生，绝不留下部分消化的结果。
主要能力
- 从标题、DOI、arXiv id、URL 或 PDF 解析论文身份。
- 确定最权威版本：已发表会议/期刊 > 最新 arXiv 修订版 > 其他预印本，并同时记录 DOI 与 arXiv id（若两者都存在）。
- 生成 citekey（格式为 <firstauthor><year><topicword>，小写），并检查其未被使用。
- 创建论文文件夹并获取全文 PDF 作为 paper.pdf，采用回退管线（优先最权威/合法来源）：arXiv 论文用 arxiv MCP；否则用 paper-search，依次回退到出版商/DOI 开放获取、Unpaywall、绿色开放获取仓库（Europe PMC/PMC、CORE、OpenAIRE、Zenodo、HAL、SSRN 等），Sci-Hub 作为最后手段。
- 通读全文 PDF（封面到封底，而非仅摘要）。
- 按 sota/README.md 中规定的章节顺序撰写 synthesis.md，并对照 PDF 核实每个确切数字与引文。
- 将 BibTeX 条目写入 references.bib 的 SOTA 部分，字段来自 MCP 来源并交叉验证，绝不凭记忆填写。
- 通过 semantic-scholar 获取出向参考文献与入向引用，选择相关条目。
- 写入 metadata.yaml，包含 sota/README.md 中 schema 的所有字段，包括必需的 verified: 块。
- 在 sota/index.md 追加一行，状态为 digested。
- 将 cites/cited_by 及综述中“Citation leads”部分的相关线索以 pending 状态加入 sota/queue.md，并附来源信息。
- 从项目根目录运行 make check 并修复报告的问题。
使用方式
该技能通过 MCP 预检（硬性门槛）启动：先用一个简单查询探测学术类 MCP 服务器。要求 arxiv（全文）必须响应，且至少一个文献来源（semantic-scholar、dblp 或 openalex）必须响应。若必需能力不可用，则停止并报告失败的服务器，要求用户修复 MCP 设置。若可达来源暂时宕机但门槛已满足，则继续并在综述中注明交叉检查减少。绝不回退到模型记忆、网络搜索或抓取；引用只有在 MCP 查询产生时才存在。
适用场景
适用于学术研究知识库（SOTA）的构建与维护，将单篇论文系统化地纳入结构化知识体系，产出可追溯的综述、元数据与参考文献条目。
限制
- 全有或全无：任一步骤无法完成，则回退部分文件夹并将论文记录到 queue.md。
- 一篇论文 = 一个文件夹 = 一个 BibTeX 条目 = 一个索引行（1:1:1）。
- 消化过程中，对其他论文文件夹唯一允许的编辑是将外部 id 升级为 citekey。
- 禁止仅凭摘要消化。
- 若最后手段也无法获取 PDF，则停止、删除文件夹，并将候选记录到 sota/queue.md，决策为 unresolvable-via-mcp。
- 完成条件：sota/papers/<citekey>/ 包含 paper.pdf、synthesis.md、metadata.yaml；references.bib 与 sota/index.md 各新增恰好一个条目；make check 通过。