CommunityRecherche & Datenanalysegithub.com

Shass27/STEM-Notizen

Ergänzende Notizgenerierung für MINT. Erstellt aus Vorlesungsfolien, Lehrbuchkapiteln, eingescannten Aufgabenblättern, Bildern (png/jpg) oder PowerPoint/Word-Dateien LaTeX-Formel-/Definitionsblätter, vollständig durchgerechnete Problemlösungen und Zusammenfassungsnotizen. Nutze dies, wenn der Nutzer nach Notizen, einer Formelsammlung, Spickzettel, durchgerechneten Lösungen oder Wiederholungsmaterial aus Referenz-/Quelldateien fragt.

Was ist STEM-Notizen?

Diese Fähigkeit wandelt MINT-Quellenmaterial (PDFs, Bilder, Office-Dateien) automatisch in professionelle LaTeX-Studienunterlagen um. Sie erstellt drei Arten von Ausgaben: Formel-/Definitionsblätter, vollständig durchgerechnete Problemlösungen und Zusammenfassungsnotizen. Der gesamte Workflow wird durch Multiple-Choice-Fragen (aus einer zentralen Fragenbank) gesteuert, sodass der Nutzer über Dateitypen, Themen und Kompilierung entscheidet. Die Fähigkeit unterstützt die Plattformen von Cursor und Claude Code und basiert auf Werkzeugen wie `pdfinfo`, `pdftotext`, `pdftoppm`, `soffice` und `tectonic`/`latexmk`. Dokumentierte Konfigurationen und Vorlagen in den Referenzordnern sorgen für einheitliche Formatierung, Quellenkennzeichnung und Lösungsschemata – inklusive Quellenüberprüfung und Fehlerberichterstattung bei Abweichungen. Der Workflow umfasst acht Schritte: Quellenerfassung, Werkzeugprüfung, Einstiegs-MCQs, Lektüre aller Materialien, Bearbeitung und Verifikation, Schreiben der LaTeX-Dateien, optionale Kompilierung und abschließender Bericht.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Shass27/stem-notes/tree/main

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

MINT-Ergänzungsnotizen (LaTeX)

Erstelle Studienmaterial als .tex-Dateien aus beliebigen MINT-Quellenmaterialien. Der Nutzer trifft jede Entscheidung über Multiple-Choice-Fragen (AskUserQuestion), also frage vor dem Erstellen.

Unterstützende Dateien (lies sie, wenn du den entsprechenden Schritt erreichst):

  • references/tooling.md: Software, Installationsbefehle und -größen, Konvertierungsbefehle
  • references/questions.md: der MCQ-Fragenkatalog (Einstiegsrunden, einschließlich der Kompilierfrage)
  • references/style-guide.md: Layout, Beschriftung, Lösungsformat, Überprüfungs- und Abweichungsregeln
  • templates/formula_sheet.tex, templates/solutions.tex, templates/summary_notes.tex: Präambeln zum Kopieren

Arbeitsablauf

1. Quellen erfassen

  • Liste die Dateien auf, die der Nutzer angegeben hat (Ordner oder @-Pfade). Akzeptiere PDF, PNG/JPG, PPTX/DOCX.
  • Führe für jede PDF pdfinfo (Seitenanzahl) und pdftotext -layout in den Sitzungs-Scratchpad aus, zähle dann die Wörter. Weniger als ~50 Wörter pro Seite bedeuten eine gescannte oder bildlastige Datei: lies jede Seite als Bild; der Textauszug ist nutzlos.
  • Folienpräsentationen enthalten Gleichungen und Abbildungen oft nur als Bilder. Auch wenn Text existiert, betrachte die Seiten dennoch.

2. Werkzeuge prüfen (zunächst schreibgeschützt)

Führe which pdfinfo pdftotext pdftoppm soffice tectonic pdflatex aus. Alles, was fehlt und benötigt wird, kommt in die erste MCQ-Runde, mit seiner Größe (siehe references/tooling.md). Installiere niemals ohne eine MCQ-Antwort. LibreOffice wird nur benötigt, wenn Office-Dateien vorhanden sind. Wenn der Nutzer eine Frage mit einer Frage beantwortet (z. B. "Wie viel Speicher?"), beantworte sie, frage dann erneut.

3. Einstiegs-MCQs

Stelle die Runden aus references/questions.md, maximal 4 Fragen pro AskUserQuestion-Aufruf. Setze die empfohlene Option an die erste Stelle und markiere sie "(Empfohlen)". Frage nur die Fragegruppen für die Ausgaben, die der Nutzer ausgewählt hat. Die Kompilierfrage wird immer, als letzte, gestellt. Lies die Antworten wörtlich: Freitext-Antworten überschreiben die Optionen.

4. Alles lesen

  • PDFs: Verwende das Read-Tool mit pages (maximal 20 Seiten pro Aufruf, teile also größere Bereiche auf) und führe alle Seitenbereichslesungen für alle Dateien in einem parallelen Batch durch. Das Read-Tool benötigt pdftoppm von Poppler.
  • Bilder: Lies sie direkt.
  • PPTX/DOCX: Konvertiere sie im Scratchpad zu PDF (soffice --headless --convert-to pdf --outdir <Scratchpad> Datei), lies sie dann als PDF.
  • Notiere für jede Frage oder jedes Beispiel: Quelldatei, Folie/Seite, Problemnummer, ob die Quelle es bereits löst (vollständig oder teilweise), sowie jede gedruckte Antwort.

5. Lösen und verifizieren

  • Bearbeite jedes Problem im Umfang. Überprüfe für alles Nichttriviale (Kurvenanpassungen, Integrale, Momentenbilanzen, mehrstufige Numerik) die Zahlen mit einem kurzen python3-Skript im Scratchpad.
  • Vergleiche mit gedruckten Antworten. Wenn sie abweichen, überprüfe erneut, melde dann die Abweichung im Dokument und dem Nutzer. Beuge das Ergebnis niemals, um einer gedruckten Antwort zu entsprechen.
  • Markiere Quellentippfehler (falsche Vorzeichen, falsche Terme, inkonsistente Daten) in einer Fußnote oder einem "Warum es hier ist"-Hinweis.

6. Die .tex-Dateien schreiben

  • Beginne mit der passenden Vorlage in templates/: behalte ihre Präambel und ersetze die %% TODO-Platzhalter.
  • Befolge references/style-guide.md: kennzeichne jedes Element mit Quelle · Folie/Seite · Problemnummer, füge eine Abdeckungstabelle hinzu, formuliere jede Frage vollständig neu, rahme die Antworten ein.
  • Verwende nur ASCII-Quellen. Kommentare sind nur einzeilige %-Kommentare, niemals mehrzeilige Bannerkommentare.
  • Standardausgabeordner ist latex/ neben den Quellen, sofern der Nutzer nichts anderes wählt.

7. Nur kompilieren, wenn der Nutzer es wünscht

  • tectonic: tectonic -X compile datei.tex. MacTeX: latexmk -pdf datei.tex. Korrigiere Fehler und kompiliere erneut, bis sauber.
  • Wenn der Nutzer Stopp sagt, brich die Aufgabe sofort ab (TaskStop) und wiederhole nicht.

8. Bericht

Liste kurz auf: die geschriebenen Dateien, was jede abdeckt, übersprungene Fragen (bereits in der Quelle gelöst), gefundene Abweichungen und Kompilierstatus. Wenn du nicht kompiliert hast, sage das klar.

Verwandte Skills