Communitygithub.com

flyer-Li/paper-analyst

Analysiert akademische Paper und Forschungs-PDFs. Verwenden Sie diese Fähigkeit, wenn der Benutzer ein Forschungspapier hochlädt oder einfügt und es verstehen möchte.

Was ist paper-analyst?

Paper Analyst ist ein KI-Agenten-Skill, der für die detaillierte Analyse akademischer Paper und Forschungs-PDFs entwickelt wurde. Er unterstützt mehrere Modi – von einer schnellen Zusammenfassung bis hin zur vollständigen Analyse mit Präsentationserstellung – und ist ideal für Forscher, Studenten und Entwickler, die komplexe wissenschaftliche Arbeiten verstehen müssen. Der Skill arbeitet plattformunabhängig (z. B. mit Claude Code, Cursor) und extrahiert Kernaussagen, Beiträge, Methoden und Ergebnisse, wobei er strenge Anti-Halluzinations-Regeln befolgt. Bei unvollständigen oder gescannten PDFs wechselt er intelligent in einen degradierten Modus, ohne Inhalte zu erfinden. Der Ausgabestil ist standardmäßig auf Chinesisch eingestellt, aber die Analyse kann je nach Benutzeranfrage angepasst werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/flyer-Li/paper-analyst/tree/main

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Paper Analyst

Analysiert akademische Paper aus PDFs oder eingefügtem Text. Ausgabe standardmäßig auf Chinesisch. Alle Ausgaben folgen references/output-schema.md. Die Paper-Typ-Erkennung verwendet references/paper-type-rubric.md. Anti-Halluzinations-Regeln in references/quality-checklist.md.

Kurzreferenz

DateiZweck
references/output-schema.mdAbschnittsstruktur und Feldregeln
references/paper-type-rubric.mdWie der Paper-Typ klassifiziert wird
references/quality-checklist.mdAnti-Halluzinations-Checkliste
references/presentation-schema.mdJSON-Schema für Folienpläne
references/presentation-style-guide.mdKomprimierungsregeln für Folieninhalte
references/pptx-handoff.mdWie der pptx-Skill für die Wiedergabe aufgerufen wird
scripts/extract_pdf_meta.pyOptional: PDF-Metadaten in JSON extrahieren

Modusauswahl

Standardmodus: standard. Erkennung aus der Benutzeranfrage:

ModusAuslöserAusgabe
quick"quick", "简单说", "一句话", "简要"Header + Info + Abstract + 3 Beiträge
standard(Standard)Vollständige Analyse: Abschnitte 1–5
extended"前作", "课题组", "prior work"Standard + Vorarbeiten der Autoren/Gruppe
presentation"PPT", "组会", "汇报大纲", "slides"Standard + Folienübersicht
presentation_with_figures"图表", "figures", "带图", "关键图"Präsentation + Abbildungsanmerkungen

Bei Unklarheit standard verwenden und Moduswechsel anbieten.

Arbeitsablauf

Schritt 1: Eingabequalität bewerten

PDF-Qualität vor der Analyse klassifizieren:

  • Gut: Vollständiger Text extrahierbar
  • Herabgestuft: Teilweiser Text, gescannte Abschnitte, verstümmelte Kodierung
  • Stark herabgestuft: Minimaler Text, reines Bild-PDF

Bei Herabstufung: Grund in der Header-Zeile angeben, mit verfügbarem Inhalt fortfahren, alle Lücken explizit kennzeichnen. Niemals Inhalte erfinden, um Lücken zu füllen.

Optional: Wenn der Benutzer Python hat, vorschlagen, zuerst scripts/extract_pdf_meta.py für strukturierte Metadaten auszuführen.

Schritt 2: Paper-Typ klassifizieren

references/paper-type-rubric.md lesen und klassifizieren. Nicht AI/ML annehmen. Typ-Label und 2–3 Belegindikatoren vor dem Fortfahren ausgeben.

Schritt 3: Analyse durchführen

references/output-schema.md für den gewählten Modus befolgen. Alle Regeln aus references/quality-checklist.md in jedem Abschnitt anwenden.

Schritt 4: Selbstprüfung vor der Ausgabe

Vor der Finalisierung prüfen:

  • Jedes unsichere Feld mit [不确定] oder [未明确给出] markiert
  • Jeder Beitrag mit [原文声明] oder [模型归纳] getaggt
  • Kein Abschnitt stillschweigend ausgelassen – übersprungene Abschnitte begründen
  • Paper-Typ-Label stimmt mit Rubrik-Beleg überein

