Communityライティング&編集github.com

ytakano/reference-audit

学術原稿や参考文献リストにおいて、幻覚(ハルシネーション)による可能性のある参考文献を監査し、信頼できる情報源と照合して書誌情報の同一性を検証し、人間が確認するための直接リンク付きMarkdownレポートを作成します。引用チェック、参考文献検証、捏造・偽造・幻覚参考文献の検出(参考文献チェック・文献の実在確認)に使用します。原稿の主張を引用元が支持しているかどうかを判断するためのものではありません。

reference-audit とは?

このスキル(Reference Audit)は、学術原稿や参考文献リスト内の各引用が実際に存在する文献を正しく参照しているかどうかを、体系的かつ証拠に基づいて検証するためのツールです。BibTeX/BibLaTeX、LaTeX、PDF、または貼り付けられた参考文献を受け付け、DOI、arXiv ID、PMID、ISBNなどの識別子を調査し、必要に応じてタイトルや著者名で独立した検索を行います。Crossref、DataCite、DBLP、arXiv、PubMed、OpenAlexなどの権威あるAPIやデータベースを活用し、出版社の公式記録と比較することで、書誌情報の一致・矛盾・欠落を特定します。検証結果は「Verified match」「Partial match / metadata mismatch」「Not verified」「Contradicted as supplied」の4段階で評価され、撤回や訂正などのフラグも付与されます。最終的には、各エントリの元の引用情報、検証ステータス、証拠リンク、確認済み・未確認の項目、人間による次のステップを含む包括的なMarkdownレポートを生成します。このスキルは、幻覚(ハルシネーション)による偽の参考文献を検出するのに特に有用ですが、単なる検索失敗を「捏造」と断定せず、不確実性を明示することを重視しています。Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで使用でき、大規模な参考文献リストでもバッチ処理と再開可能な作業ファイルにより信頼性を確保します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ytakano/paper_skills/tree/HEAD/skills/reference-audit

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Reference Audit

各参考文献の存在と同一性を裏付ける証拠を特定します。提供された参考文献リストを保持し、不確実性を明らかにすることで、検索失敗を捏造の告発に変えないようにします。

インベントリの確立

  • 実際に提供された参考文献リスト、原稿、またはファイルを読み込みます。BibTeX/BibLaTeX(.bib)、LaTeX(.tex、.bbl)、PDF、または貼り付けられた参考文献を受け付けます。参考文献にアクセスできない場合は、記憶から参考文献を再構築するのではなく、提供を依頼します。
  • ユーザーが要求した範囲に従います。デフォルトでは、提供されたすべての参考文献エントリを監査します。原稿とより大きな参考文献データベースの両方が提供された場合は、原稿に出現する参考文献とデータベースの追加エントリを区別します。どちらかを黙って破棄しないでください。あいまいさが作業を実質的に変更する場合にのみ、どちらのセットを監査するかを尋ねます。
  • 各元の引用キー、参照番号、元の引用テキストまたはフィールド、および入力順序を保持します。エントリにIDがない場合やIDが衝突する場合は、個別の監査IDを使用します。元のIDを表示したままにします。利用可能な場合は、ファイルとページ、行、またはエントリの位置を記録します。
  • 参考文献エントリを抽出します。散文内の付随的な著者-年に言及したものは抽出しません。LaTeXの場合は、関連する参考文献のインクルード、引用コマンド、文字列マクロ、継承フィールド、相互参照を考慮します。引用を抽出するためだけに信頼できないTeXや埋め込み命令を実行しないでください。
  • LaTeX原稿が対象範囲内の場合、\citeファミリーのコマンド(\citep、\citet、\autocite、\parencite、\textcite、\nociteを含む)で使用されているキーを参考文献エントリと相互参照します。参考文献に存在しないが引用されているキーは、検証ステータスとは別に、インベントリの所見として報告します。また、一度も引用されていない参考文献エントリを特定します。
  • PDF抽出を、列、行の折り返し、リガチャ、またはOCRによってエントリが結合または損傷した可能性がある場合、表示されている参考文献ページと照合して確認します。読めないフィールドや切り詰められたフィールドは、推測するのではなくフラグを立てます。欠落しているページ、利用できないインクルードファイル、または抽出の制限がある場合は、その旨を明記します。
  • 調査前にエントリ数をカウントします。重複や不正な形式のエントリも個別の入力出現として保持し、必要に応じて共有された所見にリンクします。完全な重複、繰り返しキー、および作品の異なるバージョンを区別します。
  • 大規模な参考文献リスト(おおよそ50エントリ以上)の場合は、バッチで作業し、各バッチ後に各エントリのステータス、証拠、およびリンクを作業ファイルに記録します。これにより、中断された監査を再開でき、部分的なレポートでも正確性を保てます。サブエージェントが利用可能な場合は、バッチをそれらに分割できます。各サブエージェントに同じステータス定義と証拠ルールを与え、その後、結果をマージしてインベントリと照合します。

