关于 literature-report
literature-report 是用于创建或更新带引用的 Markdown 文献综述和报告的 Skill,指导查找论文、维护 BibTeX 条目,并验证引用能否正确呈现。
主要功能
- 01创建或更新 Markdown 报告
- 02检查并利用已有检索结果
- 03按规范添加 BibTeX 条目
- 04使用指定格式插入引用
- 05预览并验证引用
适用场景
- 01撰写带引用的文献综述
- 02在现有报告中整合新论文
- 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