citation-audit

引用監査

投稿前に、引用、BibTeX エントリー、LaTeX の相互参照を監査します。このスキルは、幅広い文献探索ではなく、投稿前の正確性確認を目的としています。

論文に引用のドラフトがすでにあり、ユーザーが次の点を確認したい場合に、このスキルを使用します。

• TeX 内のすべての \cite{...} キーが BibTeX に存在する
• すべての BibTeX エントリーの構文が正しく、重複がない
• すべての \ref{...}、\cref{...}、\eqref{...}、\autoref{...} の参照先が存在する
• すべての \label{...} が一意で、ローカルの命名規則に従っている
• DOI、arXiv、OpenReview、URL、タイトル、著者、年、会場のメタデータが実際の論文と一致している
• 引用の近くにある本文中の主張が、引用先の研究によって実際に裏付けられている
• 参考文献のスタイルが投稿に適している

より広範な投稿チェックリストには submit-paper と組み合わせてください。引用の正確性に関する問題を、論文の重大なリスクや対応事項として扱う場合は、research-project-memory と組み合わせてください。

スキルのディレクトリ構成

<installed-skill-dir>/
├── SKILL.md
├── scripts/
│   └── audit_latex_refs.py
└── references/
    ├── citation-claim-audit.md
    ├── metadata-verification.md
    └── report-template.md

段階的な読み込み

• 決定的な TeX／BibTeX／参照チェックを行うため、必ず scripts/audit_latex_refs.py を実行してください。
• DOI、arXiv、OpenReview、論文集、出版社のメタデータを確認する場合は、references/metadata-verification.md を読んでください。
• ユーザーが引用によって論文中の主張が裏付けられているかを尋ねた場合、または投稿前の包括的な監査を行う場合は、references/citation-claim-audit.md を読んでください。
• 最終監査レポートには references/report-template.md を使用してください。

ステップ 1 - 論文ソースの特定

次の項目を特定します。

• 論文のルートディレクトリ
• メインの TeX ファイル
• すべてのインクルード対象 TeX ファイル
• \bibliography{...} または \addbibresource{...} で参照される BibTeX ファイル
• 明らかな場合は、対象の会場と投稿モード

有用なローカルチェック：

find . -maxdepth 4 -name "*.tex" -o -name "*.bib"
find . -maxdepth 3 -name "main.tex" -o -name "paper.tex"

ユーザーが論文のディレクトリを指定した場合は、それを使用してください。メインファイルが指定されていない場合は、main.tex、次に paper.tex、その次に \begin{document} を含む TeX ファイルを優先してください。

ステップ 2 - 決定的なローカル監査の実行

次を実行します。

python3 <citation-audit-skill-dir>/scripts/audit_latex_refs.py --paper-dir "$PAPER_DIR" --main "$MAIN_TEX"

インストール済みのスキルスクリプトには絶対パスを使用してください。Claude 固有のインストールパスを想定しないでください。

スクリプトで確認する項目：

• インクルード対象の TeX ファイルの特定
• \cite、\citet、\citep、\citealp、\citeauthor、\citeyear、\textcite、\parencite にある引用キー
• BibTeX キーと基本的な構文
• 引用キーの欠落
• 未使用の BibTeX エントリー
• 重複した BibTeX キー
• 参考文献ファイルの欠落
• 重複したラベル
• 未定義の参照
• 参照されていないラベル
• ?? などの未解決の LaTeX プレースホルダー、および [?] などの引用プレースホルダー

スクリプトが重大な問題を報告した場合は、ウェブ上のメタデータを確認する前に、それらを修正するか報告してください。TeX／BibTeX の構造に問題があると、メタデータの検証はあまり有用ではありません。

ステップ 3 - 指摘事項の分類

次の重大度モデルを使用します。

• blocking：引用キーの欠落、BibTeX キーの重複、未定義の参照、ラベルの重複、BibTeX 構造の不正、引用した研究の DOI の破損
• important：メタデータの不一致、会場または年の誤り、エントリーの重複の可能性、引用によって主張が裏付けられていない、査読済み版を引用すべき箇所で arXiv を引用している
• warning：未使用の BibTeX エントリー、参照されていないラベル、一貫性のないキー命名、任意の DOI／URL の欠落
• note：スタイルの整理、大文字表記、フィールドの正規化、BibTeX キーの変更提案

対象の会場またはユーザーが最小限の参考文献リストを求めていない限り、未使用の BibTeX エントリーを重大な問題として扱わないでください。

ステップ 4 - メタデータの検証

references/metadata-verification.md を読んでください。

引用された各キーについて、利用可能な最適な識別子を検証します。