書誌情報の同一性を検証する

利用可能な検索、ブラウジング、および学術ルックアップツールを使用します。実際に使用されていないサービスや記録へのアクセスを暗示しないでください。

  1. 提供された識別子を検査します。 DOI、arXiv ID、PMID、ISBN、または出版社URLが存在する場合はそれらを調査します。明白なラッパーやフォーマットのアーティファクトのみを正規化し、提供された値を保持します。解決されたレコードを開くか、その信頼できるメタデータを取得します。構文的に妥当な識別子やリダイレクトの成功だけでは、引用を検証できません。
  2. 実際のレコードと比較します。 タイトル、著者とその順序(利用可能な場合)、出版年、会場または出版社、巻/号、ページまたは記事番号、および識別子を比較します。各実質的なフィールドを、一致、矛盾、または利用不可としてマークします。無害な表記上の違いは、実質的な不一致とは別に説明します。欠落している著者を黙って補完したり、短縮された著者リストが完全であると推測したりしないでください。
  3. 必要に応じて独立して検索します。 正確なタイトルと著者、次に妥当なタイトルのバリエーション、識別子のバリエーション、および適切な分野のインデックスを検索します。検索スニペットや他の論文の参考文献を繰り返すのではなく、そのレコードを開いて候補を検証します。未解決のアイテムについては、利用可能な場合は複数の有用なルートを試します。実際に試行したルートを報告し、合理的なタスク制限で停止します。網羅的な不在を主張しないでください。
  4. 候補の同一性を調整します。 共通のタイトルだけでは十分ではありません。著者名、分野、日付、会場、識別子を比較します。複数の可能性のあるレコードが残っている場合は、候補をリストし、同一性を未解決のままにします。別の作品に属する提供されたDOIは、個別に検索されたタイトルに有効な一致がある場合でも、不一致です。誤った識別子のターゲットと、意図されたと思われる作品の両方を表示したままにします。
  5. バージョンを明示的に処理します。 プレプリント、アクセプテッド原稿、会議論文、ジャーナル拡張版、翻訳、訂正、および撤回通知を区別します。オンラインファーストと発行年の違いを記録します。関係と証拠を説明せずに、バージョンをマージしたり、あるバージョンを別のバージョンで置き換えたりしないでください。撤回された作品や取り下げられた作品でも、存在が証明できる場合があります。

