mcpField
L
literature-report

literature-report

github.com/allenai文档处理4292 次安装1 天前更新
代码仓库

关于 literature-report

literature-report 是用于创建或更新带引用的 Markdown 文献综述和报告的 Skill,指导查找论文、维护 BibTeX 条目,并验证引用能否正确呈现。

主要功能

  1. 01创建或更新 Markdown 报告
  2. 02检查并利用已有检索结果
  3. 03按规范添加 BibTeX 条目
  4. 04使用指定格式插入引用
  5. 05预览并验证引用

适用场景

  1. 01撰写带引用的文献综述
  2. 02在现有报告中整合新论文
  3. 03检查引用键与文献表是否匹配

安装

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

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

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

详细介绍

文献报告

创建或更新文献综述/报告,并以 Markdown 文档形式呈现,同时附上引文。

查找论文

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

工作流指南

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

引文规范

YAML frontmatter——引文解析必需:

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

引文:使用 [@key] 格式。每个 key 都必须存在于 .bib 文件中;无法解析的 key 不会呈现。

向 .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