asguth/grifo

Grifo-Fähigkeit

Erstellt universitäre Lernmaterialien zu jedem Thema, ausgehend von einem Thema oder einer Benutzerdatei: A4-Blätter im Zweispalten-Layout, sachliche editoriale Hierarchie, Diagramme, Tabellen, Illustrationen und originale Übungsfragen. Alles durchläuft drei Prüfinstanzen (Inhalt, Didaktik, Design) bevor es ausgeliefert wird.

Die folgenden Pfade sind relativ zum Ordner dieser SKILL.md.

Pfad	Was es ist	Wann lesen
references/comandos.md	Syntax, Flags und Spezifikation jedes Befehls	Immer: nur den Abschnitt "Syntax" und den des Befehls
references/design.md	Palette, Farbstile, Hierarchie, welche Komponente verwenden, Symbole	Vor HTML
references/ilustracoes.md	Didaktische Abbildung: offene Sammlung, Generator, Lizenz und Quellenangabe	Wenn das Thema eine physische Struktur hat
references/idiomas.md	Material in anderer Sprache: Bezeichnungen, Schriftarten, Prüfungen anderer Länder	Wenn die Sprache nicht pt-BR ist
references/componentes.md	HTML jeder Komponente	Vor HTML
references/fidelidade.md	Quellen, Zitieren und Referenzen mit Link	Vor der Recherche
references/bancas.md	Stil von Prüfungskommissionen	Nur wenn es eine Prüfungskommission gibt
agentes/*.md	Prompts der 3 Prüfer	Schritt 6
assets/templates/*.html	Grundgerüst jedes Befehls	Zu Beginn von Schritt 4
assets/lucide/nomes.txt	2.052 Lucide-Symbole (name: tags)	grep verwenden, nie ganz lesen
scripts/figura.py	Nach Fachbereich kuratierte Sammlung, sucht/lädt Abbildung mit offener Lizenz (Commons), erzeugt Molekül (RDKit) und Diagramm (matplotlib)	Schritt 4, falls eine Abbildung vorhanden
assets/acervo.json	61 überprüfte Abbildungen in 10 Bereichen (wird von figura.py acervo gelesen)	Nicht ganz lesen: Skript verwenden
scripts/verificar.py, montar.py, renderizar.py	Lint → eigenständiges HTML → PDF/PNG + Layout-Prüfung	Schritt 5

Befehle

/<befehl> <thema oder datei> [--format f] [--stil e] [--stufe n] [--kommission b] [--seiten N]
          [--material datei] [--sprache xx]

/resumo, /esquema, /lei-seca, /comparar, /pegadinhas, /questoes, /flashcards, /mnemonico, /edital, /cronograma, /revisao, /apostila, /validar, /grifo (Hilfe). /cmd, cmd: und natürliche Sprache → gleicher Ablauf. Unbekanntes Flag → Hinweis geben und mit Standard weitermachen. Nicht vorhandener Befehl → Hilfe von /grifo anzeigen. Details in references/comandos.md.

Ablauf (der Reihe nach)

1. Verstehen der Anfrage – und nachfragen, wenn etwas fehlt

Wenn die Anfrage kein Thema/Datei oder Format enthält, frage einmal, in einer einzigen Nachricht (im Claude Code mit dem Fragetool, falls vorhanden), und biete Optionen an:

1. Thema oder Datei: "Zu welchem Thema – oder welcher Datei (PDF, Folien, Notizen) – möchtest du das Material?"
2. Format:
   • Vollständige Erklärung – didaktische Zusammenfassung (standardmäßig 2–4 Seiten, ohne Limit) + Übungen + Lösung (/resumo);
   • Nur die Übersicht – visuelles Schema, standardmäßig 1 Seite (/esquema);
   • Schnelle Wiederholung – für den Tag vor der Prüfung, standardmäßig 1 Seite (/revisao);
   • Training – Übungen + kommentierte Lösung (/questoes) oder Karteikarten;
   • Alles inklusive – Deckblatt, Inhaltsverzeichnis, Zusammenfassung, Übersicht, Karteikarten, Übungen und Lösung (/apostila).
3. Visueller Stil (jeder lernt anders):
   • Dezent – marineblau und grau, Farbe nur wo sie Bedeutung hat (Standard);
   • Bunt – jedes Thema in einer anderen Farbe, volle Balken;
   • Pastell – Farben pro Thema in sanften Tönen, helle Hintergründe;
   • Schwarz-Weiß – Graustufen, zum Drucken in Schwarz-Weiß.
4. Stufe (nur wenn nicht ableitbar): Oberstufe, Universität (Standard), Prüfung (nach der Prüfungskommission fragen), Zertifizierung.

Das Format gilt nur dann als festgelegt, wenn es durch einen Schrägstrich-Befehl (/esquema, /revisao…), --format oder explizite Worte des Benutzers ("nur die Übersicht", "schnelle Wiederholung", "mit Übungen") gekommen ist. Bei natürlicher Sprache legt "Erstelle eine Zusammenfassung/Skript/Material zu X" nicht das Format fest: frage nach. Wenn du fragst, frage gleich den Stil mit, in derselben Nachricht. Wenn Thema und Format feststehen, frage nichts weiter: kein Stil angegeben = der vom Benutzer bereits in dieser Unterhaltung verwendete, sonst dezent (und erwähne --stil bunt|pastell|sw in einer Zeile in der Auslieferung). Anfragen wie "bunter", "weniger Farbe", "zum Drucken in SW" ändern den Stil.

Sprache: Schreibe das Material und antworte in der Sprache des Benutzers (oder --sprache). Außerhalb von pt-BR lies references/idiomas.md vor HTML. Gestaltungsfreiheit: Wähle Komponenten, Reihenfolge und Schwerpunkte danach, was am besten lehrt.

2. Inhalt erheben (Treue vor Schönheit)

Lies references/fidelidade.md. Benutzermaterial > offizielle/primäre Quelle > Referenzliteratur. Jede Zahl, jedes Datum, jede Formel, jeder Artikel oder jede technische Definition wird überprüft; ohne zugängliche Quelle → <span class="verificar">. Speichere die Quellen mit URL für die Referenzen.

3. Didaktischer Ablauf (Universitätsniveau)

Für jedes Unterthema: präzise Definition → Mechanismus/Warum → Beispiel → häufiger Fehler. Wähle die Komponente nach der Form des Inhalts (references/design.md §3) und veranschauliche alles, was eine Struktur hat. Fließtext nur für Konzepte, kurz und hervorgehoben.

4. HTML-Quelltext aus der Vorlage schreiben

Kopiere assets/templates/<befehl>.html nach <slug>-quell.html und ersetze alle [[PLATZHALTER]].

• <html lang="…" data-thema="dez|bunt|pastell|sw"> je nach Sprache und Stil (design.md §1.1). Feste Farbe pro Thema: class="farbe-1" … farbe-6 im Block/Spalte.
• Nur Klassen des Designsystems (references/componentes.md); style="" nur für punktuelle Anpassung.
• Kein Seitenlimit: Die Größe des Befehls ist Standard, keine Obergrenze. Inhalt, der nicht passt, kommt auf eine neue .seite; schneide niemals Inhalt ab, um Platz zu sparen, außer --seiten N vom Benutzer.
• Übungen immer einspaltig, auf einer eigenen Seite. Kommentierte Lösung und Referenzen auf einer separaten Seite, nach den Übungen (kein Spoiler auf derselben Seite).
• Referenzen mit Link: <a href="offizielle URL">Titel</a>.
• Symbole: Lucide (<svg class="ico"><use href="#l-NAME"/></svg>, Name mit grep -i begriff assets/lucide/nomes.txt finden), nur wenn sie etwas zum Block beitragen.
• Thema mit physischer Struktur (Anatomie, Physiologie, Zelle, Pflanze, Molekül, Schaltkreis, Laboraufbau, Karte): die Abbildung steht im Mittelpunkt der Seite und kommt aus einer offenen Sammlung (scripts/figura.py sammlung, dann suchen/laden) oder aus einem datengenerierten Generator (figura.py molekuel, figura.py diagramm). Zeichne niemals akademische Strukturen aus dem Gedächtnis: KI irrt sich bei Anatomie ohne es zu merken. Quellenangabe ist Pflicht. Methode in references/ilustracoes.md.

5. Überprüfen, bauen und rendern

python3 <skill>/scripts/verificar.py <slug>-quell.html
python3 <skill>/scripts/montar.py <slug>-quell.html <slug>.html     # [--schriften-eingebettet]
python3 <skill>/scripts/renderizar.py <slug>.html <ausgabe> --json     # [--sw]

Behebe jeden FEHLER des Lints und jede Layout-Warnung (Überlauf, Überfließen, unausgeglichene Spalten, Schrift < 8 pt) bevor du weitermachst. Ohne Python/Browser: liefere das HTML aus (Strg+P → A4, ohne Ränder, Hintergrundgrafiken).

6. Validierung (3 Prüfer, die das Material nicht geschrieben haben)

Mit Unteragenten: führe alle drei parallel aus, jeder mit seiner agentes/*.md + Pfaden zum HTML und den PNGs + verwendeten Quellen. Ohne Unteragenten: drei Durchgänge nacheinander, von Grund auf neu lesen. Behebe BLOCKIERENDE und WICHTIGE, baue neu und rendere neu (max. 2 Durchgänge).

7. Ausliefern

HTML + PDF. In 2–4 Zeilen: was erstellt wurde, verwendeter Stil, verbleibende [ÜBERPRÜFEN], Hauptquellen und Quellenangaben der Abbildungen. Beende mit einer Warnzeile: KI-generiertes Material zur Lernunterstützung; ersetzt keine Bücher, Vorlesungen oder offiziellen Quellen; überprüfe es.

Unverhandelbare Regeln

1. Treue > Ästhetik. Nichts aus dem Gedächtnis ohne Überprüfung; Zweifel = [ÜBERPRÜFEN].
2. Urheberrechte. Keine Texte, Schemata oder Übungen von Dritten kopieren. Bilder von Dritten nur mit offener Lizenz (CC0, gemeinfrei, CC BY, CC BY-SA) und Quellenangabe. Amtliche Gesetze können wörtlich zitiert werden (UrhG § 5 Abs. 2).
3. Keine Porträts realer Personen (zitiere den Namen des Autors im Text).
4. In SW lesbar. Farbe darf nie der einzige Bedeutungsträger sein: Symbol + Beschriftung. Bei Abbildungen sagt die Legende, was jede Farbe bedeutet.
5. Skriptdichte. Direkte Sätze, ohne "in dieser Zusammenfassung werden wir sehen"; Block > 6 Zeilen ohne Hervorhebung = umschreiben.
6. KI-Hinweis auf jeder Seite. Die Fußzeile druckt bereits "KI-generiert: in den Quellen prüfen" (via CSS, übersetzt durch lang); nicht entfernen. Das Material unterstützt das Lernen und ersetzt kein Buch, keine Vorlesung, keinen Atlas, kein offizielles Gesetz und keine professionelle Beratung.