/ 目錄 / 演練場 / asta-skill
● 社群 Agents365-ai ⚡ 即開即用

asta-skill

作者 Agents365-ai · Agents365-ai/asta-skill

透過 Ai2 的 Asta MCP 進行學術研究的 Claude 技能 — 支援 Semantic Scholar 搜尋、引用關係遍歷、批次論文查詢與段落摘取。

asta-skill 封裝了 Ai2 的 Asta MCP 伺服器(Semantic Scholar),並加入對 Claude 友好的使用指引。除了原始工具存取外,還新增了「意圖→工具」決策表與工作流程模式,協助 Claude 選擇正確的函式(例如避免使用可能回傳 20 萬字以上的 fields=citations)。八個核心工具涵蓋論文搜尋、批次查詢、引用關係圖、作者資料與約 500 字的段落摘取。

為什麼要用

核心特性

即時演示

實際使用效果

asta-skill.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "asta-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/asta-skill",
        "~/.claude/skills/asta-skill"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "asta-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/asta-skill",
        "~/.claude/skills/asta-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "asta-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/asta-skill",
        "~/.claude/skills/asta-skill"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "asta-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/asta-skill",
        "~/.claude/skills/asta-skill"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "asta-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Agents365-ai/asta-skill",
        "~/.claude/skills/asta-skill"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "asta-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Agents365-ai/asta-skill",
          "~/.claude/skills/asta-skill"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add asta-skill -- git clone https://github.com/Agents365-ai/asta-skill ~/.claude/skills/asta-skill

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: asta-skill

針對特定研究問題進行文獻回顧

👤 研究生與研究人員 ⏱ ~60 min intermediate

何時使用: 當你有一個研究問題,想快速掌握相關論文的全貌,而不想逐一瀏覽 Google Scholar。

前置條件
  • 技能已複製 — git clone https://github.com/Agents365-ai/asta-skill ~/.claude/skills/asta-skill
  • Ai2 Asta MCP 伺服器可連線 — 依照 Asta MCP 的設定說明操作;本技能預設 MCP 已完成設定
步驟
  1. 啟動搜尋
    Use asta-skill — find highly-cited papers on retrieval-augmented generation from 2023-2024.✓ 已複製
    → Claude 以適當的篩選條件呼叫 search_papers_by_relevance,而非泛用查詢
  2. 遍歷引用關係圖
    For the top 3, show me what cited them since.✓ 已複製
    → 以適當篩選條件呼叫 get_citations
  3. 擷取佐證段落
    Extract a 500-word passage from each paper explaining their main evaluation method.✓ 已複製
    → snippet_search 回傳精準段落

結果: 包含引用鏈與佐證段落的系統性文獻回顧,而非僅有標題清單。

注意事項
  • 請求 fields=citations 會批次回傳大量資料,導致上下文暴增 — 本技能已對此發出警告 — 請信任指引並改用分頁方式查詢
搭配使用: planning-with-files

查找某位研究者的重要著作並追蹤其學術影響力

👤 任何需要評估潛在合作者或指導教授的人 ⏱ ~20 min beginner

何時使用: 當你想快速、精確地了解某人的發表紀錄。

步驟
  1. 解析作者身分
    asta-skill — find the author 'Jane Smith' who works on graph neural networks.✓ 已複製
    → 呼叫 search_authors_by_name 並進行同名消歧義處理
  2. 取得論文清單
    Get their papers sorted by citation count.✓ 已複製
    → 呼叫 get_author_papers 並指定排序方式
  3. 影響力快照
    For the top 3, who's cited them most and is building on the work?✓ 已複製
    → 引用關係遍歷,呈現後續研究脈絡

結果: 一頁式的研究者影響力概覽。

組合

與其他 MCP 搭配,撬動十倍槓桿

asta-skill + planning-with-files

文獻回顧往往需要數天 — 用 findings.md 與 next-reads.md 持續記錄研究進度

Use planning-with-files — findings.md for papers read, next-reads.md for the queue.✓ 已複製
asta-skill + filesystem

將擷取的段落儲存為 Obsidian 筆記庫中的筆記

For each paper, save the snippet to ~/obsidian/papers/<title>.md.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
search_papers_by_relevance query + filters 從研究問題出發,開始進行文獻搜尋 1 MCP call
get_paper / get_paper_batch id or [ids] 需要取得已知論文或論文清單的完整詮釋資料 1 MCP call (batch saves round-trips)
get_citations paper id + filters + pagination 向前遍歷引用關係圖 1 MCP call
snippet_search paper id + query 需要取得佐證層級的段落以支撐論點 1 MCP call
search_authors_by_name / get_author_papers name + disambiguators 分析研究者的學術背景 1 MCP call

成本與限制

運行它的成本

API 配額
透過 Asta MCP 使用 Semantic Scholar API 有使用量限制 — 請查閱 Ai2 目前的服務條款
每次呼叫 Token 數
依情況而異;fields=citations 可能導致上下文暴增,請避免使用
費用
免費 — 技能為本地端檔案;Asta MCP 本身對學術研究用途免費
提示
優先使用批次呼叫與分頁引用查詢;snippet_search 比取得完整內文更有效率。

安全

權限、密鑰、影響範圍

憑證儲存: 本技能不包含任何憑證。Asta MCP 的設定過程可能需要 API 金鑰。
資料出站: 查詢會透過 Asta MCP 伺服器傳送至 Semantic Scholar

故障排查

常見錯誤與修復

Skill not invoked — Claude does a web search instead of calling Asta

請明確說明「use asta-skill」;單純的學術任務不一定會自動路由至 MCP。

驗證: ls ~/.claude/skills/asta-skill/SKILL.md
SKILL.md frontmatter wrong

重新複製儲存庫;description 欄位是觸發自動啟用的關鍵。

驗證: head ~/.claude/skills/asta-skill/SKILL.md
Wrong trigger keywords — context blows up on citation fetch

請勿請求 fields=citations — 改用 get_citations 搭配篩選條件進行分頁查詢。

替代方案

asta-skill 對比其他方案

替代方案何時用它替代權衡
arxiv MCP只需要預印本,不需要跨來源引用關係圖資料來源較窄;不支援引用關係遍歷
Raw Google Scholar不想設定 MCP,只需快速進行一次性查詢無結構化工具,類似網頁爬取的方式

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills