菜单
PDF 转高质量 markdown，支持公式、表格、混合排版。 当用户要求 PDF 转 markdown、提取论文文本、OCR 提取时触发。 注意：paper-acquire 内部会调用它，不需要单独触发。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
一键导入论文：从标题/DOI/链接/模糊描述开始，自动走完 resolve → acquire → repo 管线。 当用户说"导入这篇论文"、"帮我把这篇论文弄下来"、"下载这篇论文"、 "把这篇论文弄到本地"、"帮我搞定这篇论文"时触发。 覆盖从搜索到下载到找代码的全流程。如果用户只需要搜索/确认论文身份， 不需要下载，应使用 paper-search skill。 三步默认全部执行：确定论文 → 获取 PDF+markdown → 找代码仓库。 用 --no-acquire 跳过下载，--no-repo 跳过代码搜索。
搜索论文并解析论文身份，生成结构化 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。
把一篇论文拆解成结构化研究卡片。 当用户说"做个卡片"、"写阅读笔记"、"总结这篇论文"、 "帮我读一下"、"结构化分析"、"拆解论文"时触发。 输出 card.md（快速概览）和 card-deep.md（深度分析）。
| name | pdf-to-md |
| description | PDF 转高质量 markdown，支持公式、表格、混合排版。 当用户要求 PDF 转 markdown、提取论文文本、OCR 提取时触发。 注意：paper-acquire 内部会调用它，不需要单独触发。 |
| argument-hint | <pdf_path> [-l lang] |
This skill owns:
<pdf_stem>.md and <pdf_stem>_images/This skill does not:
paper-acquire)paper-search)paper-card)| 优先级 | 后端 | 需要 | 质量 |
|---|---|---|---|
| 1 | MinerU API (VLM) | MINERU_API_TOKEN | 最高（公式/表格/混合排版） |
| 2 | marker (本地) | uv tool install marker-pdf | 高（本地推理，无需 API） |
hydrate_raw.py 自动按优先级尝试：有 token 用 MinerU，没有则 fallback 到 marker。
# MinerU API（需要 MINERU_API_TOKEN）
uv run --script "${SKILL_DIR}/scripts/mineru-api.py" <pdf_path> [-l lang]
# marker 本地（不需要 token）
marker <pdf_path> --output_dir <output_dir>
paper.pdf → paper.md and paper_images/| Condition | Behavior |
|---|---|
MINERU_API_TOKEN not set | 自动 fallback 到 marker |
| MinerU API 返回 401/403 | Token 无效，fallback 到 marker |
| marker 未安装 | 报错，提示 uv tool install marker-pdf |
| 两个后端都失败 | 报错，列出所有失败原因 |
在调用 hydrate_raw.py 之前，agent 应检查转换能力是否就绪：
MINERU_API_TOKEN → 直接使用 MinerU APImarker 是否可用（which marker）uv tool install marker-pdf，而非等脚本报错这样用户无需手动干预，管线可以自动降级运行。