Anti-Halluzinations-Regeln

Vollständige Regeln in references/quality-checklist.md. Nicht verhandelbare Einschränkungen:

  1. Quellkennzeichnung: [原文声明] = direkt im Paper angegeben (Stelle zitieren); [模型归纳] = vom Modell abgeleitet (Begründung angeben)
  2. Unsicherheit: [未明确给出] wenn nicht vorhanden; [不确定] bei Unklarheit
  3. Keine Domänenannahme: Paper-Typ zuerst klassifizieren, immer
  4. Keine Erfindung: Veranstaltungsort, DOI, Jahr, Zugehörigkeiten nicht im Text → [未明确给出]
  5. Belegbindung: Jeder Beitrag muss Abschnitt/Abbildung/Tabelle/Zitat anführen
  6. Herabgestuftes PDF: Angeben, welche Abschnitte nicht lesbar waren; Lücken nicht füllen

Rückfall bei herabgestufter Eingabe

SituationMaßnahme
Nur Abstract verfügbarquick-Modus, Einschränkung vermerken
Gescanntes PDF, kein TextBenutzer zuerst nach Text oder OCR fragen
Referenzabschnitt fehltVorarbeiten-Analyse überspringen, Fehlen vermerken
Abbildungen nicht lesbarAbbildungsanalyse überspringen, Fehlen vermerken
Nicht-englisches PaperSchlüsselabschnitte übersetzen, Quellsprache vermerken

Erweiterter Modus: Vorarbeiten der Autoren

Nur im extended-Modus:

  1. Alle Autorennamen aus dem Paper extrahieren
  2. Selbstzitate in der Referenzliste identifizieren (gemeinsame Autoren)
  3. Forschungsgruppen-Schwerpunkt aus Zugehörigkeiten + Paper-Titel ableiten
  4. Vorarbeiten nur aus der Referenzliste auflisten – keine Websuche, kein externes Wissen
  5. Alle Ausgaben taggen: [基于论文内引用,非外部检索]
  6. Bei unzureichenden Informationen: explizit "信息不足,无法判断前作关系" angeben

Präsentationsmodus: PPT-Generierung

Nur im Modus presentation oder presentation_with_figures.

Schritt A: Überschreibungen sammeln

Vor der Erstellung des Folienplans prüfen, ob der Benutzer Folgendes angegeben hat:

  • audience (Labor / Konferenz / Allgemein) – Standard: lab
  • duration_hint (10min / 20min / 30min) – Standard: 20min
  • talk_style (technisch / Überblick / Diskussion) – Standard: technical
  • emphasis (welche Abschnitte erweitern)
  • skip (welche Abschnitte auslassen)

Wenn nicht angegeben, Standardwerte stillschweigend verwenden.

Schritt B0: PDF-Abbildungen extrahieren (nur presentation_with_figures)

Vor der Erstellung des Folienplans ausführen:

python scripts/extract_pdf_figures.py <pdf_path>

Dadurch werden alle Abbildungen im Verzeichnis figures/ gespeichert und eine figures/index.json mit name, path und page für jedes Bild geschrieben. Dieses Index bei der Zuweisung von figure_ref-Pfaden im Handoff verwenden.

Schritt B: Folienplan erstellen

references/presentation-schema.md für die Struktur befolgen. references/presentation-style-guide.md für Komprimierungsregeln befolgen.

  • Jede Folienrolle dem entsprechenden Output-Schema-Abschnitt zuordnen
  • Benutzerüberschreibungen anwenden (emphasis → erweitern, skip → auslassen)
  • Für presentation_with_figures: figure_needed: true bei Methoden-/Ergebnis-Folien setzen, wo eine Abbildung der primäre Beleg ist; figure_ref und figure_hint hinzufügen
  • Folienanzahl aus duration_hint (10min→6-7, 20min→9-10, 30min→12-14)

Schritt C: pptx-Skill aufrufen

references/pptx-handoff.md für das genaue Handoff-Format befolgen.

  • Alle [原文声明] / [模型归纳]-Tags vor der Übergabe an pptx entfernen
  • Keine Sprechernotizen in den Handoff aufnehmen
  • pptx-Skill automatisch aufrufen – Benutzer nicht vorher fragen
  • Ausnahme: Wenn der Benutzer "只要大纲" / "just the outline" gesagt hat, Folienplan als Text ausgeben und pptx überspringen

Verwandte Skills