reference-manager

目的

数理モデリングコンテストの論文に記載された参考文献を管理し、検証します。

このスキルでは、引用された参考文献が実在する情報源に対応していることを確認し、根拠が必要な箇所に引用があるかを検証し、すべての参考文献について適切な書式の BibTeX エントリを作成し、論文に捏造された引用が含まれていないことを確認します。

このスキルでは、新しい論文の検索、論文のセクションの執筆、手法の選定、モデリング内容の品質保証は行いません。

使用するタイミング

次の場合にこのスキルを使用します。

• paper-section-writer が引用付きの論文セクションを作成した後。
• quality-assurance-auditor の実行前。
• ユーザーが「参考文献を確認して」「BibTeX を作成して」「引用を検証して」「refs.bib を作成して」「すべての引用が実在するか確認して」と依頼した場合。
• 論文に \cite{...} または [1]、[2] などの角括弧付きの参考文献マーカーがあり、検証が必要な場合。
• 関連論文の分析で、書式を整える必要がある論文の参考文献が作成された場合。

前提条件

以下がすでに存在するか、提供されている必要があります。

• 引用を含む論文セクションの草稿（\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.