Alitaliy/summarize-paper-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/텍스트 추출본과 생성된 요약 출력물이 포함된 로컬 구조를 선호하십시오. 웹페이지는 요약 출력 파일만 가져옵니다.

마크다운 출력

다음 구조를 사용하십시오:

# 논문 요약: <논문 제목 또는 사용자가 제공한 파일명>

## 기본 정보

- 제목:
- 저자:
- 연도/학회 또는 저널:
- 연구 분야:
- 자료 완전성 설명:

## 개요

<논문이 해결하는 문제, 방법 및 결론을 3-6문장으로 요약. 원문이 지원하는 정보만 작성.>

## 항목별 요약

### 연구 목적
- 【원문 명시｜높음】... (근거: 초록; 서론)
- 【원문 요약｜높음】... (근거: 서론)

### 주요 기여
- 【원문 명시｜높음】... (근거: 기여 항목)

### 사용 기술/방법
- 【원문 명시｜높음】... (근거: 방법)

### 실험과 결과
- 【원문 명시｜높음】... (근거: 실험; 표 1)

### 한계/단점
- 【원문 명시｜높음】... (근거: 한계; 결론)

### 향후 전망/후속 작업
- 【원문 명시｜높음】... (근거: 결론)

## 추론 내용 목록

| 추론 항목 | 추론 근거 | 신뢰도 | 사후 검증 제안 |
|---|---|---|---|
| ... | ... | 높음/중간/낮음 | ... |

## 주의해야 할 원문 제한 사항
- ...

지침:

• 원문 내용과 추론 내용을 시각적으로 구분하기 위해 각 글머리 기호 시작 부분에 【원문 명시｜높음】과 같은 유형과 신뢰도를 넣으십시오.
• 각 필수 차원은 한 번만 제목으로 나타나야 합니다. 해당 제목 아래에 여러 점을 글머리 기호로 넣으십시오.
• 특정 차원에 대한 논문 내 지원이 없는 경우 【미언급｜】로 레이블이 지정된 하나의 글머리 기호를 포함하고 논문이 해당 정보를 제공하지 않는다고 설명하십시오.
• 신중한 추론이 유용한 경우에만 별도의 합리적 추론 글머리 기호를 추가하고 추론 내용 목록에도 나열하십시오.
• 추론 내용 목록이 비어 있더라도 포함시키십시오. 추론이 사용되지 않은 경우 없음을 작성하십시오.
• Markdown 그룹 글머리 기호와 JSON/Excel 주장 행은 동일한 기본 주장을 설명해야 합니다. Markdown은 가독성을 위해 그룹화되어 있지만 말입니다.

엑셀 출력

사용자가 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": "초록; 서론.",
      "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 글머리 기호와 일치하는지 확인하십시오.
• 누락된 소스 정보가 발명되지 않고 미언급으로 표시되는지 확인하십시오.
• 파일 생성이 가능한 경우 생성된 파일이 문헌 관리 웹페이지를 위해 보관되었는지 확인하십시오.