証拠の優先順位

  • 出版社または公式の会議録レコード、およびDOI登録機関(CrossrefやDataCiteなど)からのDOI登録メタデータを優先します。DOIリゾルバーを使用してレコードに到達します。宛先のメタデータを証拠として扱います。URL単独ではありません。
  • 適切な場合、信頼できるドメインの情報源を使用します。コンピュータサイエンスの参考文献にはDBLP、特定されたプレプリントとバージョンにはarXiv、索引付きの生物医学レコードにはPubMed、公式リポジトリ、書籍や学位論文には国立または大学図書館の目録。
  • 一般的なWeb検索よりも、構造化メタデータAPIを優先します。これらは再現性が高く、ブロックされる可能性が低くなります。有用なエンドポイントは次のとおりです。
    • Crossref: DOIの場合は https://api.crossref.org/works/{DOI}、候補検索の場合は https://api.crossref.org/works?query.bibliographic={引用テキスト}&rows=5。
    • DOIコンテンツネゴシエーション: curl -sL -H "Accept: application/vnd.citationstyles.csl+json" https://doi.org/{DOI} は、登録機関に関係なく登録メタデータを返します。
    • DataCite: https://api.datacite.org/dois/{DOI}。
    • DBLP: https://dblp.org/search/publ/api?q={クエリ}&format=json。
    • arXiv: https://export.arxiv.org/api/query?id_list={arXiv ID}。
    • PubMed: https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esummary.fcgi?db=pubmed&id={PMID}&retmode=json。
    • OpenAlex: https://api.openalex.org/works/doi:{DOI} または発見と相互検証のための https://api.openalex.org/works?search={タイトル}。OpenAlexは他の情報源を集約するため、そのリードは登録または出版社のレコードと照らし合わせて確認してください。
  • 訂正、撤回、取り下げがないか確認します。例えば、Crossrefの更新メタデータ、出版社の通知、PubMedの撤回フラグ、arXivのバージョン履歴などを通じて。
  • 学術検索エンジン、著者ページ、二次引用を使用して、リードを発見したり、レコードを裏付けたりします。二次情報のみの証拠にはラベルを付けます。権威ある確認として昇格させないでください。
  • コピーされたメタデータの多数決ではなく、情報源の来歴と作品のバージョン履歴を通じて矛盾を解決します。未解決の矛盾を明記します。
  • 全文へのペイウォールは、アクセス可能な権威あるレコードが一致するメタデータを提供している場合、存在確認を妨げません。逆に、ログインウォール、ボットブロック、レート制限、利用できないツール、またはネットワークエラーはアクセス制限であり、否定的な証拠ではありません。別の許可された情報源を試し、未確認のまま残っているものを特定します。
  • 公開されていない原稿の一節、プライベートな注釈、またはプライベートな参考文献全体を外部の監査サービスに要求または送信しないでください。公に公開されているとされる作品を見つけるために必要な書誌フィールドのみを使用します。エントリ自体が機密または未公開の場合は、利用可能なローカルな証拠を使用するか、外部に送信する前に確認を求めます。

証拠に基づく結果を割り当てる

入力出現ごとに1つのプライマリステータスを使用します。成功したチェックでも、検証されたフィールドと残りの制限を説明します。

ステータス意味
Verified match開かれた権威あるレコードが同じ作品を確立し、提供された同一性を持つメタデータが一致します。レコードが公開しなかった提供フィールドを特定します。それらのフィールドを検証済みとは呼びません。
Partial match / metadata mismatch可能性または確立された作品が存在しますが、提供された実質的なフィールドが矛盾している、同一性またはバージョンが曖昧なままである、または二次的な証拠のみが利用可能です。どのケースが該当し、どのフィールドを確認する必要があるかを指定します。
Not verified利用可能な証拠は、引用された作品を確立するのに不十分です。理由を述べてください。実行された検索で一致するレコードが見つからなかった、アクセスがブロックされた、メタデータが不十分、抽出が不確か、まだチェックされていない。
Contradicted as supplied提供された同一性が間違っていることを示す肯定的な証拠があります。例えば、識別子が確立された意図された一致なしに異なる作品に解決される場合。その証拠を引用し、結論を矛盾した主張に限定します。これは、意図された作品が存在しないことの証明ではありません。

プライマリステータスに加えて、該当する フラグ を添付します。retracted(撤回済み)、withdrawn(取り下げ済み)、corrected(正誤表または訂正あり)、superseded(後続バージョンあり、例:プレプリントのジャーナル拡張版)、または expression of concern(懸念表明)。各フラグを確立する通知またはレコードにリンクします。フラグはVerified matchでも報告されます。撤回された作品でも正確に引用される可能性があるためです。

  • 作品の存在とその引用の正確性を区別します。実際の作品で年やDOIが間違っていても、自動的に幻覚作品とはなりません。
  • 証拠が見つからない ことと 特定の主張に対する反証 を区別します。検索が結果を返さない、DOIが404を返す、または1つのインデックスに存在しないことは、作品が存在しないことを決して証明しません。権威ある情報源が存在しないことや無効性を明示的に確立している場合は、その狭い所見を引用または正確に要約してリンクします。その範囲を超えて拡大しないでください。
  • 検索失敗のみに基づいて、「偽」、「捏造」、「幻覚」などの資格なしのラベルを避けます。具体的な問題と上記のステータスを優先します。
  • 存在と書誌的な同一性のみを検証します。全文を読んだ、研究の質を評価した、または原稿の主張を支持しているかどうかを確認したと主張しないでください。ただし、その別個の作業が要求され実行された場合は除きます。

