mcpField
A
Asta Literature Reports

Asta Literature Reports

github.com/allenai生产力420 次安装1 天前更新
代码仓库

关于 Asta Literature Reports

Asta Literature Reports 是用于创建或更新带引用的 Markdown 文献综述的技能。它规范论文查找、报告文件选择、BibTeX 条目处理和引用验证流程。

主要功能

  1. 01创建或更新 Markdown 报告
  2. 02优先检查现有搜索结果
  3. 03使用关联 BibTeX 键的引用
  4. 04向文献库添加论文元数据
  5. 05通过 Preview 验证引用

适用场景

  1. 01在项目可见位置新建文献综述
  2. 02保留现有结构并更新报告
  3. 03引用文献检索找到的论文
  4. 04检查报告中的引用是否可解析

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/allenai/asta-plugins --skill asta-literature-reports

安装后在 Claude Code 中输入/asta-literature-reports确认已加载。

详细介绍

文献报告

创建或更新带有引用的 Markdown 文档,撰写文献综述或报告。

查找论文

  • 在运行新搜索前,检查 .asta/literature/find/ 中是否已有搜索结果。
  • 使用 Find Literature 技能进行全面搜索,并了解结果架构和 jq 访问模式。
  • 使用 Semantic Scholar Lookup 技能进行定向查询:查找特定论文、引用和作者。

工作流指南

  • 先确定或创建报告文件。检查是否已有报告可供更新。新报告应放在用户可见的位置(例如 docs/),而不是 .asta/ 中。
  • 更新现有报告时,先阅读报告,了解其当前结构和内容。
  • 使用 Find Literature 的结果时,逐一查看所有高度相关的论文——从每篇论文中提取相关性标准、摘要片段和引用上下文。

引用规范

YAML frontmatter——引用解析所必需:

---
bibliography: ../references.bib
---

引用:使用 [@key] 格式。每个 key 都必须存在于 .bib 文件中,否则无法解析。

向 .bib 添加论文:引用论文时,获取其元数据并追加 BibTeX 条目:

asta papers get CorpusId:<id> --fields title,authors,year,venue,externalIds,journal,publicationDate

根据结果生成 BibTeX 条目。规范:

  • Key:{firstAuthorSurname}{year},全部小写,仅限 ASCII(例如,wei2022)。如遇冲突,追加字母(wei2022a)。
  • corpus_id:加入 corpus_id = {<id>},以便稳定识别(即使 key 重命名也不会改变)。
  • 追加到 .bib 文件中,切勿重写现有条目。

验证:使用 Preview 技能渲染内容,并确认所有引用都能解析。

评论

支持 Markdown