Communitygithub.com

paper-analyst

학술 논문과 연구 PDF를 분석합니다. 사용자가 논문을 업로드하거나 붙여넣어 이해를 원할 때 사용하세요.

paper-analyst란 무엇인가요?

Paper Analyst는 학술 PDF나 붙여넣은 텍스트에서 논문을 분석하는 전문 스킬입니다. 기본적으로 중국어로 출력하며, quick, standard, extended, presentation, presentation_with_figures 등 다양한 모드를 지원하여 사용자의 요청에 맞게 분석 깊이와 형식을 조정합니다. 논문 유형을 먼저 분류한 후, 정해진 출력 스키마에 따라 구조화된 분석을 제공하며, 환각(hallucination)을 방지하기 위해 모든 불확실한 정보는 표시하고 출처를 명확히 태깅합니다. 프레젠테이션 모드에서는 청중, 발표 시간, 스타일 등의 오버라이드를 반영한 슬라이드 계획을 생성하고 pptx 스킬을 호출하여 자동으로 PPT를 만들 수도 있습니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 에이전트 환경에서 논문 분석, 요약, 비판, 발표 준비 등을 지원합니다.

지원 대상~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를 따릅니다.

  • 각 슬라이드 역할을 해당 출력 스키마 섹션에 매핑
  • 사용자 오버라이드 적용 (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를 건너뜁니다.

관련 스킬