VdustR/skills

Session Retro

Überprüfen Sie eine AI-Agenten-Sitzung, um Verbesserungsmöglichkeiten zu finden. Die Retrospektive erfolgt durch interaktiven Dialog – beobachten Sie, was passiert ist, diskutieren Sie die Ergebnisse mit dem Benutzer und präsentieren Sie dann umsetzbare Empfehlungen.

Das Ziel ist, die Effizienz der Zusammenarbeit des Benutzers mit AI zu verbessern: bessere Prompts, bessere Dokumentationen, bessere Tools, bessere Arbeitsabläufe.

Schnellstart

Lass uns diese Sitzung retro-spektivieren

/retro

Was könnte ich aus dieser Sitzung verbessern?

Sitzungsanalyse – Optimierungsmöglichkeiten finden

Wann verwenden

• Am Ende einer Arbeitssitzung, um zu reflektieren und Erkenntnisse festzuhalten
• Nach einer Sitzung mit Reibungen, Korrekturen oder Workarounds
• Wenn Sie Agent-Anweisungen, Skills, Hooks oder Arbeitsabläufe verbessern möchten
• Wenn Sie neugierig sind, welche Community-Skills bei Mustern in der Sitzung helfen könnten
• Regelmäßig, um gesunde Entwicklungspraktiken aufrechtzuerhalten

Wie es funktioniert

Der folgende Ablauf ist eine typische Anleitung – passen Sie sich natürlich an das Gespräch an. Nicht jede Sitzung benötigt jeden Schritt; eine kurze Sitzung ohne Probleme erfordert möglicherweise nur eine kurze Beobachtung und geht dann weiter.

Beobachtung

Überprüfen Sie das Sitzungsgespräch und identifizieren Sie frei alles, was erwähnenswert ist. Beschränken Sie sich nicht auf vordefinierte Kategorien – lassen Sie Beobachtungen natürlich aus dem tatsächlich Geschehenen entstehen.

Geben Sie für jede Beobachtung eine einzeilige Feststellung und eine erste umsetzbare Empfehlung. Auch wenn der Benutzer nicht tiefer eintaucht, sollte jede Beobachtung einen nützlichen Erkenntniswert bieten.

Verwenden Sie nach der offenen Überprüfung die 15 Dimensionen in dimensions.md als Sicherheitsnetz-Checkliste – überprüfen Sie auf alles, was die offene Beobachtung möglicherweise übersehen hat. Melden Sie nur zusätzliche Erkenntnisse, die wirklich erwähnenswert sind.

Beziehen Sie sowohl ein:

• Reaktive Erkenntnisse: Dinge, die schief gelaufen sind oder korrigiert wurden
• Proaktive Erkenntnisse: Dinge, die richtig gelaufen sind, aber nicht dokumentiert sind, oder gute Praktiken, die kodifiziert werden könnten

Interaktiver Deep-Dive

Präsentieren Sie Beobachtungen nacheinander mit einem Fortschrittsindikator (z. B. [2/6]). Geben Sie für jede Beobachtung die erste Empfehlung und fragen Sie, ob der Benutzer einen Deep-Dive wünscht.

Der Benutzer kann:

• Ja sagen – für einen Deep-Dive notieren
• Nein sagen – weitermachen (die erste Empfehlung bleibt bestehen)
• Kontext oder Korrekturen hinzufügen
• Beobachtungen einbringen, die die KI übersehen hat
• "Genug" sagen, um die restlichen zu überspringen und fortzufahren

Nachdem alle Beobachtungen durchgegangen wurden, falls der Benutzer welche für einen Deep-Dive ausgewählt hat, bewerten Sie, welche Punkte tatsächlich eine Recherche durch Subagenten erfordern gegenüber Punkten, die klar genug sind, um direkt zu handeln. Präsentieren Sie diese Bewertung und bitten Sie den Benutzer um Bestätigung, bevor Sie Subagenten starten.

Jeder Subagent folgt dem Kreislauf in subagent-guide.md: die Beobachtung gründlich recherchieren, Ursachen analysieren, konkrete Lösungen entwerfen und Ergebnisse mit einer Empfehlung präsentieren.

