mcpField
P
paper-autoraters

paper-autoraters

github.com/ar9av文档处理69369 次安装2 周前更新
代码仓库

关于 paper-autoraters

paper-autoraters 是 PaperOrchestra 的评估技能,提供四种由 LLM 执行的论文评审方法,用于给生成论文评分及比较写作流程。它包含引用分类、文献综述与论文质量评审提示词,以及计算引用 F1 的脚本。

主要功能

  1. 01四种 LLM 评审方法
  2. 02P0/P1 参考文献分类
  3. 03文献综述六轴评分
  4. 04论文并排比较
  5. 05引用精确率、召回率与 F1 脚本

适用场景

  1. 01将生成论文与基准论文评分比较
  2. 02比较两种论文写作流程
  3. 03检查 PaperOrchestra 的 Agent 执行结果

安装

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

$npx skills add https://github.com/ar9av/paperorchestra --skill paper-autoraters

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

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
citation-f1-prompt.md
litreview-quality-prompt.md
sxs-litreview-prompt.md
sxs-paper-quality-prompt.md
scripts/
compute_f1.py

详细介绍

论文自动评审器(附录 F.3)

忠实实现 PaperOrchestra(Song 等人,2026,arXiv:2604.05018,第 5 节和附录 F.3)中使用的四种 LLM-as-judge 自动评审器。

论文使用这些指标来证明 PaperOrchestra 优于单 Agent 和 AI-Scientist-v2 基线。可使用它们来:

  1. 根据真实论文为生成的论文评分。
  2. 并列比较两种论文写作流水线。
  3. 验证你自己的宿主 Agent 是否正确执行了 paper-orchestra 流水线。

四种自动评审器

自动评审器功能输入输出
Citation F1 — P0/P1 划分根据论文文本,将参考文献列表划分为 P0(必须引用)和 P1(值得引用)一篇论文的文本 + 其参考文献列表JSON {ref_num: "P0"|"P1"}
文献综述质量对引言 + 相关工作进行 6 个维度的 0-100 分评分,并设置防虚高硬性上限一篇论文 PDF/文本 + 参考文献平均引用数包含 axis_scores、penalties、summary、overall_score 的 JSON
SxS 论文整体质量整体并列偏好判断两篇论文(PDF 或文本)JSON,winner ∈ {paper_1, paper_2, tie}
SxS 文献综述质量仅针对引言 + 相关工作的并列偏好判断两篇论文JSON,winner ∈ {paper_1, paper_2, tie}

论文使用 Gemini-3.1-Pro 和 GPT-5 作为评审模型,温度设为 0.0(Gemini)或默认的 1.0(GPT-5 不支持调整温度)。请使用你的宿主大模型。

工作流

Citation F1(计算相对于真实数据的 Precision / Recall / F1)

该流程分两步:

步骤 1:将参考文献列表划分为 P0 / P1

对真实论文和生成的论文,分别使用 references/citation-f1-prompt.md 运行 LLM:

inputs:
  paper_text:    full paper LaTeX or markdown
  references_str: numbered reference list (e.g., "1. Vaswani et al. (2017)
                  Attention Is All You Need. NeurIPS. 2. He et al. (2016)
                  Deep Residual Learning for Image Recognition. CVPR. ...")

output: JSON {"1": "P0", "2": "P1", "3": "P0", ...}

保存两份划分结果:

  • bench/<paper_id>/gt_partition.json
  • bench/<paper_id>/gen_partition.json
步骤 2:将参考文献解析为实体 ID 并计算 F1

论文使用 Semantic Scholar 论文 ID 来匹配两个列表中的参考文献。给定两个输入列表,compute_f1.py 脚本会确定性地完成此操作:

python skills/paper-autoraters/scripts/compute_f1.py \
    --gt-partition gt_partition.json \
    --gt-refs gt_refs.json \
    --gen-partition gen_partition.json \
    --gen-refs gen_refs.json \
    --out f1_report.json

其中,gt_refs.json 和 gen_refs.json 是由宿主的 S2 解析流程生成的 {ref_num, paper_id, title} 列表(使用与 literature-review-agent/scripts/ 相同的模糊匹配 + S2 验证)。

输出 JSON 包含 P0 / P1 / 总体 Precision、Recall、F1。

文献综述质量(单篇论文,6 个维度)

加载 references/litreview-quality-prompt.md。输入:

  • 完整论文 PDF(如果宿主不支持 PDF 输入,也可使用 LaTeX/markdown)
  • 该会议/领域的 avg_citation_count(用作引用数量锚定基准,例如论文中 CVPR 2025 为 58.52,ICLR 2025 为 59.18)

提示词要求模型仅评估论文的文献综述功能(引言 + 相关工作 / 背景部分)。 输出为严格的 JSON,包含各维度评分和理由。

提示词中内置了关键的防虚高规则:

规则上限
默认预期总分 45-70
> 85 需要所有维度都有强有力的证据—
> 90 极为罕见(接近综述级别的掌握程度)—
任一维度 < 50 → 总分通常不超过 75—
综述大多为描述性内容Critical Analysis ≤ 60
声称新颖性却未进行比较Positioning ≤ 60
引用稀疏或不一致Citation Rigor ≤ 60
引用数量 < 平均值的 50%Coverage ≤ 55
引用数量 > 平均值的 120%Coverage = "strong"

此外还有惩罚表:

惩罚项范围
过度宣称新颖性-5 到 -15
缺少关键的近期研究-5 到 -15
综述大多为描述性内容-5 到 -10
研究空白表述薄弱-5 到 -10
堆砌引用-5 到 -10

将输出保存到 litreview_quality_score.json。评分 JSON 的结构与 content-refinement-agent/scripts/score_delta.py 使用的结构相同,因此可以复用其中的停止规则逻辑来比较不同迭代。

SxS 整体论文质量(并排比较,全文)

加载 references/sxs-paper-quality-prompt.md。输入:

  • 两篇论文的 PDF 或 LaTeX 文件(分别称为 paper_1 和 paper_2)

提示词会生成包含 paper_1_holistic_analysis、 paper_2_holistic_analysis、comparison_justification 和 winner ∈ {paper_1, paper_2, tie} 的 JSON。

为减轻 LLM 的位置偏差(论文在 §5.4 中提到了这一点),交换顺序后运行比较两次:

call_1: paper_A → paper_1, paper_B → paper_2  → winner1
call_2: paper_B → paper_1, paper_A → paper_2  → winner2

最终结果:win(两次调用都认为论文 A 胜出)、tie(一次判胜、一次平局,或两次都是平局),或 loss(两次调用都认为论文 B 胜出)。论文采用了这一完全相同的排序流程。

SxS 文献综述质量(并排比较,仅限引言和相关工作)

加载 references/sxs-litreview-prompt.md。输入和输出格式与 SxS 论文质量自动评估器相同,但模型会被要求仅评估每篇论文的引言和相关工作/背景章节。为减轻位置偏差,同样交换顺序后运行两次。

资源

  • references/citation-f1-prompt.md — App. F.3 中逐字照录的 P0/P1 划分提示词
  • references/litreview-quality-prompt.md — App. F.3 中逐字照录的六轴文献综述评分标准
  • references/sxs-paper-quality-prompt.md — App. F.3 中逐字照录的 SxS 论文质量提示词
  • references/sxs-litreview-prompt.md — App. F.3 中逐字照录的 SxS 文献综述提示词
  • scripts/compute_f1.py — 根据两个划分 JSON 计算 Precision / Recall / F1

评论

支持 Markdown