停止。在调用任何端点之前，请通读本 SKILL.MD 文档。
arXiv 技能
搜索 arXiv 并将知识提取到记忆中。
命令
| 命令 | 描述 |
|---|---|
search | 查找论文（返回摘要以供筛选） |
learn | 将知识提取到记忆中 |
download | 默认下载论文 HTML；输出文件以论文标题命名 |
强制要求：动态上下文生成
不可协商： 在执行任何 arXiv 操作之前，代理必须生成一个捕获当前协作目标的动态上下文文件。
为什么这是必须的
没有动态上下文时：
- 搜索会返回与主题无关的论文
- 摘要筛选缺乏清晰的相关性标准
- 提取的知识过于泛化（“论文关于 X 说了什么？”）
拥有动态上下文时：
- 搜索精准针对特定实现需求
- 摘要评估具备明确的接受/拒绝标准
- 提取的知识具有可操作性（“如何将 X 实现为代码”）
工作流：先上下文，后论文发现
0. 上下文 → 从对话中生成动态上下文（必需）
1. 搜索 → 使用上下文查找相关论文
2. 筛选 → 根据上下文目标评估摘要
3. 决策 → 用户选择要提取的论文
4. 学习 → 在上下文指导下进行聚焦知识提取
步骤 0：生成动态上下文（必需）
在搜索之前，代理必须创建 /tmp/arxiv_context.md：
# 研究上下文：[你的具体目标]
## 我们正在构建什么
[描述具体功能/系统，例如：“Horus 代理的心智理论”]
## 当前状态
[已经存在什么，已经实现了什么，我们有什么]
## 我们需要从论文中获得什么
1. [具体问题 1，例如：“如何将信念置信度表示为数据结构”]
2. [具体问题 2，例如：“何时触发反事实反思”]
3. [具体问题 3，例如：“遇到矛盾时更新信念的算法”]
## 需要尝试的搜索词
- [词条 1]
- [词条 2]
## 摘要筛选的相关性标准
- 高：直接解决 [具体需求] 的论文
- 中：包含可以改造的相关技术的论文
- 低：关联性不大，除非没有更好的选择才考虑
## 知识提取焦点
- 提取：[什么类型的知识，例如：“算法、数据结构、更新规则”]
- 跳过：[忽略什么，例如：“评估指标、数据集描述、未来工作”]
## 输出格式偏好
表述为实现问题，而非摘要：
- 差：“论文关于 X 说了什么？”
- 好：“我们应该如何实现 X？代码模式是怎样的？”
步骤 1：在上下文指导下搜索
创建上下文后，用它来指导搜索：
# 在上下文目标指导下搜索
./run.sh search -q "心智理论 BDI 代理信念追踪" -n 10
步骤 2：根据上下文进行筛选
根据上下文的相关性标准评估每篇摘要：
## 找到的论文 - 根据上下文目标评估
### 1. **论文标题** (arXiv:XXXX.XXXXX)
> [摘要]
**根据上下文的评估：**
- 涉及目标 1（信念表示）：是——描述了 BDI 字典结构
- 涉及目标 2（反事实反思）：否
- **结论：高**——直接回答了我们的数据结构问题
### 2. **论文标题** (arXiv:XXXX.XXXXX)
> [摘要]
**根据上下文的评估：**
- 涉及目标 1：否
- 涉及目标 2：是——描述了反思触发条件
- **结论：高**——直接回答了我们的算法问题
---
我应该提取哪些论文？
步骤 3：使用上下文文件进行提取
将上下文文件传递给 learn 进行聚焦提取：
./run.sh learn 2501.15355 --scope persona-research --context-file /tmp/arxiv_context.md
在用户确认论文选择之前，不得继续处理。
search - 查找论文
./run.sh search -q "代理记忆" -n 5
返回带有完整摘要的论文，便于快速筛选。
| 选项 | 描述 |
|---|---|
-q | 搜索查询（必需） |
-n | 最大结果数（默认：10） |
-c | 类别筛选（例如 cs.LG） |
-m | 最近 N 个月的论文 |
--smart | LLM 将自然语言查询翻译为搜索词 |
learn - 提取知识
./run.sh learn 2601.08058 --scope memory
完整流程：下载 → 分析 → 提取 → Q&A → 访谈 → 存储 → 验证链接。
| 选项 | 描述 |
|---|---|
--scope | 记忆范围（必需） |
--context | 相关性的领域焦点 |
--dry-run | 预览而不存储 |
--skip-interview | 自动接受建议 |
--accurate | 强制使用 PDF + VLM 提取 |
--mode | 访谈模式：auto、html、tui（默认：auto） |
提取模式（HTML 优先）
新功能： learn 命令现在默认使用 HTML 优先提取：
- 从 ar5iv.org 下载 HTML（arxiv 论文转换为干净的 HTML）
- 运行快速分析检查（统计图表数量）
- 路由到适当的提取模式
arxiv learn <id>
│
├── 快速模式（默认）──► ar5iv HTML ──► extractor HTML
│ - 大多数研究论文 （100% 提取质量）
│ - 文本密集型内容 （无 PDF 分栏问题）
│
└── 精确模式 ──► arxiv PDF ──► extractor PDF + VLM
- 图表至关重要的论文
- 包含精确值的复杂表格
- 使用：--accurate 标志
为什么 HTML 优先？
| 方面 | HTML (ar5iv) | |
|---|---|---|
| 提取质量 | 100% 等价 | ~87%（存在列检测问题） |
| 速度 | 快速（约 5 秒） | 较慢（约 30 秒 - 2 分钟） |
| 图表标题 | 包含 | 需要 VLM |
| 数学公式渲染 | MathML 保留 | 文本近似 |
| 布局问题 | 无 | 两列检测问题 |
ar5iv.org 将 arxiv LaTeX 源代码转换为语义化的 HTML，包含 MathML 公式和良好的结构。这消除了 PDF 提取的问题。
何时使用 --accurate
| 内容类型 | 推荐模式 | 原因 |
|---|---|---|
| 大多数研究论文 | 默认 (HTML) | 文本和标题已经足够 |
| 综述论文 | 默认 (HTML) | 覆盖范围广，精确图表不重要 |
| 有重要图表的论文 | --accurate | 视觉内容本身就是重点 |
| 有复杂数据表格的论文 | --accurate | 当精确数字很重要时 |
# 默认：HTML 提取（快速、可靠）
./run.sh learn 2601.10025 --scope persona-research
# 对图表密集的论文强制使用精确模式
./run.sh learn 2501.15355 --scope tom-research --accurate
基于分析的路径选择
该技能会自动分析下载的 HTML，建议提取模式：
- < 20 张图表 且 < 10 个表格：使用 HTML（快速模式）
- > 20 张图表 或 > 10 个表格：建议使用精确模式（或使用
--accurate）
分析结果会在日志中显示：
Profile: 12 张图表, 4 个表格 → 使用 HTML 提取（快速模式）
推荐路径
# 1. 搜索 - 获取摘要
./run.sh search -q "代理记忆系统" -n 5
# 2. 停止 - 与用户讨论摘要，评估相关性
# 3. 学习 - 提取用户选择的论文（默认使用 HTML 提取）
./run.sh learn 2601.10702 --scope memory --context "代理系统"
示例
研究调研（HTML 提取 - 默认）
./run.sh learn 2601.10025 --scope persona-research --context "LLM 个性化"
含关键图表的论文（精确模式）
./run.sh learn 2501.15355 --scope tom-research --context "BDI 架构" --accurate
先进行试运行
# 预览将提取的内容
./run.sh learn 2601.10025 --scope test --dry-run
仅下载 HTML
# 下载 ar5iv HTML 供手动检查（默认；文件名基于标题）
./run.sh download -i 2501.15355
# 仅在需要时下载 PDF
./run.sh download -i 2501.15355 --format pdf
批量处理（并行）
# 并行处理多篇论文（默认：2 个并发）
./run.sh batch 2501.15355 2502.14171 2310.10701 --scope tom-research --context-file /tmp/context.md
# 提高并行度以加快处理
./run.sh batch 2501.15355 2502.14171 2310.10701 --scope research --parallel 3
# 试运行以预览
./run.sh batch 2501.15355 2502.14171 --scope test --dry-run
| 选项 | 描述 |
|---|---|
--parallel N | 同时处理的最大论文数（默认：2） |
--context-file | 用于聚焦提取的丰富上下文文件 |
--skip-interview | 自动接受（批量模式默认） |
--dry-run | 预览而不存储 |
注意： 建议并行度为 2-3 篇论文。更高的值可能触发 API 速率限制。
常见错误
错误：未先创建上下文就直接搜索
./run.sh search -q "代理记忆" -n 10
正确：先生成 /tmp/arxiv_context.md，然后再搜索
# 1. 编写包含具体目标和相关性标准的上下文文件
# 2. 然后在上下文指导下搜索
./run.sh search -q "代理记忆 BDI 信念追踪" -n 10
错误：未经用户确认就提取论文
# 代理自动提取所有 10 个搜索结果
./run.sh learn 2501.15355 --scope research
./run.sh learn 2502.14171 --scope research
正确：展示摘要，让用户选择，然后再提取
./run.sh search -q "代理记忆" -n 10
# 停止 - 与用户讨论摘要，评估相关性
# 用户选择论文 2 和 5
./run.sh learn 2501.15355 --scope research --context-file /tmp/arxiv_context.md
错误：对文本密集的论文使用 --accurate
./run.sh learn 2601.10025 --scope research --accurate # 在 PDF 提取上浪费时间
正确：默认使用 HTML 模式处理大多数论文，仅对图表密集的论文使用 --accurate
./run.sh learn 2601.10025 --scope research # HTML 更快更可靠
依赖项
| 组件 | URL | 用途 |
|---|---|---|
| ar5iv.org | https://ar5iv.org | 将 arxiv 论文的 LaTeX 转换为 HTML |
| extractor 技能 | （同级技能） | HTML/PDF 内容提取 |
| qra 技能 | （同级技能） | 从文本生成问答对 |
QRA 训练故障恢复说明（2026-09-14）
在 qra-training 研究期间观察到：当 arXiv 元数据 API 在 HTML/PDF 下载步骤之前返回 429 或超时时，download --format html 失败了。CLI 现在将元数据查找视为直接论文 ID 的可选步骤。如果元数据获取失败，它会构建直接的回退 URL 并按顺序尝试：
https://arxiv.org/html/<id-with-version>https://arxiv.org/html/<base-id>https://ar5iv.org/abs/<base-id>https://ar5iv.labs.arxiv.org/html/<base-id>
当这些内容 URL 之一成功时，元数据故障应出现在 warnings[] 中，而非 errors[]。