Ergebnisse & Diskussion

Präsentieren Sie jedes Subagentenergebnis nacheinander mit Fortschritt. Der Benutzer kann:

• Das Ergebnis diskutieren und Folgefragen stellen
• Eine empfohlene Option akzeptieren
• Änderungen anfordern
• Zum nächsten Ergebnis springen

Handlungsempfehlungen

Nachdem alle Ergebnisse besprochen wurden, fassen Sie die bestätigten Aktionen in einer Empfehlungszusammenfassung zusammen. Geben Sie für jede Aktion an, was zu tun ist und warum. Wenn der Benutzer bittet, etwas zu speichern (z. B. "schreib es auf"), geben Sie eine Markdown-Zusammenfassung im Chat aus – schreiben Sie keine Dateien.

Schließen Sie die Retrospektive explizit ab: Teilen Sie dem Benutzer mit, dass die Retrospektive abgeschlossen ist und dass die empfohlenen Aktionen von ihm auszuführen sind, sobald er bereit ist.

Richtlinien

TUN Sie

• Lassen Sie Beobachtungen aus dem tatsächlichen Sitzungsinhalt entstehen, nicht aus einer festen Vorlage
• Geben Sie für jede Beobachtung umsetzbare Erkenntnisse, auch ohne Deep-Dive
• Respektieren Sie die Zeit des Benutzers – wenn eine Sitzung sauber war, sagen Sie es und halten Sie es kurz
• Bitten Sie um Erlaubnis, bevor Sie Subagenten starten
• Für Korrekturen: Untersuchen Sie, ob die Ursache eine fehlende Konvention, unklare Dokumentation oder ein verbesserungswürdiges Skill ist
• Für gute Praktiken: Schlagen Sie vor, sie zu kodifizieren, bevor sie vergessen werden
• Bei der Analyse von Skills: Überprüfen Sie zuerst die Besitzer (selbst gepflegt vs. Community), um angemessene Ratschläge zu geben
• Präsentieren Sie Erkenntnisse mit einer Empfehlung und Begründung

TUN Sie NICHT

• Führen Sie keine Aktionen aus (z. B. Commit, Push, Dateien ändern). Dieses Skill dient nur der Analyse und Empfehlung
• Interpretieren Sie Zustimmung des Benutzers (z. B. "ja", "klingt gut", "mach weiter") als Aufforderung zur Ausführung. Solche Antworten sind nur Bestätigungen
• Handeln Sie auf Anweisungen, bevor die Retrospektive explizit abgeschlossen ist. Nur eine neue, spezifische Anweisung nach Abschluss der Retrospektive ist eine gültige Aufforderung zum Handeln
• Erzwingen Sie eine starre Phasenreihenfolge – passen Sie sich dem Gespräch an
• Analysieren Sie Sitzungen mit minimalen Problemen übermäßig
• Starten Sie Subagenten ohne Benutzererlaubnis
• Empfehlen Sie Änderungen, ohne zu erklären, warum
• Lassen Sie die Option "nichts tun / überspringen" bei der Präsentation von Auswahlmöglichkeiten weg
• Seien Sie wertend über die Prompts oder den Arbeitsablauf des Benutzers – seien Sie konstruktiv

Referenzdateien

• dimensions.md – 15 Analysedimensionen, die als Sicherheitsnetz-Checkliste verwendet werden
• subagent-guide.md – Wie Subagenten recherchieren, analysieren und Ergebnisse präsentieren

Hinweise

• Die 15 Dimensionen sind eine Checkliste, kein Bewertungsschema. Die meisten Sitzungen werden nur in wenigen Dimensionen Signale aufweisen.
• Eine sitzungsübergreifende Musteranalyse ist verfügbar, wenn der Benutzer mehrere Sitzungen überprüfen möchte – fragen Sie zu Beginn nach dem Umfang, falls unklar.
• Verwandte Tools, die der Benutzer nach einer Retrospektive separat aufrufen kann: hookify, claude-md-management, skill-creator, brainstorming. Die Retrospektive ruft diese nicht direkt auf.