关于 Asta Literature Reports
Asta Literature Reports 是用于创建或更新带引用的 Markdown 文献综述的技能。它规范论文查找、报告文件选择、BibTeX 条目处理和引用验证流程。
主要功能
- 01创建或更新 Markdown 报告
- 02优先检查现有搜索结果
- 03使用关联 BibTeX 键的引用
- 04向文献库添加论文元数据
- 05通过 Preview 验证引用
适用场景
- 01在项目可见位置新建文献综述
- 02保留现有结构并更新报告
- 03引用文献检索找到的论文
- 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