NourEldinShobier/course

Teach Me: Kurs-Workspace

Der Benutzer möchte über mehrere Sitzungen hinweg etwas lernen. Der aktuelle Ordner ist der Arbeitsbereich. Arbeitsbereichspfade werden relativ zum aktuellen Ordner aufgelöst; <plugin> ist der Ordner zwei Ebenen über dem Basisverzeichnis dieses Skills. Lektionen verwenden die Teach-Me-Laufzeit und die Schritte 2–6 des learn-Skills (<plugin>/skills/learn/SKILL.md).

Das Layout folgt Matt Pococks teach-Skill (MIT), sodass beide Tools im selben Ordner funktionieren.

MISSION.md            warum der Benutzer dies lernt          <plugin>/references/workspace/MISSION-FORMAT.md
RESOURCES.md          geprüfte Quellen: Wissen, Communities, Lücken   RESOURCES-FORMAT.md
GLOSSARY.md           Begriffe, die der Benutzer korrekt verwendet hat       GLOSSARY-FORMAT.md
NOTES.md              die Vorlieben des Benutzers, deine Arbeitsnotizen, bereits verwendete Metaphern
learning-records/     0001-slug.md: Belege für das, was er weiß   LEARNING-RECORD-FORMAT.md
lessons/              0001-slug.src.html -> 0001-slug.html (+ Notizen)
reference/            Spickzettel: komprimiert, druckbar, regelmäßig wiederholt
queue.json            Episoden oder Kapitel, die durchgearbeitet werden
review.src.html       alle Karteikarten aus allen Lektionen, zuerst fällig
sources/              rohe Transkripte und Kapiteltexte (zu .gitignore hinzufügen)

Jede Sitzung

1. Lies den Zustand: MISSION.md, NOTES.md, die neuesten Lernaufzeichnungen, queue.json. Wenn es keine MISSION.md gibt, befrage zuerst den Benutzer (warum, wie Erfolg aussieht, Frist, aktuelles Niveau, Einschränkungen) und schreibe sie in der Form der Formatdatei. Eine Änderung der Mission später erfordert die Bestätigung des Benutzers und einen Lernaufzeichnungseintrag.
2. Ressourcen: Bis RESOURCES.md ein paar vertrauenswürdige Einträge hat, ist deren Finden die Priorität (offizielle Doku, Standard-Lehrbücher, der Kurs selbst, ein oder zwei Communities für Weisheit). Aussortieren ohne Gnade.
3. Aufwärmen: Beginne im Chat mit zwei Abruffragen aus früheren Lektionen (nicht vom heutigen Stoff). Erwähne, wie viele Karteikarten fällig sind, und biete review.html an.
4. Wähle die Lektion: die Anfrage des Benutzers, sonst das nächste queued-Element, sonst das Nützlichste in seiner Zone der nächsten Entwicklung angesichts der Aufzeichnungen und der Mission.
5. Lehre eine Sache: Erstelle lessons/NNNN-slug.src.html (nächste Nummer) gemäß den Schritten 2–6 des learn-Skills, aber baue in den Arbeitsbereich: bun <plugin>/scripts/build.ts lessons/NNNN-slug.src.html und dann bun <plugin>/scripts/check.ts lessons/NNNN-slug.html. Verlinke die vorherige und nächste Lektion sowie den relevanten Spickzettel. Verwende die Begriffe des Glossars genau. Verwende keine Metapher, die bereits in NOTES.md aufgeführt ist; füge die neue dort hinzu.
6. Abschluss: Aktualisiere die Warteschlange, füge die Karten der Lektion zu review.src.html hinzu (eine cards-Komponente pro Deck, mit denselben deck- und Karten-IDs wie die Lektion, damit Zeitpläne übernommen werden) und baue sie neu auf. Jede dritte Lektion oder auf Anfrage destilliere einen Spickzettel in reference/.
7. Aufzeichnungen: Wenn der Benutzer Fortschritte aus einer Lektion einfügt oder im Chat Verständnis zeigt, schreibe Aufzeichnungen nur für Belege (siehe <plugin>/references/pedagogy.md). Fördere Glossarbegriffe, die der Benutzer korrekt verwendet hat.

Durcharbeiten eines Kurses oder Buches

queue.json:

{"source": {"kind": "udemy|youtube|book", "title": "…", "url": "…", "file": "…", "courseId": "…"},
 "items": [{"id": "lecture-or-chapter-id", "title": "…", "section": "…", "status": "queued|taught|skipped", "lesson": "lessons/0004-….html"}]}

• Baue die Warteschlange einmal aus dem Lehrplan oder dem Inhaltsverzeichnis auf (<plugin>/references/inputs.md: Udemy-Lehrplan-Endpunkt, yt-dlp -J für eine Playlist, PDF-Gliederung oder EPUB-Spine). Überspringe standardmäßig Einleitungen, Outros, Werbung und Quizze; frage bei Unsicherheit einmal nach.
• Ein Element pro Lektion. Rufe nur die Untertitel dieser Episode oder den Text dieses Kapitels ab, wenn du es lehrst. Rufe niemals einen gesamten Kurs vorab ab.
• "next" bedeutet das nächste queued-Element. Der Benutzer kann auch ein Element oder einen Bereich nennen ("Lektionen 12–14 als eine Lektion", "nur Kapitel 3, Abschnitt 2").
• Lektionen aus Episoden oder Kapiteln verwenden das Format notes (technisch) oder practice (Soft Skills, Leben, Sachbücher): eine kurze, lesbare Zusammenfassung in den Worten des Benutzers, die Kernidee als Abbildung, was der Dozent oder Autor betont, häufige Fehler, ein Quiz und Karten. Füge "wo dies passt" mit Verlinkung zu früheren Lektionen hinzu. Für AWS-ähnliche Kurse bevorzuge ein diagram mit einer Request-Trace und einer "Was bricht, wenn"-Frage; notiere prüfungsrelevante Fakten in einem Callout, wenn der Kurs auf eine Zertifizierung abzielt.
• Zitiere die Vorlesung oder das Kapitel (Titel, Nummer, Zeitstempel oder Seite) in der Quellenfußzeile. Paraphrasiere; füge niemals Transkripte oder lange Passagen in Lektionen ein.

Rücklehr-Sitzungen

Wenn der Benutzer sagt "teste mich" oder "lass mich erklären": Er erklärt zuerst im Chat; du findest die eine oder zwei kleinsten Lücken, stelle zu jeder eine Frage (sokratisch) und gib die Antwort nach zwei Versuchen. Notiere seine eigenen Formulierungen, wenn er es richtig macht.