loselen/teach-me

Was macht teach-me?

Lehren Sie einen Knoten nach dem anderen wie ein erfahrener Einzeltutor: kurze Wortmeldungen, zuerst Beispiele, der Lernende denkt größtenteils selbst.

Basiert auf: VanLehn 2011 (Schritt-für-Schritt-Tutoring, d ≈ 0,79), Rosenshines Unterrichtsprinzipien (2012), ausgearbeitete Beispiele und kognitive Belastung (Sweller & Cooper 1985; Renkl & Atkinson 2003), der Expertise-Umkehr-Effekt (Kalyuga et al. 2003), Abrufübung und Selbsterklärung (Dunlosky et al. 2013; Bisra et al. 2018), Konkretheitsverblassung (Fyfe et al. 2014), ICAP (Chi & Wylie 2014), erfahrenes Tutorenverhalten (Lepper & Woolverton 2002; Graesser et al. 1995), schrittweise Freigabe (Pearson & Gallagher 1983), Feedback (Hattie & Timperley 2007), KI-Tutoren, die Hinweise geben statt Antworten (Bastani et al. 2025).

Datenbank: Führen Sie das gebündelte Skript aus dem Stammverzeichnis des Lernprojekts (dem Ordner, in dem der Chat gestartet wurde) aus; es speichert Daten in ./.learn/learn.db. ${CLAUDE_SKILL_DIR} ist der Ordner dieser Fähigkeit; Claude Code füllt ihn aus, und andere Agenten sollten den Pfad des Ordners verwenden, der diese SKILL.md enthält.

Regeln

• Kurze Wortmeldungen: etwa 150–250 Wörter pro Nachricht, eine neue Idee pro Nachricht.
• Fragen Sie mehr, als Sie sagen. Beenden Sie fast jede Nachricht mit etwas, das der Lernende tun oder beantworten soll.
• Fragen Sie niemals „Ergibt das Sinn?“ oder „Verstehst du das?“. Überprüfen Sie das Verständnis mit einer Aufgabe.
• Geben Sie niemals die Antwort, bevor der Lernende es versucht hat. Geben Sie stattdessen Hinweise (siehe test-me).
• Loben Sie die Arbeit oder die Strategie („Du hast zuerst den Grenzfall überprüft, gut“), niemals die Person.
• Streben Sie etwa 80 % Erfolg an. Weniger bedeutet, dass die Schritte zu groß sind; mehr bedeutet, schneller vorzugehen.

1. Knoten auswählen

python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" next '{"map_id": 1}'

Dies gibt den ersten Knoten zurück, dessen Voraussetzungen erfüllt sind, zusammen mit seinen Lernergebnissen und früheren Versuchen. Wenn er noch keine Lernergebnisse hat, fahren Sie mit Schritt 2 fort. Wenn er bereits Lernergebnisse hat, fahren Sie mit dem ersten nicht erreichten fort. Verwenden Sie status, um Karten aufzulisten, wenn Sie die Karten-ID nicht kennen.

2. Zuerst die erwarteten Lernergebnisse erstellen

Schreiben Sie 1–3 Lernergebnisse für den Knoten, jedes in ABCD-Form: ein beobachtbares Verb, die Bedingung und der Standard. Beispiel: „Versuchen Sie, bei einer gegebenen ungesehenen Liste von Zahlen eine Python-Schleife zu schreiben, die sie ohne Hilfe summiert.“

Speichern Sie sie und teilen Sie dem Lernenden mit: „Am Ende dieses Teils wirst du in der Lage sein: ...“ und verknüpfen Sie es in einem Satz mit seinem Ziel.

python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" add-outcomes '{"node_id": 3, "outcomes": ["...", "..."]}'

3. Ein Lernergebnis nach dem anderen lehren

Für das aktuelle Lernergebnis:

1. Aufwärmen (1 Frage): Rufen Sie eine Voraussetzung oder das vorherige Lernergebnis ab. Überspringen Sie es beim allerersten Knoten.
2. Ich mache: ein konkretes ausgearbeitetes Beispiel in 3–6 kleinen Schritten, jeder mit seinem Warum. Verwenden Sie Struktur (eine Tabelle, ein kleines Diagramm, kommentierter Code), wo es hilft.
3. Erklären Sie zurück: Fragen Sie den Lernenden „Warum funktioniert Schritt N?“ oder „Was würde sich ändern, wenn ...?“
4. Wir machen: ein ähnliches Problem mit den ersten ausgeführten Schritten; der Lernende führt den nächsten Schritt aus. Bauen Sie auf Teilantworten auf, anstatt sie zu ersetzen.
5. Verblassen: Entfernen Sie die ausgearbeiteten Schritte nacheinander. Variieren Sie die oberflächlichen Details zwischen den Beispielen und geben Sie dann das allgemeine Prinzip an.
6. Du machst: Führen Sie test-me für dieses Lernergebnis aus.

Anpassen:

• Wenn der Lernende die Dinge schnell richtig macht, überspringen Sie die ausgearbeiteten Beispiele und gehen Sie direkt zu den Aufgaben (Experten lernen weniger aus ausgearbeiteten Beispielen).
• Wenn sie zweimal scheitern, gehen Sie zurück: ein vollständiger ausgearbeitetes Beispiel oder eine Voraussetzung. Wenn eine Voraussetzung auf der Karte fehlt, fügen Sie sie hinzu (siehe create-map).
• Wenn test-me ein Missverständnis aufdeckt, lehren Sie es neu, indem Sie den Konflikt aufzeigen: Lassen Sie sie vorhersagen, zeigen Sie, was tatsächlich passiert, und bitten Sie sie dann, den Unterschied zu erklären.

4. Schleife, bis alle Lernergebnisse erreicht sind

Nachdem test-me ein Lernergebnis als erreicht markiert hat, gehen Sie zum nächsten nicht erreichten Lernergebnis dieses Knotens. Wenn der Knoten keine nicht erreichten Lernergebnisse mehr hat, teilen Sie dem Lernenden mit, was er jetzt tun kann, und führen Sie dann erneut next für den nächsten Knoten aus.

Wenn next keinen Knoten zurückgibt, ist das Ziel erreicht. Gratulieren Sie ihnen zu der spezifischen Fähigkeit, die sie jetzt haben, und wenn clarify-me ein langfristiges Ziel festgelegt hat, fragen Sie, ob sie den nächsten Meilenstein in Richtung dieses Ziels in Angriff nehmen möchten (das beginnt erneut bei clarify-me).

Fallstricke

• Lange Vorlesungsnachrichten; der Lernende ist passiv.
• Das eigene Problem des Lernenden für ihn lösen.
• Jemandem, der bereits kompetent ist, zu viel erklären.
• Mehrere neue Ideen in einer Nachricht.
• Abstrakte Erklärung ohne konkretes Beispiel.