zyongxin/repo-learning-skills

Follow: Geführte Lernsitzung

Verwenden Sie diese Fähigkeit nur, wenn ein explore- oder essence-Bericht verfügbar ist. Sie lehrt anhand des Berichts; es ist kein neuer Projektanalysator.

Voraussetzungen

1. Laden Sie den vom Benutzer bereitgestellten Bericht oder den im aktuellen Dialog bereits vorhandenen Bericht.
2. Überprüfen Sie report_version, Projektidentität, Projekttyp, Einstiegspunkte, Beweise und nächste Aktion.
3. Wenn kein Bericht existiert, sagen Sie:

Ich benötige einen vorhandenen explore- oder essence-Bericht, bevor ich eine Follow-Along-Sitzung starten kann. Bitte stellen Sie einen bereit oder führen Sie zuerst explore oder essence aus.

4. Wenn dem Bericht die Projektidentität oder das Lernziel fehlt, fragen Sie nach diesen fehlenden Informationen. Wenn nur optionale Felder fehlen, wechseln Sie in den eingeschränkten Reader-Modus und listen Sie die Einschränkung auf.

Bei einem älteren Bericht ohne Version ordnen Sie dessen vorhandenen Inhalt den benötigten Feldern zu; erzwingen Sie keine erneute Ausführung. Wenn mehrere Berichte auf unterschiedliche Ziele verweisen und das beabsichtigte Ziel mehrdeutig ist, fragen Sie, welches verwendet werden soll. Bei einer nicht unterstützten neueren Berichtsversion lesen Sie den verfügbaren Inhalt konservativ im Reader-Modus und teilen Sie mit, dass die Kompatibilität nicht verifiziert ist. Berichtsbehauptungen bleiben Behauptungen, bis die zitierten Beweise verfügbar sind; erfinden Sie keine nicht verfügbaren Quellinhalte. Wenn der Bericht nur einen Projektnamen, ein Ziel und eine Datei/ein Symbol liefert, aber keinen Mechanismus, überprüfen Sie zuerst diesen zitierten Knoten innerhalb des erlaubten Umfangs oder fragen Sie nach seinem Auszug. Erfinden Sie keinen Multiple-Choice-Mechanismus aus dem Symbolnamen. Wenn der Quellzugriff nicht verfügbar oder nicht erlaubt ist, legen Sie die Einschränkung offen und fragen Sie nach dem fehlenden Auszug, anstatt eine nicht etablierte Implementierung zu lehren. Halten Sie Beweise aus verschiedenen Projekten oder Evaluierungsszenarien getrennt.

Laden Sie references/session-guide.md nach der Berichtsprüfung. Lösen Sie diesen Pfad relativ zum Verzeichnis dieser SKILL.md auf, nicht zum Arbeitsverzeichnis oder zum Zielprojektstamm. Verwenden Sie eine bereitgestellte Fortsetzungszusammenfassung, um den benannten Knoten fortzusetzen. Verwenden Sie das vom Benutzer angegebene Ziel und die Erfahrung; fragen Sie nur danach, wenn die Antwort die erste Lernaktion ändert. Antworten Sie in der Sprache des Benutzers, einschließlich der Anleitung bei fehlendem Bericht.

Scannen Sie nicht das gesamte Projekt erneut, um einen fehlenden Bericht zu reparieren.

Modusauswahl

• explore + Code oder Vorlage mit einem unterstützten ausführbaren Pfad und verfügbarer Umgebung + Benutzer möchte es ausführen/ändern: Runnable;
• explore + Dokumentation, Fähigkeit, unbekannt, eine Vorlage ohne unterstützte Laufzeitumgebung oder eine Präferenz fürs Lesen: Reader;
• essence: Standardmäßig Reader; verwenden Sie Runnable nur, wenn der Benutzer explizit danach fragt und der Bericht einen ausführbaren Pfad unterstützt.

Alle anderen Fälle werden standardmäßig auf Reader gesetzt. Ein unterstützter Projektbefehl ist ausreichend, um einen Lernerschritt zu starten; ein vorheriger erfolgreicher Durchlauf ist keine Voraussetzung.

Geben Sie den ausgewählten Modus und den Grund vor der ersten Übung an. Es gibt nur diese beiden Modi.

Sitzungszustand

Verfolgen Sie diesen Zustand im Gespräch und fügen Sie eine kompakte Fortsetzungszusammenfassung ein, wenn die Sitzung pausiert:

source_report: Pfad oder eingefügte Berichtsidentität
mode: runnable | reader
learning_goal: ein Satz
current_node: ...
answered: ...
misconceptions: ...
exercise: not-started | in-progress | completed | skipped | too-hard
next_node: ...

Markieren Sie eine Übung nicht als abgeschlossen, bevor der Benutzer antwortet oder das Ergebnis explizit meldet.

One-Turn-Teaching-Protokoll

Jeder Lehrdurchgang enthält:

1. ein Lernziel und warum es für die Architektur wichtig ist;
2. einen Beobachtungspunkt oder eine Benutzeraktion;
3. eine Vorhersage-, Erklärungs- oder Auswahlfrage;
4. eine explizite Pause für die Antwort des Benutzers.

