菜单
一键导入论文：从标题/DOI/链接/模糊描述开始，自动走完 resolve → acquire → repo 管线。 当用户说"导入这篇论文"、"帮我把这篇论文弄下来"、"下载这篇论文"、 "把这篇论文弄到本地"、"帮我搞定这篇论文"时触发。 覆盖从搜索到下载到找代码的全流程。如果用户只需要搜索/确认论文身份， 不需要下载，应使用 paper-search skill。 三步默认全部执行：确定论文 → 获取 PDF+markdown → 找代码仓库。 用 --no-acquire 跳过下载，--no-repo 跳过代码搜索。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/huangyrcn/paper-skills --skill paper-import命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
搜索论文并解析论文身份，生成结构化 metadata.yaml。 当用户要搜论文、找文献、确认论文身份（标题/DOI/arXiv ID/URL）、 查论文信息、做论文 metadata 时触发。 不负责下载 PDF 或转 markdown（那是 paper-acquire 的工作）。 覆盖 20+ 学术源（arXiv、PubMed、Semantic Scholar、Crossref、OpenAlex、DBLP、Unpaywall 等）。 如果用户想要"导入论文"（全流程），应使用 paper-import skill。 如果用户只要"下载论文"或"获取 PDF"，应使用 paper-acquire skill。
获取论文原文：下载 PDF 并转成结构化 markdown。 当用户要求下载论文、获取 PDF、把论文转成 markdown 时触发。 也作为 paper-search 的下游自动步骤——确定了论文身份后自动获取原文。
找论文的代码仓库。 当用户问"代码在哪"、"有没有实现"、"帮我找 repo"、 "官方代码"、"复现"、"复现代码"、"开源实现"、 "开源代码"、"GitHub 地址"时触发。 验证仓库真实性后自动 clone。
| name | paper-import |
| description | 一键导入论文：从标题/DOI/链接/模糊描述开始，自动走完 resolve → acquire → repo 管线。 当用户说"导入这篇论文"、"帮我把这篇论文弄下来"、"下载这篇论文"、 "把这篇论文弄到本地"、"帮我搞定这篇论文"时触发。 覆盖从搜索到下载到找代码的全流程。如果用户只需要搜索/确认论文身份， 不需要下载，应使用 paper-search skill。 三步默认全部执行：确定论文 → 获取 PDF+markdown → 找代码仓库。 用 --no-acquire 跳过下载，--no-repo 跳过代码搜索。 |
| argument-hint | <论文引用> [--no-acquire] [--no-repo] |
一键导入论文。编排 resolve → acquire → repo 管线。
This skill is an orchestrator. It owns:
$PAPERS_DIR/{folder_slug}/This skill does not own any artifacts directly. All work is delegated:
paper-searchpaper-acquirepaper-repo用户输入（标题/DOI/链接/模糊描述）
│
▼
Step 0: 解析 PAPERS_DIR（环境变量 → 实际路径）
│
▼
Step 1: 快速去重（目录名匹配 → 身份验证 → 产出验证 → 结构修复）
│
├── 身份匹配 + 产出完整？──→ 报告"已导入"，结束
├── 身份匹配 + 部分缺失？──→ 只执行缺失的步骤
│
▼
Step 2: paper-search（确定论文身份）
│
▼ 生成 metadata.yaml
│
├── 用户传了 --no-acquire? ──→ 跳到 Step 4
│
▼
Step 3: paper-acquire（下载 PDF + 转 markdown）
│
├── 用户传了 --no-repo? ──→ 结束
│
▼
Step 4: paper-repo（搜索并 clone 代码仓库）
# 全套：确定 + 下载 + 找代码（默认行为）
paper-import "Attention Is All You Need"
# 只确定论文身份，不下载
paper-import "GAT" --no-acquire
# 确定 + 下载，不找代码
paper-import "10.48550/arxiv.2002.05287" --no-repo
| 参数 | 说明 | 默认 |
|---|---|---|
| 第一个参数 | 论文引用（标题/DOI/arXiv/URL/模糊描述） | 必填 |
--no-acquire | 跳过 PDF 下载和 markdown 转换 | 不跳过 |
--no-repo | 跳过代码仓库搜索 | 不跳过（默认执行） |
$PAPERS_DIR 是环境变量（plugin settings 或系统环境变量），需要先解析为实际路径。解析方式不限，拿到路径即可。
拿到结果后（如 Y:\papers），后续步骤直接用这个路径，不要再重复解析。
拿到 $PAPERS_DIR 实际路径后，立即检查已导入的论文：
1a — 目录名匹配（快速粗筛）：
列出 $PAPERS_DIR 下所有文件夹名，查找包含论文关键词的 folder_slug（如 iclr2026-mf-gia-zhuo 包含 mf-gia）。
如果目录名没匹配到，用 Grep tool 搜 */metadata.yaml 的 title 字段兜底。
1b — 身份验证（确认是同一篇论文）：
读取匹配到的 metadata.yaml，验证：
identity.aliases 中的 arXiv ID / DOI 与用户输入一致（如有）bibliography.title 与用户查询的论文标题匹配如果身份不匹配（同名不同论文），视为未找到，继续 Step 2。
1c — 产出验证（确认文件确实属于这篇论文）：
身份确认后，验证实际产出：
paper/paper.pdf：存在且 >1KB。如果 hydrate_raw.py 的 _verify_pdf_identity() 可用，用它验证 PDF 第一页标题与 metadata 一致paper/paper.md：存在且 >500 字符repo/：存在且非空。检查 repo_search.selected.url 与实际 clone 的 remote 一致1d — 结构修复（metadata 损坏时修复，不重跑）：
如果 metadata.yaml 有结构问题（如 legacy 字段嵌套在错误的层级、schema 外的字段），直接修复 YAML 结构，而不是重新跑 paper-search 管线。论文数据已经存在，只是元数据格式有误。
判断结果：
调用 paper-search skill。
$PAPERS_DIR/{folder_slug}/metadata.yaml除非用户传了 --no-acquire，否则调用 paper-acquire skill。
先检查本地是否已存在：如果 $PAPERS_DIR/{folder_slug}/paper/paper.pdf 已存在（文件 >1KB），跳过下载；如果 paper.md 也已存在，跳过整个 acquire 步骤并告知用户。
$PAPERS_DIR/{folder_slug}/metadata.yaml$PAPERS_DIR/{folder_slug}/paper/paper.pdf + paper.md除非用户传了 --no-repo，否则调用 paper-repo skill。
先检查本地是否已存在：如果 $PAPERS_DIR/{folder_slug}/repo/ 已存在（目录非空），跳过整个 repo 步骤并告知用户。
$PAPERS_DIR/{folder_slug}/metadata.yamlrepo/，搜索结果写入 metadata.yaml完成后，$PAPERS_DIR/{folder_slug}/ 下应有：
{folder_slug}/
metadata.yaml ← resolve 产出（始终有）
paper/
paper.pdf ← acquire 产出（除非 --no-acquire）
paper.md ← acquire 产出（除非 --no-acquire）
paper_images/ ← acquire 产出（如果 PDF 含图片）
repo/ ← repo 产出（除非 --no-repo）