Communitygithub.com

flyer-Li/paper-analyst

学術論文や研究PDFを解析します。ユーザーが論文をアップロードまたは貼り付けて内容を理解したい場合に使用します。

paper-analyst とは?

Paper Analyst は、PDF や貼り付けられたテキストから学術論文を解析するスキルです。デフォルトの出力言語は中国語で、`references/output-schema.md` に従った構造化された分析を提供します。解析を始める前に、入力品質の評価と論文種類の分類(`references/paper-type-rubric.md` を使用)を実行し、幻覚(ハルシネーション)防止ルール(`references/quality-checklist.md`)を厳守します。標準モードに加え、クイックモード、拡張モード(著者の過去の研究を含む)、プレゼンテーションモード(スライド計画の生成と pptx スキルへの受け渡し)をサポートしており、ユーザーの要求に応じて切り替えることができます。解析結果の各主張にはソースタグ(`[原文声明]` または `[模型归纳]`)が付けられ、不確かな情報は明示的にマークされるため、信頼性の高い分析が可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/flyer-Li/paper-analyst/tree/main

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

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

ドキュメント

Paper Analyst

学術論文を PDF または貼り付けられたテキストから解析します。デフォルトの出力は中国語です。 すべての出力は references/output-schema.md に従います。論文の種類の検出には references/paper-type-rubric.md を使用します。幻覚防止ルールは references/quality-checklist.md に従います。

クイックリファレンス

ファイル目的
references/output-schema.mdセクション構成とフィールドルール
references/paper-type-rubric.md論文の種類の分類方法
references/quality-checklist.md幻覚防止チェックリスト
references/presentation-schema.mdスライド計画の JSON スキーマ
references/presentation-style-guide.mdスライド用の内容圧縮ルール
references/pptx-handoff.mdpptx スキルを呼び出す方法
scripts/extract_pdf_meta.pyオプション:PDF メタデータを JSON に抽出

モード選択

デフォルトモード:standard。ユーザーのリクエストから検出します:

モードトリガー出力
quick"quick", "简单说", "一句话", "简要"ヘッダー + 情報 + アブストラクト + 3つの貢献
standard(デフォルト)完全な分析:セクション1~5
extended"前作", "课题组", "prior work"standard + 著者/研究グループの過去の研究
presentation"PPT", "组会", "汇报大纲", "slides"standard + スライド概要
presentation_with_figures"图表", "figures", "带图", "关键图"presentation + 図の注釈

曖昧な場合は standard を使用し、切り替えを提案します。

ワークフロー

ステップ 1: 入力品質の評価

分析前に PDF の品質を分類します:

  • 良好: 全文抽出可能
  • 品質低下: 部分的なテキスト、スキャンされたセクション、文字化け
  • 深刻な品質低下: テキストが最小限、画像のみの PDF

品質低下の場合:理由をヘッダー行に記載し、利用可能な内容で進め、すべてのギャップを明示的にマークします。ギャップを埋めるために内容を捏造しないでください。

オプション:ユーザーが Python を使用できる場合、最初に scripts/extract_pdf_meta.py を実行して構造化メタデータを取得することを提案します。

ステップ 2: 論文の種類を分類

references/paper-type-rubric.md を読み、分類します。AI/ML を仮定しないでください。分類ラベルと2~3の根拠となる指標を出力してから先に進みます。

ステップ 3: 解析を実行

選択したモードに応じて references/output-schema.md に従います。すべてのセクションで references/quality-checklist.md のすべてのルールを適用します。

ステップ 4: 出力前の自己チェック

最終決定前に確認:

  • 不確かなフィールドはすべて [不确定] または [未明确给出] とマークされていること
  • すべての貢献に [原文声明] または [模型归纳] のタグが付いていること
  • 省略されたセクションがないこと——スキップしたセクションにはその理由を記載
  • 論文種類ラベルがルーブリックの根拠と一致していること

幻覚防止ルール

完全なルールは references/quality-checklist.md にあります。譲れない制約:

  1. ソースタグ付け: [原文声明] = 論文に直接記載されている(引用箇所を明記);[模型归纳] = モデルが推論したもの(推論根拠を記載)
  2. 不確実性: 記載がない場合は [未明确给出];曖昧な場合は [不确定]
  3. ドメイン想定禁止: 常に最初に論文の種類を分類する
  4. 捏造禁止: 会場、DOI、年、所属機関がテキストにない場合は [未明确给出]
  5. 根拠の紐付け: 各貢献はセクション/図/表/引用を引用すること
  6. 品質低下PDF: どのセクションが読めなかったかを明記;ギャップを埋めない

品質低下入力のフォールバック

状況対応
アブストラクトのみ利用可能quick モード、制限を明記
スキャンPDF、テキストなし最初にユーザーにテキストまたはOCRを依頼
参考文献セクションがない過去研究分析をスキップ、不在を明記
図が読めない図分析をスキップ、不在を明記
非英語論文主要セクションを翻訳、元の言語を明記

拡張モード: 著者の過去の研究

extended モードのみ:

  1. 論文からすべての著者名を抽出
  2. 参考文献リストから自己引用を特定(著者が共通)
  3. 所属機関と論文タイトルから研究グループの焦点を推論
  4. 参考文献リストからのみ過去研究を一覧表示——ウェブ検索、外部知識は使用しない
  5. すべての出力にタグ付け:[基于论文内引用,非外部检索]
  6. 情報が不十分な場合:「情報不足により、過去の研究との関係を判断できません」と明示

プレゼンテーションモード: PPT 生成

presentation または presentation_with_figures モードのみ。

ステップ A: オーバーライドの収集

スライド計画を構築する前に、ユーザーが次のいずれかを指定しているか確認します:

  • audience (研究室 / 学会 / 一般) — デフォルト: lab
  • duration_hint (10分 / 20分 / 30分) — デフォルト: 20min
  • talk_style (技術的 / 概要 / 議論) — デフォルト: technical
  • emphasis (拡張するセクション)
  • skip (省略するセクション)

指定がない場合は、黙ってデフォルトを使用します。

ステップ B0: PDF 図の抽出 (presentation_with_figures のみ)

スライド計画を構築する前に、以下を実行します:

python scripts/extract_pdf_figures.py <pdf_path>

これにより、すべての図が figures/ に保存され、各画像の name、path、page を含む figures/index.json が書き込まれます。ハンドオフで figure_ref パスを割り当てるときにこのインデックスを使用します。

ステップ B: スライド計画の構築

構造については references/presentation-schema.md に従います。 圧縮ルールについては references/presentation-style-guide.md に従います。

  • 各スライドの役割を対応する output-schema セクションにマッピング
  • ユーザーのオーバーライドを適用(emphasis → 拡張、skip → 省略)
  • presentation_with_figures の場合:図が主要な根拠となるメソッド/結果スライドで figure_needed: true を設定;figure_ref と figure_hint を追加
  • スライド数は duration_hint に従う(10分→6-7、20分→9-10、30分→12-14)

ステップ C: pptx スキルを呼び出す

正確なハンドオフ形式については references/pptx-handoff.md に従います。

  • pptx に渡す前に [原文声明] / [模型归纳] タグをすべて削除
  • ハンドオフに発表者ノートを含めない
  • pptx スキルを自動的に呼び出す——ユーザーに事前に尋ねない
  • 例外:ユーザーが「只要大纲」/「just the outline」と言った場合、スライド計画をテキストとして出力し、pptx をスキップ

関連スキル