Skill Forge: Agent-Docs Lernen

Manuell ausgelöster Skill. disable-model-invocation: true verhindert, dass das Modell diesen Workflow während der Aufgabe automatisch aufruft. Wenn dieser Skill über das Plugin installiert ist, wird er bewusst als /agent-docs:learn am Ende einer Sitzung aufgerufen. Füge keine Hooks, Hintergrundaufgaben, automatische Auslöser, Laufzeitspeicher, Vektordatenbanken, MCP-Integration oder externe Gedächtnissysteme hinzu.

Überprüfe, was in dieser Sitzung passiert ist, und erstelle verifizierte, überprüfbare Gedächtnisvorschläge für die entsprechende AGENTS.md-Datei. Bearbeite keine Dateien, bis der Benutzer den vorgeschlagenen Diff gesehen und ausdrücklich genehmigt hat.

Non-Derivability-Prinzip

Erfasse nur Informationen, die NICHT aus dem Codebestand selbst abgeleitet werden können. Bevor du einen Eintrag für „Hidden Knowledge“ vorschlägst, frage:

Kann der nächste Agent oder Mensch dies durch Lesen des Codes, Ausführen von git log oder Überprüfen vorhandener Dokumentation entdecken?

Wenn ja, erfasse es NICHT als verstecktes Wissen. Die Hürde ist hoch. Das meiste Wissen gehört in Quellen, Commit-Nachrichten oder vorhandene Dokumente, nicht in AGENTS.md.

Schritt 1: Kandidaten-Erkenntnisse extrahieren

Überprüfe den aktuellen Sitzungsverlauf und liste Kandidaten-Erkenntnisse auf. Kandidaten stammen in der Regel aus versteckten Abhängigkeiten, irreführenden Fehlern, projektspezifischen Workarounds, kritischen Reihenfolgen, Befehlsfindung oder Dokumentationslücken.

Schreibe noch nichts. Klassifiziere zunächst jeden Kandidaten.

Schritt 2: Kandidaten klassifizieren

Klassifikation	Ziel	Regel
Hidden Knowledge	Nächstgelegene relevante AGENTS.md unter ## Hidden Knowledge	Nur für nicht ableitbare versteckte Abhängigkeiten, irreführende Fehler, Workarounds, Besonderheiten oder kritische Reihenfolgen
Quick Reference	Root AGENTS.md Quick Reference-Tabelle	Build-, Test-, Lint-, Run-, Codegen-, Clean- oder andere häufig verwendete Befehle
Rule	Nur vorgeschlagenes Ziel melden	Teamkonvention oder harte Grenze; erstelle oder ändere keine docs/rules/ über /agent-docs:learn
Doc	Nur vorgeschlagenes Ziel melden	Längere Design-, Fehlerbehebungs-, Runbook- oder Bibliotheksnotiz; erstelle oder ändere keine Dokumente über /agent-docs:learn
Skip	Kein Schreiben	Ableitbar, einmalig, doppelt vorhanden, veraltet, allgemein oder nicht verifizierbar

Kandidaten für Hidden Knowledge

Nur Kandidaten, die den Non-Derivability-Test bestehen, können zu verstecktem Wissen werden:

1. Versteckte Abhängigkeiten: Dateien oder Module, die zusammen geändert werden müssen, aber nicht offensichtlich verbunden sind.
2. Irreführende Fehler: Fehlermeldungen, die auf die falsche Stelle oder Ursache hinweisen.
3. Workarounds und Besonderheiten: Projektspezifisches Verhalten, das vom Standardmuster abweicht.
4. Kritische Reihenfolgen: Vorgänge, die in einer bestimmten Reihenfolge stattfinden müssen.

Skip-Kriterien

Überspringe Kandidaten, die:

• Codemuster, Architektur oder Dateistruktur, die durch Lesen des Quellcodes sichtbar sind.
• Git-Verlauf oder kürzliche Änderungen, die git log oder git blame bereits aufzeichnen.
• Debugging-Lösungen, bei denen die Lösung jetzt im Code ist und die Commit-Nachricht den Kontext tragen sollte.
• Bereits in AGENTS.md, docs/rules/ oder der README vorhanden.
• Standardverhalten der Sprache oder des Frameworks.
• Nicht offensichtliche Befehle, die in die Quick Reference gehören, nicht in Hidden Knowledge.
• Flüchtige Sitzungsdetails, einschließlich Versuche, die vorübergehend fehlgeschlagen sind.
• Nicht verifizierte Behauptungen.

Schritt 3: Jeden behaltenen Kandidaten verifizieren

Jeder behaltene Kandidat benötigt explizite Nachweise, bevor er vorgeschlagen werden kann:

