摘要論文
總覽
使用此技能來摘要使用者提供來源的一篇學術論文。從論文中提取其研究目的、主要貢獻、技術、限制與未來展望,然後在環境允許建立檔案時,輸出 Markdown 摘要和 Excel 活頁簿。
核心規則
- 每個事實性陳述都必須基於所提供的論文。除非使用者明確要求,否則不要添加外部背景、作者意圖、影響力聲明或領域脈絡。
- 區分論文陳述的內容與推論。將每個項目標記為
原文明確、原文概括、合理推測或未提及。 - 僅在論文未直接陳述該項目,但推論可從鄰近的方法、結果、限制或結論文字中合理得出時,才使用
合理推測。 - 推論用語應保持謹慎,使用諸如
可推測、可能、傾向於說明或未來可進一步等詞彙。 - 不要過度解讀。如果證據薄弱,請將該項目標記為
未提及,或在證據欄位中說明不確定性。 - 保留論文實際陳述的重要細節,包括任務設定、資料集、模型/框架、實驗設定、評估指標以及在相關處提及的命名技術。
- 使用簡短的證據引用,而非長篇引文。儘可能使用頁碼、章節、表格、圖表或段落錨點。
- 如果論文文字不完整、為掃描版或文字提取品質不佳,請在摘要前說明此限制,並避免用確信的陳述填補空白。
- 在面向使用者的 Markdown 中,按六個必要維度對內容進行分組,並在同一維度下以條列方式呈現多項陳述。不要將重複的
研究目的、主要貢獻或其他重複維度呈現為獨立視覺區塊。 - 為確保可追溯性,在結構化的 JSON/Excel 中保持以聲明為基礎的列,但確保這些列按維度排序,以便下游頁面可以整潔地對其進行分組。
工作流程
- 識別論文來源類型:PDF、DOCX、Markdown、純文字、貼上的摘錄或提取的文字。
- 首先閱讀摘要、引言、方法、實驗/結果、討論、限制與結論。
- 掃描其餘正文,尋找影響所需類別的陳述。
- 在撰寫最終摘要之前,建立一個包含證據錨點的聲明清單。
- 填寫必要的維度:
研究目的主要貢獻使用技術/方法實驗與結果不足/局限未來前景/後續工作
- 針對每個維度,包含論文中有明確提及的所有要點。
- 僅在所有原文內容項目之後添加謹慎的推論項目,並明確標記為
合理推測。 - 首先產出 Markdown 輸出,將聲明清單分組在維度標題下。
- 當環境允許建立檔案時,使用
scripts/write_paper_summary_excel.py建立 Excel 輸出。 - 當環境允許建立檔案時,使用
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 條列項相互對應。
- 確認缺失的來源資訊被標記為
未提及而非憑空捏造。 - 確認當環境允許建立檔案時,生成的檔案已歸檔至文獻管理網頁。