mcpField
P
paper-source-trace

paper-source-trace

github.com/aminerorg生産性6438 回インストール今日更新
リポジトリ

paper-source-trace について

Paper Source Trace は、対象論文の主張から引用元をたどり、根拠に基づく分析成果物を作成する研究スキルです。ローカルの証拠、不確実性の記録、構造化された引用グラフを重視します。

主な機能

  1. 01主張を軸にした出典追跡
  2. 02引用意図の分類
  3. 03機械可読な引用グラフ
  4. 04SVG とインタラクティブ HTML の図
  5. 05任意の AMiner メタデータ補完

活用シーン

  1. 01論文の主張を裏付ける証拠の追跡
  2. 02引用の役割と文脈の確認
  3. 03引用関係の可視化

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aminerorg/aminer-open-skill --skill paper-source-trace

インストール後、Claude Code で/paper-source-traceを入力して読み込まれたか確認します。

詳細

Paper Source Trace

Paper Source Trace は、1 本の対象論文から、根拠に基づくクレーム中心の出典追跡アーティファクトを生成します。正規のスキル名 paper-source-trace を 1 つだけ使用します。

自然言語または /paper-source-trace で呼び出します。

言語の振り分け

  • ユーザーが主に中国語で書いている場合、または中国語での出力を明示的に求めている場合は、SKILL.zh.md を使用します。
  • それ以外のすべてのリクエストでは、この SKILL.md を使用します。
  • どちらのワークフローでも、json/graph/citation_graph.json のキー、インテントラベル、関係タイプ、出典の役割、パラメーター名は英語のままにします。

英語ワークフロー

標準アーティファクト

根拠とファイルシステムへのアクセスが許す場合、以下のアーティファクトを作成します。

  • analysis.md：人が読めるレポート。
  • json/graph/citation_graph.json：references/schema.md に準拠した、正規の機械可読グラフ。
  • citation_map.svg：SVG 生成が可能な場合の静的な引用マップ。
  • citation_map.html：グラフデータが利用できる場合の単一ファイル形式のインタラクティブなグラフ。
  • citation_map_chain.svg：svg: both の場合のみ生成する、チェーン形式の出典追跡 SVG。
  • citation_map_spec.md：SVG 生成に制約がある場合、または失敗した場合のみ生成します。

デフォルトの出力ディレクトリ：

outputs/paper-source-trace/<safe-paper-stem>/

推奨レイアウト：

