arXiv Research Skill 是一个面向 arXiv 平台的学术研究工作流工具集，通过四项能力构成“连接—理解—证据”的知识构建循环（connect -> understand -> evidence），对应流程为“查找—理解—引用”，并附带用于从 LaTeX 源码提取图表的 tikz 能力。
【安装】 安装依赖命令：uv sync
【主要能力】
一、Connect（知识导航）：跨 arXiv 查找相关论文、探索引用网络、发现相关研究。支持的检索与探索方式包括：
- 关键词检索，可附加筛选条件： uv run python scripts/connect.py search "transformer attention mechanism" --category cs.LG --limit 20 uv run python scripts/connect.py search "LLM agents" --since 2023-01 --until 2024-06 uv run python scripts/connect.py search "topic" --with-citations --sort citations
- 发现相关工作： uv run python scripts/connect.py similar "2301.00001" --limit 10 uv run python scripts/connect.py recent cs.AI --days 7 uv run python scripts/connect.py by-author "Yann LeCun"
- 引用网络： uv run python scripts/connect.py cited-by "2301.00001" --limit 20 uv run python scripts/connect.py coauthors "Yann LeCun" --limit 20
- 获取论文全文内容（单篇或批量）： uv run python scripts/connect.py content "2301.00001" uv run python scripts/connect.py content "2301.00001,2302.00002,2303.00003"
二、Understand（含义提取）：使用结构化提示词分析论文内容，可将 connect.py content 的输出通过管道传入分析脚本： uv run python scripts/connect.py content "2301.00001" | uv run python scripts/understand.py analyze quick 可用提示词（可通过 uv run python scripts/understand.py list 查看）及其用途：
- quick：快速结构化摘要
- methodology：详细方法提取
- contribution：识别并排序贡献
- critical：优缺点分析
- compare：多论文对比表
- literature：组织用于文献综述
- implementation：提取复现细节
- evidence：评估作为某论点的证据
三、Evidence（来源归属）：生成多种格式的引用并导出供文献管理器使用： uv run python scripts/evidence.py bibtex "2301.00001" uv run python scripts/evidence.py apa "2301.00001" uv run python scripts/evidence.py ris "2301.00001" # 用于 Zotero/Mendeley/EndNote uv run python scripts/evidence.py batch "id1,id2,id3" --format bibtex > refs.bib uv run python scripts/evidence.py batch "id1,id2" --format ris > refs.ris 支持的格式：bibtex、apa、ieee、acm、chicago、ris
四、TikZ（图表提取）：从 arXiv 论文的 LaTeX 源码中提取 TikZ 源代码，支持 tikzpicture、tikzcd、circuitikz 和 pgfplots 环境，并捕获标题（captions）、标签（labels）和库依赖（library dependencies）： uv run python scripts/tikz.py extract "2301.00001" # 纯 TikZ 代码 uv run python scripts/tikz.py extract "2301.00001" --format latex > fig.tex # 可编译的 LaTeX uv run python scripts/tikz.py extract "2301.00001,2302.00002" --format json # 批量输出为 JSON uv run python scripts/tikz.py list "2301.00001" # 仅摘要 输出格式：tikz（默认）、latex、json、brief
【工作流模式】 多步骤配方（例如文献综述、为某论点寻找证据）参见 references/workflows.md。
【API 依赖】
- arXiv：用于论文检索与内容，速率限制 1 请求/3 秒，无需 API Key
- Semantic Scholar：用于引用与相似论文，速率限制 100 请求/5 分钟，API Key 可选（可提高限额）
- Jina Reader：用于全文提取，速率限制宽松，无需 API Key 脚本会在每次请求之间按服务强制设置固定延迟。失败时没有自动重试——遇到 429 或网络错误会返回空结果而非重试。
【错误处理】
- 触发速率限制：请求将返回空结果，不会重试；请等待后重新运行
- 未找到论文：请核对 arXiv ID 格式（YYMM.NNNNN）
- 无引用信息：论文可能过新，Semantic Scholar 尚未收录
【文件结构】 arxiv-research-skill/ ├── SKILL.md # 智能体指令 ├── README.md # 安装与概览 ├── references/ │ └── workflows.md # 多步骤工作流配方 └── scripts/ ├── connect.py # 知识导航 ├── understand.py # 分析提示词 ├── evidence.py # 引用生成 ├── tikz.py # TikZ 图表提取 ├── cache.py # SQLite 缓存（~/.cache/arxiv-research/papers.db） └── utils.py # 共享工具（extractPaperId、cleanText）
【适用场景与限制】 适用于跨 arXiv 查找论文、探索引用网络、对论文内容做结构化分析、组织文献综述、生成引用文献，以及从 LaTeX 源码提取 TikZ 图表的学术研究场景。使用时需注意各数据服务的速率限制，脚本不会自动重试失败请求；引用信息的可用性受 Semantic Scholar 收录情况影响，新论文可能暂无引用数据。