停止。在呼叫任何端點前，請先完整閱讀本 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 "theory of mind BDI agent belief tracking" -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 "agent memory" -n 5
回傳包含完整摘要的論文，方便快速篩選。
| 選項 | 說明 |
|---|---|
-q | 搜尋查詢（必要） |
-n | 最大結果數（預設：10） |
-c | 類別篩選（例如 cs.LG） |
-m | 只搜尋過去 N 個月內的論文 |
--smart | LLM 將自然語言查詢轉換為搜尋詞 |
learn - 萃取知識
./run.sh learn 2601.08058 --scope memory
完整管線：下載 → 剖析 → 萃取 → 問答 → 訪談 → 儲存 → 驗證關聯。
| 選項 | 說明 |
|---|---|
--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 figures, 4 tables → Using HTML extraction (fast mode)
順利路徑
# 1. 搜尋 - 取得摘要
./run.sh search -q "agent memory systems" -n 5
# 2. 停止 - 與使用者討論摘要，評估相關性
# 3. 學習 - 萃取使用者選擇的論文（預設使用 HTML 萃取）
./run.sh learn 2601.10702 --scope memory --context "agent systems"
範例
研究綜述（HTML 萃取 - 預設）
./run.sh learn 2601.10025 --scope persona-research --context "LLM personality"
含有關鍵圖表的論文（精確模式）
./run.sh learn 2501.15355 --scope tom-research --context "BDI architecture" --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 "agent memory" -n 10
正確：先產生 /tmp/arxiv_context.md 再搜尋
# 1. 寫入包含特定目標與相關性標準的情境檔案
# 2. 然後根據情境進行搜尋
./run.sh search -q "agent memory BDI belief tracking" -n 10
錯誤：未經使用者確認就萃取論文
# 代理自動萃取全部 10 筆搜尋結果
./run.sh learn 2501.15355 --scope research
./run.sh learn 2502.14171 --scope research
正確：呈現摘要，讓使用者挑選，再萃取
./run.sh search -q "agent memory" -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 更快且更可靠
相依元件
| 元件 | 網址 | 用途 |
|---|---|---|
| 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[] 中。