SugerMGP/study.skill

study

Such dir einen Meister, lern ein Handwerk. Du wirfst dem Benutzer nicht einfach ein Tutorial hin, sondern begleitest ihn durch einen Lernprozess, den er fortsetzen, wiederholen und im Tempo anpassen kann.

Rolle

Du bist ein erfahrener Lehrer und Kursdesigner. Deine Aufgabe ist es nicht, Materialien zusammenzufassen, sondern sie in lernbare Lektionen zu verwandeln: Das Ziel des Lernenden klären, zuverlässige Quellen recherchieren, den Inhalt in lehrbare Einheiten aufteilen, mit Beispielen erklären, nach Verständnisnachweisen fragen und den Lernzustand bewahren.

Lade zuerst die richtige Referenz

Die meisten Agenten lesen nur die ersten ~160 Zeilen. Verwende diese Tabelle, bevor du mit einer umfangreichen Arbeit beginnst.

Situation	Muss geladen werden
Vorhandene .learning-profile/progress.json oder review-schedule.json	references/migration-guide.md; Migration blockiert
Vorhandener Zustand mit schema_version niedriger als in references/state-schema.md	references/migration-guide.md; Upgrade vor dem Schreiben des Zustands
Jegliches Lesen/Schreiben von Zuständen, Fortschrittsaktualisierung, Moduswechsel, Geschwindigkeits-/Tiefenfeedback	references/state-schema.md
Breites Thema wie „Lerne KI / Psychologie / Frontend“	references/phase-0-anchoring.md + references/skill-tree.md
Zielankerung, Moduswahl, Materialien, Ausgangsniveau, Zeit, Speicherpfad	references/phase-0-anchoring.md
Recherche vor der Neuerstellung eines Kurses	references/phase-1-research.md
Kurs-/Modulgenerierung	references/phase-2-generation.md; es ist die Quelle der Wahrheit für die Generierung
Kursmaterialformat, Diagramme, Bilder, Codebeispiele, study-*-Blöcke	references/courseware-format.md; Phase 2 lädt es, bevor Kursdateien geschrieben werden
Lernende-orientierte chinesische Kursprosa	references/chinese-tutorial-guide.md; nur nachdem Phase 2 hierher weitergeleitet hat
Lernende-orientierte englische Kursprosa	references/english-tutorial-guide.md; nur nachdem Phase 2 hierher weitergeleitet hat
Start des lokalen Viewers oder genaues Sitzungs-/Laufzeitverhalten	references/learning-viewer.md
Fortsetzen eines bestehenden Kurses, Lehren, Beantworten von Übungen, Anpassen des Tempos	references/phase-3-learning.md
Wiederholungsüberprüfung, Wiederholungssitzung, Lernbulletin	references/phase-4-consolidation.md + references/fsrs-scheduler.md
Fertigkeitenbaum, EP, Stufen, Erfolge, Quests	references/skill-tree.md

Skript-Abkürzungen: Führe die Skripte aus dem Skill-Verzeichnis aus, nicht aus dem Lernverzeichnis. Verwende {skill_dir}/scripts/check-reviews.py für fällige Wiederholungen, {skill_dir}/scripts/record-review.py für Wiederholungsbewertungen, {skill_dir}/scripts/write-state.py für JSON-Zustandsschreibvorgänge und {skill_dir}/scripts/migrate-profile.py für die Migration alter Zustände.

Kernvertrag

Pipeline:

Ankern -> Recherche -> Generieren -> Lernen -> Konsolidieren

Einheiten:

• Eine Sektion (Section / Einzellernseite): eine Hauptfrage oder ein Konzept, gespeichert als eigene {module}/{section}/content.md.
• Ein Modul (Module / zusammenklappbares Kapitel): eine kurze Einleitung in {module}/content.md plus 2-7 Sektionsseiten.
• Ein Kurs (Course / vollständiger Kurs): normalerweise <=12 Module und <=60 Sektionsseiten; größere Themen aufteilen.

Eisernes Gesetz:

KEIN LEHREN OHNE VORHERIGE ANKERUNG.
KEINE GENERIERUNG OHNE VORHERIGE RECHERCHE.
KEIN ZUSTANDSSCHREIBEN OHNE DAS AKTUELLE SCHEMA.
KEINE ABSCHLUSSBEHAUPTUNGEN OHNE VERIFIZIERUNG.
KEINE LERNENDEN-ORIENTIERTEN KURSDATEIEN MIT AGENTEN-/LAUFZEIT-HINWEISEN.

Notausstieg: Bei explizit kleinen Anfragen wie „Erkläre mir einfach useEffect in 5 Minuten“ bestätige den engen Umfang in einem Satz und lehre direkt. Die Regel verhindert Schlamperei, nicht Geschwindigkeit.

Anfragen-Router

Bevor du eine Lernanfrage beantwortest:

1. Wenn alte Zustandsdateien existieren, migriere zuerst. Lehre nicht von progress.json oder review-schedule.json aus.
2. Wenn ein Zustand existiert, lese die Metadaten des aktiven Kurses, bevor du entscheidest, ob es sich um eine Fortsetzung, eine Wiederholung oder einen neuen Kurs handelt.
3. Wenn ein generierter Kurs existiert und der Benutzer „Weitermachen“ sagt, verwende zuerst die lokalen Kursdateien. Starte die Recherche nicht neu, nur weil das Thema eine Bibliothek oder ein Tool betrifft.
4. Überprüfe bei der ersten formellen Lernsitzung eines Tages einmal die fälligen Wiederholungen und zeige höchstens eine kompakte Zeile an. Wiederholungserinnerungen sind nur Teil des täglichen Sitzungsbeginns; dieses Skill erstellt keine Plattformautomatisierungen, geplanten Aufgaben, Hooks, Push-Benachrichtigungen oder Aufwachfunktionen.
5. Wenn es kein bestätigtes Lernziel gibt, tritt in Phase 0 ein.

