reference-manager

目的

管理并核验数学建模竞赛论文的参考文献。

此技能会检查每条引用是否对应真实来源，核实需要证据支持的论述是否在合适位置标注了引用，为所有参考文献生成格式规范的 BibTeX 条目，并确保论文中不含虚构引用。

此技能不搜索新论文、不撰写论文段落、不选择方法，也不对建模内容进行质量保证。

使用时机

在以下情况下使用此技能：

• paper-section-writer 已完成带引用的论文段落草稿后。
• 使用 quality-assurance-auditor 之前。
• 用户提出“检查参考文献”“生成 BibTeX”“核验引用”“构建 refs.bib”“检查所有引用是否真实”等要求时。
• 论文中包含需要核验的 \cite{...} 或方括号引用标记时。
• 相关论文分析中生成的论文引用需要转换为规范格式时。

前提条件

以下文件应已存在或已提供：

• 带引用的论文段落草稿（包含 \cite{...} 或 [1]、[2] 等）。
• workspace/papers/related_paper_analysis.md 中的相关论文分析（如有）。
• 用户提供的 workspace/papers/ 下的论文文件（如有）。

输入

使用或请求以下内容：

• paper/sections/*.md 或 paper/sections/*.tex — 带引用的论文草稿。
• workspace/papers/related_paper_analysis.md — 包含论文元数据的文献分析。
• workspace/papers/ 下的论文文件（PDF 等），用于提取元数据。
• 用户已准备的任何 .bib 文件。
• 用户关于哪些参考文献最重要的备注。

工作流

1. 清点论文中的所有引文。

   • 扫描论文的所有章节，查找 \cite{...} 命令、[N] 标记或作者－年份格式的引文。
   • 整理所有不重复的引文键或参考文献编号。
   • 记录每条引文出现的位置，以及它支持的论述。

2. 将引文与来源信息匹配。

   • 尝试为每条引文查找来源：
     • 在 workspace/papers/related_paper_analysis.md 中查找（如果分析过相关论文）。
     • 在 workspace/papers/ 下由用户提供的论文文件中查找。
     • 在用户提供的 BibTeX 或参考文献列表中查找。
   • 将无法匹配的引文标记为“未验证”。

3. 验证引文是否恰当。

   • 检查引文是否支持其所附论述。
   • 标记与论述无关的引文。
   • 标记“装饰性引文”——添加引文只是为了充实外观，实际并未支持任何论述。
   • 标记缺失的引文——可能需要参考文献支持却没有引文的论述。

4. 生成或更新 BibTeX 条目。

   • 为每条已验证的参考文献生成格式正确的 BibTeX 条目。
   • 条目类型：@article、@book、@inproceedings、@misc、@techreport。
   • 各类型所需字段：
     • @article：author、title、journal、year、volume、number、pages、doi（若有）。
     • @book：author/editor、title、publisher、year、edition（若适用）。
     • @inproceedings：author、title、booktitle、year、pages、doi（若有）。
     • @misc：author、title、howpublished、year、note、url（若适用）。
   • 使用一致的引文键格式：AuthorYear 或 AuthorYearKeyword。

5. 检测可能伪造的内容。

   • 出现以下情况时，将引文标记为可能伪造：
     • 找不到来源文件或元数据。
     • 无法根据现有来源验证标题、作者、年份或发表渠道。
     • 引文键存在，但没有对应条目。
     • 论文元数据看起来过于通用或像 AI 生成（如占位标题、明显伪造的 DOI）。
   • 将可能伪造的引文列为阻塞问题。

6. 生成或更新 paper/refs.bib。

   • 将所有已验证的 BibTeX 条目保存到 paper/refs.bib。
   • 确保文件是有效的 BibTeX（花括号配对，字段分隔符使用正确）。
   • 将未验证的条目标记为 %% UNVERIFIED — needs author confirmation。

7. 生成参考文献审查报告。

   • 保存为 paper/reference_audit.md。
   • 报告中包括：引文清单、匹配状态、伪造标记、缺失引文建议。

输出

• paper/refs.bib — 包含所有已验证参考文献的 BibTeX 文件。
• paper/reference_audit.md — 参考文献审查报告。

输出格式

paper/refs.bib

% ── Verified references ──────────────────────────────────────────────

@article{Wang2023TOPSIS,
  author    = {Wang, X. and Li, Y. and Zhang, H.},
  title     = {Entropy-weight TOPSIS method for multi-criteria urban resilience evaluation},
  journal   = {Journal of Urban Planning and Development},
  year      = {2023},
  volume    = {149},
  number    = {2},
  pages     = {04023001},
  doi       = {10.1061/JUPDD.0000123}
}

@book{Xu2018Modeling,
  author    = {Xu, Z.},
  title     = {Mathematical Modeling: Methods and Applications},
  publisher = {Higher Education Press},
  year      = {2018},
  edition   = {3rd}
}

@misc{COMAP2026,
  author    = {{COMAP}},
  title     = {MCM/ICM 2026 Problem A Statement},
  howpublished = {Contest problem statement},
  year      = {2026}
}

% ── UNVERIFIED — needs author confirmation ───────────────────────────

%% UNVERIFIED @article{Someone2024Method,
%%   author    = {Someone, A.},
%%   title     = {A Method for Something},
%%   journal   = {Unknown Journal},
%%   year      = {2024}
%% }

paper/reference_audit.md

# Reference Audit Report

> Last updated: [timestamp]

## 1. Citation Inventory

| # | Citation Key | Appears In | Claim Supported | Status |
|---|-------------|-----------|----------------|--------|
| 1 | `Wang2023TOPSIS` | Q1 Model Construction | "Entropy-TOPSIS is widely used..." | ✅ Verified |
| 2 | `Xu2018Modeling` | Assumptions | "Linear aggregation is common..." | ✅ Verified |
| 3 | `COMAP2026` | Problem Restatement | Problem source | ✅ Verified |
| 4 | `Someone2024Method` | Q3 Model Construction | "This method is optimal..." | ❌ UNVERIFIED |

## 2. Fabrication Risk Assessment

| Citation | Risk Level | Reason |
|----------|-----------|--------|
| `Someone2024Method` | HIGH | No source file found; author name "Someone" appears placeholder-like; no DOI or venue verifiable |

## 3. Missing Citation Suggestions

| Claim | Location | Suggested Citation |
|-------|----------|-------------------|
| "TOPSIS was first proposed by..." | Q1 Model Construction | Hwang & Yoon (1981) — Multiple Attribute Decision Making |

## 4. Recommendations

1. **BLOCKING**: Verify or remove `Someone2024Method` — appears to be fabricated.
2. **SUGGESTION**: Add Hwang & Yoon (1981) as the foundational TOPSIS reference.
3. **SUGGESTION**: Verify all DOIs resolve correctly before final submission.

引文验证规则

• 论文中的每条 \cite{...} 都必须在 paper/refs.bib 中有对应条目。
• paper/refs.bib 中的每个条目至少必须包含：author、title、year。
• 没有任何可验证来源（文件、元数据或用户确认）的引文，应标记为可能伪造。
• 参赛论文应引用：题目说明、关键方法参考文献、数据来源（若为外部数据）以及对比基线。
• 不要伪造 DOI、页码、卷号或作者姓名。
• 不要添加实际上并未查阅的“看起来很有分量”的参考文献。
• 参考文献应主要支持研究方法；避免为充实列表而添加参考文献。

规则

• 不要伪造参考文献、元数据或 DOI。
• 不要添加论文中未使用的参考文献。
• 每条引文都必须能追溯到实际来源。
• 将无法验证的引文标记为阻塞问题——不要悄悄删除。
• 仅为已验证的来源生成 BibTeX 条目。
• 使用一致的引文键格式。
• 在 .bib 文件中明确标记未验证条目。
• 应引用竞赛题目说明和官方附件。

核查

交接前，请核实：

• 论文中的每个 \cite{...} 都有对应的 BibTeX 条目（已核实或已标记）。
• 每个 BibTeX 条目至少包含作者、标题和年份。
• 明确标记未经核实的引用。
• 报告潜在的伪造风险。
• 提供缺失的引用建议。
• BibTeX 文件语法有效。

失败情况

遇到以下情况时，请停止并报告阻碍：

• 论文中的某条引用没有可追溯的来源，且看起来是伪造的。
• 多条引用使用相同的键，但元数据不同。
• 论文引用的来源与论文自身的主张相矛盾。
• 关键的方法论主张没有支持性引用，也没有合理说明。

停止条件

遇到以下情况时，此技能必须停止，不得猜测：

• 找不到引用的来源，且用户无法提供该来源。
• BibTeX 文件将包含伪造条目。
• 某条参考文献看起来完全是杜撰的。

停止时，请输出：

• 有问题的引用
• 标记原因
• 作者需要提供的内容（真实来源，或删除该引用）

交接

生成 paper/refs.bib 和 paper/reference_audit.md 后，交接给：

quality-assurance-auditor — 其将在最终 QA 检查中纳入参考文献核查。

交接内容应包括：

• paper/refs.bib 路径。
• paper/reference_audit.md 路径。
• 需要作者处理的未经核实引用列表。
• 伪造风险标记。

示例

示例 1：核查通过

## 1. Citation Inventory

| Citation Key | Status |
|-------------|--------|
| `Hwang1981TOPSIS` | ✅ Verified — from related_paper_analysis.md |
| `Wang2023Entropy` | ✅ Verified — from workspace/papers/wang2023.pdf |
| `COMAP2026` | ✅ Verified — contest problem statement |
| `Xu2018Modeling` | ✅ Verified — user-provided reference |

示例 2：检测到伪造内容

## 2. Fabrication Risk Assessment

| Citation | Risk | Reason |
|----------|------|--------|
| `Smith2025BestMethod` | HIGH | No paper file found. No metadata in related_paper_analysis.md. Author "Smith" + generic title "Best Method for Evaluation" looks auto-generated. Google Scholar shows no match. |

**Recommendation**: Remove this citation or provide the actual paper. Do not submit the paper with this citation.