citation-verifier

引用検証ツール

トリガーとルーティング

• トリガー：citation、BibTeX、ref.bib、verified.jsonl、references、引用、参考文献。
• 使用する場面：papers/paper_notes.jsonl がすでにあり、本文や LaTeX で使用する追跡可能な引用（各項目に url/date/title の検証記録がある）を用意する必要がある場合。

citations/ref.bib を生成し、すべての項目に追跡可能な検証記録を citations/verified.jsonl に残してください。

ネットワークアクセスが制限されている場合は、「記録して、後で検証する」ワークフローを優先してください。URL とタイトルの整合性を保ち、明確な検証メモを残してください。

入力

• papers/paper_notes.jsonl

出力

• citations/ref.bib
• citations/verified.jsonl

ワークフロー（ヒューリスティック）

1. papers/paper_notes.jsonl から bibkey、title、url、year、authors を収集します。
2. citations/ref.bib を作成または更新します。
   • arxiv_id / primary_category がある場合は、arXiv 形式のフィールド（eprint、archivePrefix、primaryClass）を優先します。
3. BibTeX の各項目について、最低限以下を含む検証記録を citations/verified.jsonl に 1 件ずつ書き込みます。
   • bibkey、title、url、date
4. ネットワーク経由で検証できない場合は、明確な notes フィールド（例：「自動生成。手動での検証が必要」）を記録するか、ポリシーに応じて人間に確認を依頼します。

品質チェックリスト

• すべての BibTeX 項目に、対応する verified.jsonl の記録があります。
• 検証記録に url / date / title の欠落がありません。

オフラインモード

ネットワークアクセスが制限されている場合は、オフラインモードを実行して監査可能な記録を今すぐ作成し、後で検証してください。

• オフライン記録を生成する：verification_status: offline_generated
• 後で検証する（ネットワークが利用可能になったとき）：--verify-only

verification_status

• offline_generated：ネットワーク検証なしで記録を生成しました（後で検証が必要です）
• verified_online：スクリプトによる URL / タイトルの検証に成功しました
• verify_failed：検証を試みましたが失敗しました（ネットワークエラーまたはタイトルの不一致）
• needs_manual_verification：フィールドが欠落しているか、曖昧です（例：url / title が空）

スクリプト

クイックスタート

• uv run python .codex/skills/citation-verifier/scripts/run.py --help
• オフライン（記録して、後で検証）：uv run python .codex/skills/citation-verifier/scripts/run.py --workspace <workspace> --offline

すべてのオプション

• --offline：ネットワーク検証を試みず、verification_status=offline_generated を書き込みます
• --verify-only：既存の citations/verified.jsonl の記録を検証します（BibTeX は書き換えません）
• --verification-note <text>：citations/verified.jsonl の notes に保存します

例

• BibTeX とオフライン検証記録を生成する：
  • uv run python .codex/skills/citation-verifier/scripts/run.py --workspace <workspace> --offline --verification-note "auto-generated; needs manual verification"
• 後で検証のみを実行する（ネットワークが利用可能なとき）：
  • uv run python .codex/skills/citation-verifier/scripts/run.py --workspace <workspace> --verify-only

注記

• 各検証記録に必要な最小フィールドは url、date、title です。
• スクリプトは、BibTeX の解析を安定させるため、タイトル内の余分な {} や対応していない {} をサニタイズします。
• スクリプトは、テキストフィールド内の LaTeX 特殊文字（& % $ # _）をエスケープし、X^N や X$^N$ のような上付き文字のパターンを X\textsuperscript{N} に書き換えて、LaTeX のビルドを安定させます。
• BibTeX の url フィールドには URL をそのまま保持します（BibTeX のスタイルが \url{...} で囲みます）。@misc では howpublished=\url{...} を使用します。
• オフラインモードの記録は、実際に検証されたものではありません。offline_generated は、人間またはネットワークによる検証が必要な作業項目として扱ってください。

トラブルシューティング

よくある問題

問題：メモに bibkey がない／url がない

症状：

• citations/ref.bib に項目が含まれない、または verified.jsonl の url/title が空になっている。

原因：

• papers/paper_notes.jsonl に bibkey / url フィールドがありません。

解決策：

• 各主要論文のメモに、安定した bibkey と正規の url があることを確認してください。
• メモを修正した後、引用の生成を再実行してください。

問題：verification_status=offline_generated

症状：

• レコードは存在しますが、実際には検証されていません。

原因：

• --offline が使用されたか、ネットワーク検証を利用できませんでした。

解決策：

• ネットワークが利用できる場合は、--verify-only を実行してレコードを更新します。
• または手動で検証し、メモを添えて citations/verified.jsonl を更新します。

復旧チェックリスト

• すべての BibTeX エントリーに、一致する citations/verified.jsonl レコードがあります。
• 検証レコードに url、date、title が含まれています。