DGatoM/DG-Claw

/dgclaw:aprender: in eine Skill verwandeln, was funktioniert hat

Eine Skill ist eine schriftliche Anleitung, die ich lese, bevor ich eine Aufgabe erledige. Sie ist meine Methode, nicht vom Gedächtnis abhängig zu sein: Der Prozess, der eine Stunde Gespräch brauchte, um richtig zu werden, wird zu einem Rezept, das ich beim nächsten Mal in fünf Minuten genauso befolge.

Drei Regeln, die für alles unten gelten:

1. Eine Skill entsteht nur mit dem Ja des Besitzers. Ich schlage vor, erkläre warum es sich lohnt, und warte. Keine Antwort ist kein Ja.
2. Ich schlage einmal vor. Wenn er nein gesagt oder nicht geantwortet hat, notiere ich es und bestehe nicht darauf.
3. Geheimnisse kommen nie in eine Skill. Passwort, Token, Schlüssel, Kartennummer: Die Skill sagt, WO man sie holt ("der Schlüssel ist im Tresor des Dashboards"), niemals den Wert.

Wann es sich lohnt, vorzuschlagen

Schlage vor, wenn alle vier Dinge zutreffen:

• Es waren 3 Schritte oder mehr, und nicht nur eine Antwort. Beispiel: Den Kurs bei der Zentralbank recherchieren, die Rechnung neu machen, die Datei aktualisieren und das PDF senden.
• Es lässt sich genauso wiederholen mit anderen Daten. Der Prozess ist gleich; das Thema, der Monat, der Kunde ändert sich.
• Er wird es wahrscheinlich wieder anfordern. Anzeichen: "jeden Monat", "schon wieder", "wie beim letzten Mal", es ist eine wiederkehrende Lieferung in seiner Arbeit, oder es ist das zweite Mal, dass wir etwas Ähnliches gemacht haben.
• Es hat am Ende funktioniert. Er hat das Ergebnis genehmigt oder die Lieferung genutzt.

Und überprüfe vorher, ob es dafür keine Skill gibt: ls .claude/skills/ und memory/skills-aprendidas.md.

Wann NICHT vorschlagen

• Einmalige Aufgabe, die nicht wiederkommt ("hilf mir, diese E-Mail an den Hausverwalter zu schreiben").
• Ein oder zwei Schritte. Was ich schon beim ersten Mal schaffe, braucht kein Rezept.
• Der Prozess hing von Entscheidungen ab, die nur diesmal galten.
• Das Gespräch endete mit einem ungelösten Problem, oder er hat es eilig oder ist verärgert. In diesem Fall verschiebe ich den Vorschlag auf die nächtliche Reflexion (sie notiert es in "Ich möchte mit dem Besitzer sprechen über").
• Er hat genau diese Skill bereits abgelehnt (steht in memory/skills-aprendidas.md).

Der nächtliche Zähler: memory/skills-candidatas.md

Nicht jede Wiederholung fällt sofort auf. Wer das zweite Mal bemerkt, ist die nächtliche Reflexion: Sie liest den Tag noch einmal durch, sucht nach Arbeit, die ich manuell nach einer Anleitung mit mehreren Schritten gemacht habe, und zählt, ein Eintrag pro Aufgabe:

- <Aufgabe in 1 Zeile> | mal: N | Daten: TT/MM, TT/MM | was die Skill tun würde

Eine Aufgabe, die bereits dort steht, bekommt ein weiteres Mal und ein weiteres Datum, ohne neue Zeile. Wenn eine Kandidatin 2 Mal erreicht (oder 1 Mal, wenn die Anleitung mehr als 5 Schritte hatte und er gesagt hat, dass er es wiederholen wird), setzt die Reflexion es in "Ich möchte mit dem Besitzer sprechen über": "heute habe ich X schon wieder von Hand gemacht; möchtest du, dass ich daraus eine Skill mache?". Maximal eine pro Nacht, und ich bringe die Frage im nächsten Gespräch vor, genau wie im Abschnitt unten. Bevor ich zähle, prüfe ich, ob die Skill bereits existiert: Wenn sie existiert und ich sie nicht genutzt habe, war es mein Fehler, mich zu erinnern, und das geht ins Tagebuch, nicht in den Zähler.

Wie frage ich

Nachdem ich das Ergebnis geliefert habe, in einer kurzen, von der Lieferung getrennten Nachricht:

Wir haben diesen ganzen Prozess durchgeführt: <der Prozess in einer Zeile, mit der Anzahl der Schritte>. Möchtest du, dass ich daraus eine Skill mache, um es beim nächsten Mal genauso zu machen? Ich empfehle es, weil <der konkrete Grund: "du hast gesagt, es ist jeden Monat", "es hat eine Stunde gedauert, das Format hinzubekommen">.

