Alitaliy/summarize-paper-skill

論文の要約

概要

このスキルは、ユーザーが提供したソースから1つの学術論文を要約します。論文の目的、主な貢献、技術、限界、将来の展望を抽出し、ファイルを作成できる環境ではMarkdown要約とExcelワークブックの両方を出力します。

基本ルール

• すべての事実主張は提供された論文に基づいてください。ユーザーが明示的に要求しない限り、外部の背景、著者の意図、影響の主張、または分野のコンテキストを追加しないでください。
• 論文に記載された内容と推測を分離します。各項目を「原文明確」、「原文概括」、「合理推測」、または「未提及」としてマークします。
• 「合理推測」は、論文がその項目を直接述べていないが、その推測が近くの方法、結果、限界、または結論のテキストから導かれる場合にのみ使用します。
• 推測の表現は慎重に行い、「可推測」、「可能」、「傾向説明」、「未来可進一步」などのフレーズを使用します。
• 過度に解釈しないでください。証拠が弱い場合は、項目を「未提及」とマークするか、証拠列で不確実性を説明します。
• 論文が実際に述べている重要な詳細（タスク設定、データセット、モデル/フレームワーク、実験設定、評価指標、名前付き技術など）を保持します。
• 長い引用ではなく、短い証拠参照を使用します。可能な場合は、ページ、セクション、表、図、段落アンカーを優先します。
• 論文テキストが不完全、スキャン品質が低い、または抽出品質が悪い場合は、要約の前にその制限を述べ、確信を持った主張でギャップを埋めないようにします。
• ユーザー向けMarkdownでは、コンテンツを6つの必須次元でグループ化し、同じ次元の下で複数の主張を箇条書きで示します。「研究目的」、「主要貢献」などの繰り返しの次元を別々の視覚的セクションとして提示しないでください。
• トレーサビリティのために構造化JSON/Excel行を主張レベルで保持しますが、行は次元順に並べ、ダウンストリームのページがクリーンにグループ化できるようにします。

ワークフロー

1. 論文のソースタイプ（PDF、DOCX、Markdown、プレーンテキスト、貼り付けられた抜粋、または抽出されたテキスト）を特定します。
2. 最初に要約、序論、方法、実験/結果、議論、限界、結論を読みます。
3. 残りの本文をスキャンして、必要なカテゴリに影響を与える主張を見つけます。
4. 最終的な要約を作成する前に、証拠アンカー付きの主張リストを作成します。
5. 必須の次元を埋めます：
   • 研究目的
   • 主要貢献
   • 使用技術/方法
   • 実験與結果
   • 不足/局限
   • 未来前景/後續工作
6. 各次元について、論文に明示的に存在するすべての重要なポイントを含めます。
7. すべての原文コンテンツ項目の後にのみ慎重な推測項目を追加し、「合理推測」として明確にラベル付けします。
8. 最初にMarkdown出力を生成し、次元見出しの下に主張リストをグループ化します。
9. ファイル作成が可能な場合は、scripts/write_paper_summary_excel.pyを使用してExcel出力を作成します。
10. ファイル作成が可能な場合は、scripts/archive_summary_outputs.pyを使用して生成されたMarkdown、JSON、Excelファイルをアーカイブし、文献管理ウェブページが新しい論文を自動的に発見できるようにします。1つの論文フォルダにソースPDF/テキスト抽出と生成された要約出力を含むローカル構造を推奨します。ウェブページは要約出力ファイルのみをインポートします。

Markdown出力

以下の構造を使用します：

# 論文總結：<論文タイトルまたはユーザー提供のファイル名>

## 基本情報

- タイトル：
- 著者：
- 年/会議またはジャーナル：
- 研究分野：
- 資料完全性の説明：

## 総覽

<論文が解決する問題、方法、結論を3〜6文で要約します。原文でサポートされている情報のみを記述します。>

## 逐項總結

### 研究目的
- 【原文明確｜高】...（根拠：Abstract; Introduction）
- 【原文概括｜高】...（根拠：Introduction）

### 主要貢献
- 【原文明確｜高】...（根拠：Contribution bullets）

### 使用技術/方法
- 【原文明確｜高】...（根拠：Method）

### 實驗與結果
- 【原文明確｜高】...（根拠：Experiments; Table 1）

### 不足/局限
- 【原文明確｜高】...（根拠：Limitations; Conclusion）

### 未来前景/後續工作
- 【原文明確｜高】...（根拠：Conclusion）

## 推測內容清單

| 推測項目 | 推測根拠 | 信頼度 | 後期核查建議 |
|---|---|---|---|
| ... | ... | 高/中/低 | ... |

## 注意すべき原文の制限
- ...

ガイドライン：

• オリジナルと推測の内容を視覚的に区別するため、各箇条書きの先頭にタイプと信頼度を記述します。例：「【原文明確｜高】」。
• 各必須次元は見出しとして1回だけ表示します。その見出しの下に複数のポイントを箇条書きにします。
• ある次元に論文内でサポートがない場合は、「【未提及｜】」というラベルの付いた箇条書きを1つ含め、論文が情報を提供していないことを説明します。
• 慎重な推測が有用な場合にのみ、別の「合理推測」箇条書きを追加し、それを「推測內容清單」にもリストします。
• 「推測內容清單」は空の場合でも含めます。推測を使用しなかった場合は「無」と記述します。
• Markdownでグループ化された箇条書きとJSON/Excelの主張行は、Markdownが読みやすさのためにグループ化されていても、同じ基礎となる主張を記述している必要があります。

Excel出力

ユーザーがExcel出力を要求した場合、またはファイルを作成できる場合、Markdownに加えて.xlsxワークブックを生成します。

「論文總結」という名前の1つのワークシートを使用し、以下の列を持ちます：

• 維度
• 類型
• 總結
• 原文根拠/推測根拠
• 信頼度
• 後期核查建議

scripts/write_paper_summary_excel.pyを使用してJSONファイルからワークブックを作成します：

python scripts/write_paper_summary_excel.py summary.json paper_summary.xlsx

期待されるJSON構造：

{
  "paper_title": "Paper title",
  "authors": "Author A; Author B",
  "venue": "Journal or Conference; Year",
  "year": "2026",
  "field": "Research field",
  "overview": "A short paper-level overview for the literature manager card.",
  "rows": [
    {
      "dimension": "研究目的",
      "basis_type": "原文明確",
      "summary": "What the paper states.",
      "evidence": "Abstract; Introduction.",
      "confidence": "高",
      "review_suggestion": ""
    }
  ]
}

JSONとExcelの行を主張レベルのレコードとして保持し、6つの必須次元順に並べます。利用可能な場合は上記の論文レベルのJSONフィールドを含め、文献管理ウェブページが主張行から推測する代わりに、タイトル、会場/年、トピック、短い概要を持つコンパクトなカードをレンダリングできるようにします。

ライブラリアーカイブ出力

Markdown、JSON、Excel出力を作成した後、動的な文献管理ウェブページ用にアーカイブします：

python scripts/archive_summary_outputs.py summary.json paper_summary.md paper_summary.xlsx

アーカイブ動作：

• SUMMARIZE_PAPER_LIBRARY_DIRが設定されている場合、そのディレクトリにアーカイブします。
• それ以外の場合、Documentsフォルダが存在するときは~/Documents/summarize-paper-library/inboxにアーカイブします。
• それ以外の場合は~/.summarize-paper-library/inboxにアーカイブします。
• 各論文を安定した論文タイトルのサブフォルダに配置し、summary.json、summary.md、summary.xlsx、manifest.jsonを一緒に保持します。
• フォルダ名を手動でキュレーションされたpaper/<paper folder>/...ライブラリと一致させたい場合は、--folder-name "Author - Year - Title"を使用します。
• バージョン管理された実行を別々のフォルダに保持する必要がある場合にのみ、--timestampedを使用します。

ウェブページはアーカイブの受信箱または親のpaperフォルダを監視し、新しいスキル出力が表示されると自動的にリフレッシュできます。サブフォルダを再帰的にスキャンし、summary.*、paper_summary.*、および*_paper_summary.*ファイルのみをインポートし、PDFや抽出されたテキストファイルは無視します。

品質チェック

終了する前に：

• 各必須次元がMarkdown見出しとして正確に1回存在することを確認します。
• 次元内の複数のポイントが、繰り返される次元ブロックではなく、その見出しの下の箇条書きであることを確認します。
• すべての事実要約項目に証拠アンカーがあることを確認します。
• すべての推測項目が「合理推測」とラベル付けされていることを確認します。
• 推測項目が「原文明確」または「原文概括」の行に混在していないことを確認します。
• JSONとExcelの主張行がグループ化されたMarkdownの箇条書きと一致することを確認します。
• 欠落しているソース情報が、捏造される代わりに「未提及」とマークされていることを確認します。
• ファイル作成が可能な場合、生成されたファイルが文献管理ウェブページ用にアーカイブされていることを確認します。