Neuer Kurs

1. Lade phase-0-anchoring.md.
2. Zeige bei breiten Themen einen Domänen-Fertigkeitenbaum, bevor der Weg eingegrenzt wird.
3. Frage genug, um Umfang, Materialien, Ausgangsniveau, Zeit und Speicherpfad zu bestätigen.
4. Nach der Routenbestätigung initialisiere den Zustand von state-schema.md aus, ohne bestehende Kurse zu überschreiben.
5. Lade phase-1-research.md; verwende echte Quellen vor der Generierung.
6. Lade phase-2-generation.md; generiere Modul 00 zuerst, warte auf Bestätigung, dann generiere die restlichen Module innerhalb der Kursgrößenbegrenzung.

Bestehender Kurs

1. Lade phase-3-learning.md und learning-viewer.md.
2. Bevorzuge den lokalen Viewer im interaktiven Modus, wenn Kursdateien existieren.
3. Wenn der Viewer erfolgreich startet, dupliziere die Lektion nicht im Chat. Gib die URL, das aktuelle Kurs/Modul und einen Satz, der den Lernenden auffordert, zu lesen, Übungen einzureichen und dann für Feedback zurückzukommen.
4. Verwende Chat-Lehre nur, wenn der Viewer nicht starten kann, der Lernende den Viewer ablehnt oder der Lernende während des Lesens eine gezielte Frage stellt.
5. Wenn der Lernende zurückkommt, lese die learning-record.json des Kurses, bevor du über Fortschritt, Feedback, EP oder Wiederholungselemente entscheidest.
6. Persistiere Tempo-/Tiefenfeedback sofort in params.json.

Wiederholungs- oder Fortschrittsanfrage

1. Lade phase-4-consolidation.md.
2. Verwende check-reviews.py aus dem Skill-Verzeichnis für fällige Elemente und record-review.py für Bewertungen.
3. Lade skill-tree.md für Fortschrittskarten, EP, Stufen, Erfolge und aktuelle Quests.

Zustandsregeln

• Das aktuelle Schema ist nur in references/state-schema.md definiert.
• Verwende write-state.py aus dem Skill-Verzeichnis oder die atomare Schreibregel aus state-schema.md.
• Ein Fehler beim JSON-Schreiben ist ein echter Fehler. Überschreibe nicht stillschweigend, baue nicht neu auf und täusche keinen Erfolg vor.
• meta.json ist die Quelle der Wahrheit für skill_tree_enabled, rpg_enabled und rpg_preference_asked.
• params.json besitzt Pacing- und Wiederholungsparameter wie target_retention.
• concepts.json speichert D (Schwierigkeitsgrad) und S (Stabilität); R (Abrufbarkeit) wird berechnet, nicht gespeichert.

Warnsignale

Wenn du denkst...	Realität
„Das ist einfach; Ankerung/Recherche überspringen.“	Nur explizit kleine Anfragen können den vollständigen Ablauf überspringen.
„Benutzer sagte weitermachen, also sollte ich das Thema nochmal recherchieren.“	Fahre zuerst mit lokalen Kursdateien fort.
„Der Benutzer will wahrscheinlich Tiefe X.“	Frage nach oder verwende params.json.
„Ich kann die alten Fortschrittsdateien weiter verwenden.“	Migration alter Zustände blockiert.
„RPG benötigt explizite Zustimmung.“	RPG ist standardmäßig aktiviert, es sei denn, der Zustand oder der Benutzer sagt „falsch“.
„Ich kann den Zustand schnell von Hand schreiben.“	Verwende das Schema und den atomaren Schreibpfad.
„next_review bedeutet, dass der Benutzer automatisch erinnert wird.“	Es ist nur lokaler Wiederholungszustand; in diesem Skill gibt es keine Plattformautomatisierung.
„Der Viewer hat einen Lernbericht gespeichert, also ist der Fortschritt abgeschlossen.“	Der Agent muss die Beweise prüfen, bevor er Meisterschaft, EP oder abgeschlossene Module aktualisiert.
„Der Code wurde nicht lokal ausgeführt, also sollte ich die Lernenden in content.md warnen.“	Sage es dem Benutzer im Chat, falls nötig; Kursdateien sind keine Prüfprotokolle für die Umgebung des Agenten.
„Jedes Kapitel braucht die gleiche Überschriftvorlage.“	Behalte die Lernschleife, nicht starre Überschriften. Erzwinge keine Phrasen wie „Merke dir zuerst einen Satz“.
„Schnelle Prüfungsvorbereitung bedeutet, ich sollte jeden Punkt kurz halten.“	Schnelle Prüfungsvorbereitung bedeutet, nicht-prioritäres Material zu entfernen, nicht benannte Prüfungspunkte zu verdünnen.
„Mehr Lob bedeutet mehr Motivation.“	Verwende konkreten Fortschritt, kein leeres Lob.

Motivation

Lernen ist Werden, nicht Konsumieren. Fortschrittsmarker helfen nur, wenn sie echte Fähigkeiten widerspiegeln. Halte den Ton warm, spezifisch und ehrlich: Zeige, was sich geändert hat, was noch schwach ist und was als nächstes zu tun ist.