• DOI：出版社、CrossRef、doi.org で確認
• arXiv ID：arXiv で確認
• OpenReview の URL またはフォーラム ID：OpenReview で確認
• NeurIPS、ICML、ICLR、ACL Anthology、CVF、ACM、IEEE、Springer、PMLR の論文集 URL

次の項目を確認します。

• タイトル
• 著者リスト、または筆頭著者と著者数
• 年
• 会場または出版状況
• DOI／arXiv／OpenReview／論文集の URL
• 査読済み版が存在するかどうか

メタデータを検証できない場合は、推測せず、その旨を明記してください。

Step 5 - 引用の主張を監査する

詳しいガイダンスについては、references/citation-claim-audit.mdを読んでください。

引用箇所ごとに、文章が引用に何を裏付けるよう求めているかを分類します。

• 背景となる事実
• 先行手法の存在
• 最も関連性の高い研究
• 実証結果
• 理論的結果
• データセットまたはベンチマーク
• 否定的な主張または制約
• 比較または最先端であるという主張

次に、引用された論文が実際にその役割を裏付けているかを確認します。リスクの高い主張については、必要に応じて要旨、序論、手法・結果のセクション、さらにPDFを確認します。

リスクの高い箇所：

• 「初」「唯一」「最先端」「大幅に」「証明可能」「保証する」
• 論文の結果や制約に関する主張
• ベースラインの選択を正当化するために使われている引用
• 理論上の仮定を正当化するために使われている引用
• 貢献の箇条書きや問題の動機付けに含まれる引用

科学的主張を黙って書き換えてはいけません。引用が主張を裏付けていない場合は、次のいずれかを提案します。

• 引用を差し替える
• 主張を弱める
• より具体的な引用を追加する
• 主張を関連研究に移す
• 著者への確認が必要であると明記する

Step 6 - 安全な修正を行う

安全な自動修正：

• レポートで.bib拡張子が省略された場合の解決処理を追加する
• 真に同一であることを確認した後に限り、明らかな重複BibTeXエントリーを削除する
• タイトルの大文字・小文字を囲む波括弧を正規化する
• 確認済みのDOI/arXiv/URLフィールドを追加する
• BibTeXフィールドのスペルを修正する
• すべてのTeXの参照箇所を一貫して更新する場合に限り、ラベルまたは引用キーを変更する

自動修正してはいけないもの：

• 裏付けが曖昧な引用の主張
• 科学的な違いを説明せずに、引用された論文を別の論文に差し替えること
• 複数の版が存在する場合の出版状況
• 情報源によって異なる著者の順序

編集は、可能な限り差分を小さくしてください。

Step 7 - 監査レポートを作成する

references/report-template.mdを使用してください。

最終レポートには、次の内容を含めてください。

• 確認したファイル
• ローカルのTeX/BibTeXグラフの状態
• メタデータの検証状況
• 引用の主張の裏付け状況
• 投稿前に必要なブロッキング修正
• 推奨する非ブロッキングの整理
• 著者の判断が必要な未解決事項

ユーザーがレポートの保存を求めていて、保存先を指定していない場合は、次を使用してください。

docs/reports/citation_audit_YYYY-MM-DD.md

Step 8 - 最終確認

最終化する前に、次を確認してください。

• 引用されたすべてのキーが、ちょうど1つのBibTeXエントリーに解決される
• 必要なすべてのTeX参照が、ちょうど1つのラベルに解決される
• プロジェクトメモリがある場合、ブロッキングとなる引用・参照の問題が対応事項として記録されている

Step 9 - プロジェクトメモリに書き戻す

プロジェクトでresearch-project-memoryを使用している場合は、次を更新します。

• memory/risk-board.md：ブロッキングまたは重要な引用、メタデータ、ラベル、参照、引用の主張に関するリスク
• memory/action-board.md：キーの不足、メタデータの修正、裏付けのない主張、壊れた参照に対する具体的な修正
• memory/claim-board.md：引用が裏付けていないため、弱める必要がある主張
• paper/.agent/paper-status.md：引用監査の状況と、未解決の著者判断事項

確定的なTeX/BibTeXグラフの調査結果にはobservedを使用し、十分に確認できていないメタデータや主張の裏付けに関する問題にはneeds-verificationを使用します。

• ブロッキングとなるメタデータの問題はすべて修正するか、明示的に列挙する
• リスクの高い引用の主張を監査する
• 未解決の引用の正確性に関する疑問を隠さない
• スクリプトで確定した調査結果と、ウェブ上または意味内容の検証による調査結果を最終回答で区別する