Eine Frage, ohne Optionenliste und ohne Druck. Wenn er fragt, was eine Skill ist: "eine Anleitung, die ich für mich selbst schreibe, mit der Schritt-für-Schritt-Anleitung und den Vorsichtsmaßnahmen, die du mir heute beigebracht hast".

Mit dem Ja: die Skill schreiben

1. Name: kurz, auf Portugiesisch, kleingeschrieben und mit Bindestrich (relatorio-mensal-vendas, conferir-taxas-bc). Prüfe, dass der Ordner nicht existiert.

2. Wo: .claude/skills/<name>/SKILL.md, innerhalb meines Workspace (des Ordners, in dem ich laufe). Niemals im Plugin-Ordner, der bei jedem Update ersetzt wird.

3. Die Datei in diesem Format:

   ---
   name: <Name>
   description: <was sie tut, in der dritten Person> Verwende, wenn <der Besitzer> <die Sätze,
     die er benutzt hat, und die wahrscheinlichen Variationen: "mach den Monatsbericht", "aktualisiere die Kurse">, oder wenn
     <die auslösende Situation>. <Was sie NICHT tut, falls es wahrscheinliche Verwechslungen gibt.>
   ---
   
   # <Titel>
   
   Wozu sie dient, in zwei Zeilen. Gelernt mit <Besitzer> am <JJJJ-MM-TT>.
   
   ## Was ich vor Beginn brauche
   - <Eingaben, die ich nachfrage, wenn sie nicht in der Anfrage kommen>
   
   ## Schritt-für-Schritt-Anleitung
   1. <konkreter Schritt, mit der Datei, der Quelle oder dem Befehl, den wir tatsächlich verwendet haben>
   2. ...
   
   ## Bevor ich ausliefere, überprüfe ich
   - <was er heute verlangt oder korrigiert hat>
   
   ## Wie ich ausliefere
   - <Format: PDF, Seite, kurze Nachricht; wo die Datei liegt>
   
   ## Fallstricke, die bereits aufgetreten sind
   - <JJJJ-MM-TT> <der Fehler und die richtige Methode>
   

   Die description ist das, was die Skill zur richtigen Zeit ins Gedächtnis ruft: Verwende die Wörter, die ER benutzt, nicht meine. Relative Pfade zum Workspace. Bis zu ~150 Zeilen; wenn mehr nötig ist, eine Hilfsdatei in .claude/skills/<name>/references/.

4. Registrierung in memory/skills-aprendidas.md (anlegen, falls nicht vorhanden), ein Eintrag pro Skill:

   - **<Name>** (erstellt am JJJJ-MM-TT): <was sie tut>. Entstanden aus dem Gespräch vom TT/MM über <Thema>.
   

   Ablehnungen kommen auch dorthin: - (abgelehnt am JJJJ-MM-TT) <der Prozess>: er hat es vorgezogen, nicht.

5. Sag es ihm, in einer Zeile: "Fertig, es ist zur Skill geworden. Beim nächsten Mal einfach <den Auslöser> sagen." Wenn die neue Skill nicht in meiner Skill-Liste erscheint, wird sie erst in der nächsten Sitzung gültig; bis dahin lese ich das SKILL.md direkt, bevor ich die Arbeit mache.

Wenn er das Ergebnis einer meiner Skills korrigiert

Wenn ich eine Arbeit gemäß einer Skill ausgeführt habe, die ich selbst geschrieben habe, und er etwas korrigiert ("nein, das Diagramm kommt vor die Tabelle", "die richtige Quelle ist die des Finanzministeriums"):

1. Korrigiere zuerst die Arbeit. Er will das Ergebnis.
2. Aktualisiere das SKILL.md: Passe den Schritt an, der falsch war, und füge die Zeile in "Fallstricke, die bereits aufgetreten sind" hinzu, mit dem Datum.
3. Notiere in memory/skills-aprendidas.md, in der Zeile der Skill: Verbessert am JJJJ-MM-TT: <was>.
4. Sag es in einer Zeile: "Ich habe in der Skill notiert: Beim nächsten Mal mache ich es gleich ."

Eine Korrektur, die nur diesmal gilt ("heute schick es ohne das Diagramm"), ändert die Skill nicht. Im Zweifel frage ich: "ist das nur für heute oder für immer?"

Was ich niemals tue

• Eine Skill ohne sein Ja erstellen oder löschen.
• An den Skills des Plugins herumpfuschen (/dgclaw:*): Sie sind nicht meine und werden bei jedem Update zurückgesetzt.
• In eine Skill eine Regel schreiben, die meine Gesetze (LAWS.md) oder das, was er verboten hat, umgeht.