analysis.md
citation_map.svg
citation_map.html
citation_map_chain.svg          # only when svg is both
citation_map_spec.md            # only when SVG generation has caveats or fails
json/graph/citation_graph.json
json/aminer/*.json              # only when AMiner raw results are saved
json/extraction/*.json          # only when structured intermediates are saved

レガシー互換性：ユーザーが mode: current と記述した場合は svg: radial として扱い、mode: example は svg: chain、mode: all は svg: both として扱います。svg と mode の両方が指定されていて、互いに矛盾する場合は、意図する SVG 出力をユーザーに確認します。hybrid、interactive graph、または expandable knowledge graph は、標準の citation_map.html を求めていることを意味します。これらは SVG モードではなく、SVG の選択には影響しません。

起動時の確認

論文を読む前、引用を抽出する前、AMINER_API_KEY を確認する前、AMiner を呼び出す前、または SVG を生成する前に、以下をユーザーに確認します。

  • SVG 出力：radial、chain、both のいずれか。
  • AMiner による拡充：on または off。

ユーザーがいずれか、または両方の値をすでに指定している場合は、暫定値として改めて提示し、最終確認を求めます。ユーザーが回答するまで作業を停止します。

対話形式での確認が実際に不可能な場合は、推奨されるデフォルト値として svg: both と aminer: on を使用します。それでも、¥5 以上と見積もられる AMiner 呼び出しの前には、高コスト時の確認ルールに従います。AMINER_API_KEY がない場合は、AMiner による拡充をスキップし、ローカル分析を続行します。

基本ルール
  1. 根拠として使用できるのは、提供された論文本文、引用コンテキスト、参考文献項目、ユーザーノート、または明示的に要求された AMiner の結果のみです。
  2. 分野に関する記憶だけから引用意図を推測しないでください。
  3. AMiner による拡充は、明示的なオプトインがある場合に限ります。要求がない限り、AMINER_API_KEY を確認しないでください。
  4. AMiner は ID、URL、参考文献の候補照合、外部の引用関係を補完できますが、ローカルの引用コンテキストを置き換えたり、それだけで引用意図や出典追跡を証明したりすることはできません。
  5. 不確実性を保持してください。引用コンテキスト、参考文献の照合、または出典の役割を示す根拠が不完全な場合は、確信度を下げてください。
  6. citation_sentence と context は、対象論文の原文言語のままにしてください。これらは説明の翻訳ではなく、根拠となる原文のアンカーです。
  7. evidence、summary、notes、Markdown レポートのテキスト、SVG/HTML の表示 UI には、ユーザーが指定した出力言語を使用してください。
  8. 出力ファイルを書き込める場合は、チャットのみの要約で終わらせないでください。
AMiner の情報補完

確認が可能な場合、ユーザーが aminer: on を確認するか、enhance with AMiner、use AMiner metadata、complete paper_id、または trace AMiner citation relationships と明示的に記述しない限り、AMiner は off として扱います。確認が実際に不可能な場合は、aminer: on を推奨される代替設定とします。

有効にした場合：

  1. AMINER_API_KEY が存在するかどうかだけを確認します。トークンは決して出力しないでください。
  2. 見つからない場合はローカル分析を続行し、情報補完をスキップしたことを記録します。
  3. 実行可能な最短の呼び出し順を使用します：paper_search または paper_search_pro、paper_detail、paper_relation、paper_info。
  4. 予定または完了したすべての AMiner 呼び出しについて、コストの概要を出力します。
  5. 推定コストが ¥5 以上の場合、有料の呼び出しを行う前に明示的な確認を求めます。
  6. 情報補完のメタデータを json/graph/citation_graph.json の metadata.aminer_enrichment に記録します。
意図ラベル

ユーザーが明示的に分類体系を拡張しない限り、次のラベルのみを使用します。

background、problem、core-method、supporting-method、dataset、metric、baseline、tool-resource、theory、result-evidence、limitation、future-work。

実行手順
  1. 起動時の確認質問をして、回答を待ちます。
  2. 入力証拠と出力ディレクトリを確定します。
  3. 信頼できる論文本文、参考文献項目、引用コンテキストを抽出します。
  4. 重要な分類や出典の追跡を行う前に、references/evidence_protocol.md を読みます。
  5. 使用可能な意図ラベルで引用を分類します。
  6. テキストで裏付けられる場合、対象論文の主要な主張や貢献を抽出します。
  7. 主張をローカルの引用コンテキスト、引用元の役割、証拠の各ステップに結び付けて、source_traces[] を作成します。
  8. 対象論文の説明に役立つエンティティと関係を抽出します。
  9. AMiner が有効な場合、ローカルの証拠を置き換えずにメタデータを補完します。
  10. 視覚的な成果物より先に、json/graph/citation_graph.json を書き出します。
  11. analysis.md を書き出します。references/analysis_template.md は、テンプレートまたは固定形式が明示的に指定された場合にのみ使用します。
  12. 確認済みの SVG 出力と citation_map.html を、1 つのレンダラーコマンドで生成します：python3 scripts/render_html.py --graph <output>/json/graph/citation_graph.json --output <output>/citation_map.html --svg <radial|chain|both> --language auto。
  13. 場当たり的な SVG や HTML を手書きしないでください。静的な SVG の両モードと HTML の radial / chain ビューで、レンダラーのレイアウト、色、言語パック、テキストの折り返し、ノードの優先順位、エッジのルールを共通で使用する必要があります。
  14. 最終回答の前に成果物を検証します。
参照ファイル
  • references/schema.md：正規スキーマと JSON の例。
  • references/evidence_protocol.md：証拠と不確実性のルール。
  • references/prompts.md：英語および中国語の抽出・レビュー用プロンプト。
  • references/visual.md：SVG および HTML グラフのルール。
  • references/analysis_template.md：明示的なテンプレートモードで使用する固定レポートテンプレート。
  • scripts/render_html.py：標準グラフレンダラー。citation_map.html、citation_map.svg、citation_map_chain.svg にはこのレンダラーを使用してください。場当たり的な SVG や HTML を手書きしないでください。
品質チェック
  • すべての引用に intent、evidence、confidence、および reference_id または unmatched_reference: true が含まれています。
  • すべてのインテントラベルが許可リストに含まれています。
  • 重要な引用は、引用文またはローカルコンテキストにたどれるようになっています。
  • citation_sentence と context には対象論文の原文を保持し、説明フィールドのみをローカライズします。
  • すべてのエンティティが少なくとも1つの引用によって裏付けられています。
  • すべてのソーストレースが、少なくとも1つのローカル引用コンテキストに基づいています。AMiner のメタデータだけを根拠にしてはいけません。
  • json/graph/citation_graph.json の書き込み後、scripts/render_html.py を使用して citation_map.html と SVG マップを生成します。HTML と SVG は、表示言語、正規グループラベル、ノードの順位付け、およびエッジを削減するレイアウト戦略を統一してください。
  • 静的 SVG では有用な主要エッジのみを使用し、密集したグループは +N で要約し、引用同士を結ぶクロスリンクや AMiner のみに基づく関係線を避けてください。
  • Markdown、SVG、HTML に注意事項があっても、json/graph/citation_graph.json は完全な状態を保ちます。

コメント

Markdown 対応