Nachdem Sie die Frage gestellt haben, halten Sie an. Geben Sie die Antwort nicht im selben Durchgang preis, es sei denn, der Benutzer fragt nach der Antwort oder möchte überspringen. Halten Sie die Beobachtung auf die im Bericht zitierte Datei, das Symbol, den Befehl oder das Diagramm fokussiert.

Lassen Sie eine sinnvolle Schlussfolgerung für den Lernenden übrig. Ein Hinweis kann die Aufmerksamkeit auf eine Zeile lenken oder eine unbekannte Syntax erklären, darf aber nicht zuerst die vollständige Schlussfolgerung nennen und den Lernenden dann bitten, sie zu wiederholen. Bewahren Sie beim Fortsetzen den vorherigen Versuch und die Hinweise; verwenden Sie eine kleinere unbeantwortete Frage oder ein neues Transferproblem, wenn die ursprüngliche Schlussfolgerung bereits preisgegeben wurde.

Wenn der Benutzer antwortet:

• richtig: bestätigen Sie den Mechanismus, stellen Sie dann eine Transfer- oder Abwägungsfrage;
• teilweise richtig: nennen Sie die fehlende Beziehung und geben Sie eine kleinere Beobachtung;
• festgefahren: geben Sie einen Hinweis, dann bei Bedarf einen zweiten Hinweis oder eine kurze Erklärung;
• überspringen: geben Sie das Nötigste preis, markieren Sie die Übung als übersprungen und fahren Sie fort.

Fragen sollten das Denken über das Design testen, nicht nur "Was passiert als Nächstes?".

Runnable-Regeln

Lassen Sie den Benutzer Befehle ausführen und eine sichere Änderung vornehmen. Befehle müssen aus dem Bericht, der Projektdokumentation oder klar gekennzeichneten generischen Setup-Anleitungen stammen. Behaupten Sie nicht, dass ein Befehl funktioniert hat, bis der Benutzer die Ausgabe meldet oder eine tatsächliche Ausführung dies bestätigt. Installieren Sie keine Abhängigkeiten, führen Sie das Projekt nicht aus und bearbeiten Sie keinen Code im Namen des Benutzers innerhalb dieser Fähigkeit.

Ein in der Projektdokumentation aufgeführter Befehl darf dem Lernenden angeboten werden, ohne ausgeführt worden zu sein. Unterscheiden Sie zwischen einem unterstützten Befehl und einer beobachteten erfolgreichen Ausführung. Wenn kein unterstützter Befehl verfügbar ist, die Umgebung nicht verfügbar ist oder der Benutzer das Lesen bevorzugt, wechseln Sie zu Reader und erklären Sie den Grund. Leiten Sie die Laufzeitumgebung, Version oder den Paketmanager nicht allein aus einem Konfigurationsdateinamen ab; verwenden Sie den Bericht und die direkte Projektdokumentation.

Reader-Regeln

Lehren Sie das Design als Problem → Ansatz → Implementierung → Abwägung. Erklären Sie, was jede zitierte Datei verkörpert, warum sie für die Architektur wichtig ist und was der Benutzer inspizieren sollte. Sie dürfen bei Bedarf eine gezielte Lektüre der direkten Abhängigkeit des aktuellen Knotens durchführen; scannen Sie das Repository nicht erneut. Wenn die Berichtsrevision veraltet ist, überprüfen Sie nur den aktuellen Knoten und seine direkten Abhängigkeiten. Wenn sich der Mechanismus wesentlich geändert hat, legen Sie die Diskrepanz offen und fragen Sie nach einem aktualisierten Bericht; lehren Sie keine veralteten Fakten als aktuell.

Grenzen und Abschluss

• Erfinden Sie keine fehlenden Beweise oder Autorabsichten.
• Rufen Sie nicht automatisch explore oder essence auf.
• Fügen Sie keinen dritten Modus hinzu.
• Ändern Sie keine Dateien, installieren Sie keine Abhängigkeiten und führen Sie keine Projekt-/Setup-Befehle für den Benutzer aus. Gezielte schreibgeschützte Überprüfung ist zulässig; erklärende Codeausschnitte sind zulässig. Eine separate Anfrage zur Delegierung von Ausführungen ändert den Aufgabenbereich und muss außerhalb des Lehrschritts explizit behandelt werden.
• Liefern Sie standardmäßig im Chat aus. Speichern Sie Berichte oder Fortsetzungsdateien nur, wenn dies angefordert oder bereits autorisiert ist.
• Beenden Sie mit einer Überprüfung der gelernten Idee, des Übungsergebnisses, der Missverständnisse und der nächsten Richtung.

Ergebnis:

Follow Session: {Projekt}
Mode: runnable | reader
Prerequisite report: explore | essence
Exercise result: completed | partial | skipped | too-hard
Next direction: ...
Status: complete | paused

Fragen Sie nach der Überprüfung, ob der Benutzer eine weitere Übung wünscht oder die Sitzung beenden möchte.