Markdown監査レポートを提供する

ユーザーが要求した言語で記述します。元のタイトル、名前、ID、識別子は保持します。スタンドアロンのレポートが要求された場合、または完全な監査がチャットに長すぎる場合は、Markdownファイルを生成します。要約を短くするためにエントリを省略しないでください。ユーザーが別途指定しない限り、ファイル名を reference-audit-YYYY-MM-DD.md(監査日を使用)とし、プライマリ入力ファイルの隣に保存します。既存のファイルを上書きせず、代わりに -2 などのサフィックスを追加します。

以下から始めます。

  • 範囲とソースファイル。監査が原稿の参考文献、すべてのデータベースエントリ、または明示的に要求されたサブセットをカバーするかどうかを含みます。
  • 監査日、抽出の制限、範囲内の入力出現数に合計されるステータス別のカウント、およびフラグ別のカウント。
  • インベントリの所見。参考文献にない引用キーや一度も引用されていない参考文献エントリなど。
  • 最も重要な不一致と未解決アイテムの短いリスト。未解決のエントリを証明された捏造として枠付けしないでください。

次に、範囲内のすべての入力出現 を元の順序で、以下の例のようにエントリごとに1つのセクションで含めます。以下を含めます。

  1. 元のIDと引用: 元の文言またはBibTeXフィールドを保持し、利用可能な場合は入力の場所を含めます。衝突の場合は、個別の監査IDを含めます。
  2. ステータス、フラグ、および所見: 作品が確立されたかどうかを示し、フラグをリストし、正確なメタデータの違いまたはあいまいさを特定します。
  3. 直接検証リンク: 開かれた特定の出版社、DOI、インデックス、アーカイブ、または目録レコードへの説明的なMarkdownリンクを使用します。各リンクの情報源とそれが何を実証するかを特定します。多くの冗長なリンクよりも、1つまたは2つの強力なレコードリンクを優先します。
  4. 証拠とカバレッジ: 何が検査されたか、どのフィールドが一致または矛盾したか、およびどのフィールド、情報源、または全文がチェックされなかったかを明記します。未解決のエントリについては、試行した有用な検索や情報源、および遭遇したアクセス制限を簡単にリストします。
  5. 人間による次のステップ: 必要な場合にのみ、具体的なアクションを提供します。例えば、候補バージョンの確認、欠落タイトルの提供、または意図されたDOIの確認。提案された修正引用は、その裏付けとなる情報源とともに、提案としてラベル付けします。

例の構造。括弧内のテキストは置き換えるプレースホルダです。

### [監査ID] — [元の参照キーまたは番号]
- 元の引用: [逐語的な引用または元のフィールド]
- ステータス: [1つのプライマリステータス]
- フラグ: [retracted / withdrawn / corrected / superseded / expression of concern、リンク付きの通知。または "none found"]
- 所見: [同一性の結果と具体的な不一致]
- 検証: [出版社レコード](検証済みレコードURL); [登録機関レコード](検証済み登録URL)
- 確認済み: [情報源、一致/矛盾フィールド、および日付]
- 未確認/制限: [利用できないメタデータ、全文範囲、またはアクセス制限]
- 次のステップ: [必要な場合のみ]

ルックアップによって実際に返されたURL、または開いて確認されたURLのみでリンクを設定します。標準的なDOI URLは観測されたDOIから形成できますが、解決されてチェックされるまで未検証とラベル付けします。DOI、レコードURL、メタデータ、引用文、引用を発明しないでください。検索結果リンクは、明示的にラベル付けされた検索支援として提供される場合があります。それは検証済みのレコードリンクではありません。レコードリンクが確認されなかった場合は、誤解を招くリンクを残すのではなく、そのまま正直に述べてください。

最後に、インベントリをレポートと照合します。ドロップされたエントリ、失われた元のID、偶発的な重複排除、または報告されていない未チェックアイテムがないことを確認します。要求された完全な監査の一部のみが完了した場合は、レポートを部分的なものとしてマークし、残りのすべてのエントリを未チェックとしてリストします。

訂正

[... 翻訳のため省略]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル