Community寫作與編輯github.com

學術論文摘要技能

Codex 技能,用於忠實地摘要學術論文,並輸出 Markdown 和 Excel 格式。

學術論文摘要技能 是什麼?

此技能專為 AI 代理(例如 Codex)設計,用於從使用者提供的來源摘要一篇學術論文。它能提取論文的研究目的、主要貢獻、使用技術、實驗結果、限制與未來展望,並在環境允許建立檔案時,同時輸出結構化的 Markdown 摘要和 Excel 活頁簿。該技能嚴格要求基於原文的事實性,並明確區分原文陳述、推論與未提及的項目,以避免過度解讀。此外,它支援將產出的摘要檔案自動歸檔至指定的文獻庫目錄,方便網頁端動態管理與瀏覽。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add Alitaliy/summarize-paper-skill

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

摘要論文

總覽

使用此技能來摘要使用者提供來源的一篇學術論文。從論文中提取其研究目的、主要貢獻、技術、限制與未來展望,然後在環境允許建立檔案時,輸出 Markdown 摘要和 Excel 活頁簿。

核心規則

  • 每個事實性陳述都必須基於所提供的論文。除非使用者明確要求,否則不要添加外部背景、作者意圖、影響力聲明或領域脈絡。
  • 區分論文陳述的內容與推論。將每個項目標記為 原文明確、原文概括、合理推測 或 未提及。
  • 僅在論文未直接陳述該項目,但推論可從鄰近的方法、結果、限制或結論文字中合理得出時,才使用 合理推測。
  • 推論用語應保持謹慎,使用諸如 可推測、可能、傾向於說明 或 未來可進一步 等詞彙。
  • 不要過度解讀。如果證據薄弱,請將該項目標記為 未提及,或在證據欄位中說明不確定性。
  • 保留論文實際陳述的重要細節,包括任務設定、資料集、模型/框架、實驗設定、評估指標以及在相關處提及的命名技術。
  • 使用簡短的證據引用,而非長篇引文。儘可能使用頁碼、章節、表格、圖表或段落錨點。
  • 如果論文文字不完整、為掃描版或文字提取品質不佳,請在摘要前說明此限制,並避免用確信的陳述填補空白。
  • 在面向使用者的 Markdown 中,按六個必要維度對內容進行分組,並在同一維度下以條列方式呈現多項陳述。不要將重複的 研究目的、主要貢獻 或其他重複維度呈現為獨立視覺區塊。
  • 為確保可追溯性,在結構化的 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 檔案歸檔,以便文獻管理網頁可以自動發現新的論文。偏好使用一個本地結構,其中一個論文資料夾包含來源 PDF/文字提取檔以及生成的摘要輸出;網頁將僅匯入摘要輸出檔案。

Markdown 輸出

使用此結構:

# 論文總結:<論文標題或使用者提供的檔案名稱>

## 基本資訊

- 標題:
- 作者:
- 年份/會議或期刊:
- 研究領域:
- 資料完整性說明:

## 總覽

<用 3-6 句話概括論文解決的問題、方法和結論。只寫原文可支持的信息。>

## 逐項總結

### 研究目的
- 【原文明確|高】...(依據:Abstract; Introduction)
- 【原文概括|高】...(依據:Introduction)

### 主要貢獻
- 【原文明確|高】...(依據:Contribution bullets)

### 使用技術/方法
- 【原文明確|高】...(依據:Method)

### 實驗與結果
- 【原文明確|高】...(依據:Experiments; Table 1)

### 不足/局限
- 【原文明確|高】...(依據:Limitations; Conclusion)

### 未來前景/後續工作
- 【原文明確|高】...(依據:Conclusion)

## 推測內容清單

| 推測項 | 推測依據 | 置信度 | 後期核查建議 |
|---|---|---|---|
| ... | ... | 高/中/低 | ... |

## 需注意的原文限制
- ...

指南:

  • 透過在每個條目的開頭放置類型和置信度(例如 【原文明確|高】),使原文和推論內容在視覺上保持區別。
  • 每個必要維度應作為標題出現一次。將該標題下的多個要點作為條列項。
  • 如果某個維度在論文中沒有支撐,請包含一個標記為 【未提及|】 的條目,並說明論文未提供該資訊。
  • 僅在謹慎的推論有用時,才添加單獨的 合理推測 條目,並同時將其列在 推測內容清單 中。
  • 即使 推測內容清單 為空也要包含它;如果沒有使用任何推論,請填寫 無。
  • 分組的 Markdown 條列項和 JSON/Excel 的聲明列必須描述相同的基本聲明,即使 Markdown 為了可讀性而進行了分組。

Excel 輸出

當使用者要求 Excel 輸出,或當可以建立檔案時,除了 Markdown 之外,還要產出一個 .xlsx 活頁簿。

使用一個名為 論文總結 的工作表,包含以下欄位:

  • 維度
  • 類型
  • 總結
  • 原文依據/推測依據
  • 置信度
  • 後期核查建議

使用 scripts/write_paper_summary_excel.py 從 JSON 檔案建立活頁簿:

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

預期的 JSON 結構:

{
  "paper_title": "論文標題",
  "authors": "作者A; 作者B",
  "venue": "期刊或會議; 年份",
  "year": "2026",
  "field": "研究領域",
  "overview": "供文獻管理器卡片使用的簡短論文級別概述。",
  "rows": [
    {
      "dimension": "研究目的",
      "basis_type": "原文明確",
      "summary": "論文陳述的內容。",
      "evidence": "Abstract; Introduction.",
      "confidence": "高",
      "review_suggestion": ""
    }
  ]
}

保持 JSON 和 Excel 列為聲明級別的記錄,按六個必要維度排序。當可用時,包含上述論文級別的 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 "作者 - 年份 - 標題"。
  • 僅在需要將版本化運行保留在單獨的資料夾中時,才使用 --timestamped。

網頁可以監控歸檔收件匣或上層的 paper 資料夾,並在新的技能輸出出現時自動重新整理。它會遞迴掃描子資料夾,並僅匯入 summary.*、paper_summary.* 和 *_paper_summary.* 檔案,忽略 PDF 和提取的文字檔案。

品質檢查

在完成之前:

  • 確認每個必要維度作為 Markdown 標題恰好出現一次。
  • 確認一個維度內的多個要點是該標題下的條列項,而不是重複的維度區塊。
  • 確認每個事實性摘要項目都有一個證據錨點。
  • 確認每個推論項目都被標記為 合理推測。
  • 確認沒有推論項目被混入 原文明確 或 原文概括 行中。
  • 確認 JSON 和 Excel 的聲明列與分組的 Markdown 條列項相互對應。
  • 確認缺失的來源資訊被標記為 未提及 而非憑空捏造。
  • 確認當環境允許建立檔案時,生成的檔案已歸檔至文獻管理網頁。

相關技能