Kandidat erwähnt	Verifizierungsnachweis
Dateipfad	Bestätige die Existenz des Pfads mit ls oder durch Lesen der Datei
Funktion, Typ, Befehl oder Symbol	Bestätige die Existenz mit einer Suche oder einer sprachbewussten Suche
Verhalten oder Einschränkung	Führe den kleinsten relevanten Befehl aus, überprüfe den Quelltext oder erkläre, warum die direkte Ausführung unsicher ist
Vorhandener AGENTS.md-Inhalt	Lese den Zielabschnitt und überprüfe auf veraltete oder doppelte Einträge

Wenn die Verifizierung fehlschlägt, klassifiziere den Kandidaten als Skip und erkläre die fehlgeschlagene Prüfung. Wenn die Verifizierung nicht sicher durchgeführt werden kann, melde sie als nicht verifiziert und schlage kein Schreiben vor.

Schritt 4: Das Ziel auswählen

Wähle die nächstgelegene AGENTS.md zum betroffenen Bereich:

Bereich der Erkenntnis	Ziel-Datei
Betrifft das gesamte Projekt	Root AGENTS.md
Betrifft ein bestimmtes Paket	<package>/AGENTS.md
Betrifft ein komplexes Modul	<package>/<module>/AGENTS.md, nur wenn Unterpaket-Kriterien erfüllt sind

Für Hidden Knowledge füge einen ## Hidden Knowledge-Abschnitt am Ende der Ziel-AGENTS.md an oder erstelle ihn neu. Halte jede Erkenntnis auf 1-3 Zeilen.

Für Quick Reference schlage eine Zeilenaktualisierung in der Root-AGENTS.md-Tabelle vor.

Für Rule und Doc melde nur das vorgeschlagene Ziel. Erstelle oder ändere keine Regel-Dokumente, Design-Dokumente, Fehlerbehebungs-Dokumente, Runbooks oder Bibliotheks-Dokumente mit diesem Befehl.

Schritt 5: Vorgeschlagene Änderungen zuerst anzeigen

Bevor du eine Datei bearbeitest, zeige alle Vorschläge in diesem Format an:

## Lern-Vorschläge

### 1. `<classification>` -> `<target file>`

**Warum:** <Einzeiliger Grund, warum dies zukünftigen Sitzungen hilft>

**Verifizierung:** <Pfad/Symbol/Befehl/Verhaltensnachweis>

**Aktion:** <add/update/skip/report-only>

```diff
- <vorhandene Zeile, nur bei Aktualisierung eines genehmigten vorhandenen Eintrags>
+ <exakte vorgeschlagene Ergänzung oder Ersetzung>
```

### Übersprungene Kandidaten

1. `<candidate>` -> übersprungen, weil <Grund>

### Nur-Melden-Vorschläge

1. `<candidate>` -> gehört in <vorgeschlagenes Ziel>, wird nicht von `/agent-docs:learn` behandelt

Überspringe nicht den Diff- und Genehmigungsschritt. Auch wenn der Benutzer eine schnelle Anwendung wünscht, muss der Benutzer die genauen vorgeschlagenen Änderungen sehen und sie zuerst genehmigen.

Schritt 6: Nur genehmigte Änderungen anwenden

Nach der Genehmigung:

1. Wende nur die Vorschläge an, die der Benutzer genehmigt hat.
2. Bewahre die vorhandene Struktur der AGENTS.md auf und halte Ergänzungen präzise.
3. Führe keine allgemeine Bereinigung mit /agent-docs:learn durch; verwende /agent-docs:remember für veraltete, doppelte oder falsch platzierte vorhandene Gedächtniseinträge.
4. Melde, was geändert wurde, wo es geändert wurde und welche Kandidaten übersprungen wurden.

Ablauf

1. Überprüfe den Gesprächsverlauf auf Kandidaten-Erkenntnisse.
2. Klassifiziere jeden Kandidaten als Hidden Knowledge, Quick Reference, Rule, Doc oder Skip.
3. Führe den Non-Derivability-Test für Hidden Knowledge-Kandidaten durch.
4. Verifiziere jeden behaltenen Kandidaten und erfasse Nachweise.
5. Wähle das korrekte AGENTS.md-Ziel oder das Nur-Melden-Ziel.
6. Zeige vorgeschlagene Diffs und übersprungene Kandidaten.
7. Warte auf explizite Benutzerfreigabe.
8. Wende nur genehmigte AGENTS.md-Änderungen an.
9. Melde abschließende Schreibvorgänge, Überspringungen und verbleibende Nur-Melden-Vorschläge.