Wissensdatenbank-Pflege-Skill

Projektwissens-Pfleger

Zweck

Nutzen Sie diesen Skill, um eine projektbezogene Wissensdatenbank für KI-Codierungsagenten zu initialisieren, zu pflegen und weiterzuentwickeln. Die Wissensdatenbank hilft künftigen Agentensitzungen, den Projektzweck, die Architektur, Schnittstellen, Entscheidungen, Fehler und aktuelle Änderungen zu verstehen, ohne alles von Grund auf neu entdecken zu müssen.

Halten Sie den Workflow werkzeugneutral. Er sollte von Codex, Claude Code, Cursor, Gemini CLI und anderen Codierungsagenten nutzbar sein, die Projektdateien lesen und repository-lokale Anweisungen befolgen können.

Wann verwenden

Verwenden Sie diesen Skill, wenn der Benutzer bittet:

• eine Wissensdatenbank für ein Projekt zu initialisieren
• ein Projekt zusammenzufassen oder zu dokumentieren
• einen Fehler zu beheben und die Reparaturerfahrung festzuhalten
• eine Funktion hinzuzufügen oder zu ändern
• eine API, ein Schema, einen Befehl oder ein Datenformat hinzuzufügen oder zu ändern
• eine technische Entscheidung oder einen Kompromiss festzuhalten
• rohe Projektmaterialien in strukturiertes Wissen zu organisieren
• eine abgeschlossene Entwicklungssitzung zu überprüfen oder nachzubereiten
• AGENTS.md oder Dateien unter knowledge/ zu aktualisieren

Eingaben

Häufige Eingaben sind:

• Der aktuelle Repository- oder Zielprojektpfad.
• Vorhandene Projektdateien, Quellcode, Dokumentation, Issues, Logs oder Rohmaterialien.
• Die aktuelle Aufgabe des Benutzers und alle während der Sitzung vorgenommenen Implementierungsänderungen.
• Vorhandene Inhalte von AGENTS.md, knowledge/, raw/ oder skills/, falls vorhanden.

Ausgaben

Erwartete Ausgaben sind:

• AGENTS.md – Projektregeln.
• knowledge/overview.md – Projektübersicht.
• knowledge/business.md – Geschäftslogik und Nutzungsszenarien.
• knowledge/architecture.md – Systemarchitektur und Datenfluss.
• knowledge/api.md – Schnittstellen, Schemata, Befehle und Datenstrukturen.
• knowledge/decisions.md – Technische Entscheidungen und Kompromisse.
• knowledge/bugs.md – Fehlerhistorie, Ursachen, Behebungen und Vorbeugungsregeln.
• knowledge/changelog.md – Änderungsprotokolle auf Sitzungsebene.
• Optionale Ordner raw/ und projektlokale skills/.
• Ein kurzer Abschlussbericht, der auflistet, was aktualisiert wurde und was noch überprüft werden muss.

Workflow

1. Zuerst die Projektregeln lesen:
   • AGENTS.md, falls vorhanden.
   • knowledge/overview.md
   • knowledge/architecture.md
   • knowledge/decisions.md
   • knowledge/bugs.md
2. Bei der Initialisierung eines Repositorys die Vorlagen in references/templates/ verwenden oder das Initialisierungsskript aus diesem Paket ausführen.
3. Die aktuelle Aufgabe verstehen und identifizieren, was sich geändert hat:
   • Projektziel oder Geschäftslogik
   • Architektur oder Modulgrenzen
   • API, Befehl, Datendatei, Schema oder Rückgabestruktur
   • Fehlersymptom, Ursache, Behebung oder Vorbeugungsregel
   • technische Entscheidung oder Kompromiss
   • benutzerseitiges Verhalten oder UI-Konvention
4. Nur die relevanten Wissensdateien aktualisieren.
5. Doppelte, veraltete oder widersprüchliche Inhalte entfernen oder angleichen.
6. Nach wichtigen Arbeiten immer knowledge/changelog.md aktualisieren.
7. Die aktualisierten Dateien und etwaige fehlende Validierungen melden.

Ausführlichere Pflegehinweise finden Sie in references/playbook.md.

Aktualisieren von knowledge/

Die kleinste Datei verwenden, die zur Änderung passt:

• overview.md für dauerhaften Projektzweck, -umfang, Hauptmodule und Hauptausgaben aktualisieren.
• business.md für Benutzerszenarien, Arbeitsabläufe, Domänenregeln und Sicherheitsgrenzen aktualisieren.
• architecture.md für Modulbeziehungen, Datenfluss, Laufzeitmodi und Integrationsgrenzen aktualisieren.
• api.md für Endpunkte, Funktionen, Befehle, Ereignisse, Datendateien, Schemata und Rückgabestrukturen aktualisieren.
• decisions.md für bedeutende technische Entscheidungen und Kompromisse aktualisieren.
• bugs.md für bestätigte Fehler und gewonnene Erkenntnisse aktualisieren.
• changelog.md für jede wichtige Aufgabenübersicht aktualisieren.

Vergängliche Überlegungen nicht in die Wissensdatenbank übernehmen. Stabile Fakten, validierte Entscheidungen und wiederverwendbare Lektionen bevorzugen.

Fehler-Nachbetrachtungen

Wenn ein Fehler behoben ist, knowledge/bugs.md aktualisieren mit:

• Problemsymptom.
• Ursache.
• Behebung.
• Betroffener Umfang.
• Durchgeführte Validierung.
• Regel zur Vermeidung eines erneuten Auftretens.

Wenn die Ursache unsicher ist, als „ausstehende Überprüfung“ markieren, anstatt zu raten.

Schnittstellenänderungen

Wenn eine API, ein Befehl, eine Funktion, ein Schema, eine CSV, ein Ereignis oder ein Dateiformat geändert wird, knowledge/api.md aktualisieren mit:

• Schnittstellenname.
• Anforderungsmethode oder Aufrufart.
• Pfad, Befehl, Funktionsname oder Dateipfad.
• Eingaben und Parameter.
• Antwort- oder Ausgabeformat.
• Hinweise, Einschränkungen und Beispiele.

Exakte Namen und Feld-Schreibweisen verwenden.

Technische Entscheidungen

Wenn eine bedeutende technische Entscheidung getroffen wird, knowledge/decisions.md aktualisieren mit:

• Hintergrund der Entscheidung.
• In Betracht gezogene Optionen.
• Endgültige Wahl.
• Grund für die Wahl.
• Konsequenzen und Folgearbeiten.

Entscheidungen festhalten, die zukünftigen Agenten helfen, abgeschlossene Fragen nicht erneut aufzuwerfen.

Vermeidung von Wissensverrottung

• Bevorzugt einen vorhandenen Eintrag bearbeiten, anstatt einen fast identischen Eintrag hinzuzufügen.
• Veraltete Inhalte als ersetzt markieren oder durch den aktuellen Fakt ersetzen.
• Projektfakten von Spekulationen trennen.
• Daten für Entscheidungen, Fehler und Changelog-Einträge verwenden.
• Formulierungen agentenneutral halten, es sei denn, eine bestimmte Tool-Integration erfordert eine tool-spezifische Notiz.
• Benutzerverfasste Projektregeln nicht ohne ausdrückliche Aufforderung überschreiben.

Abschlussantwort

Die Abschlussantwort kurz halten. Enthalten:

• Aktualisierte Dateien.
• Durchgeführte Validierung.
• Verbleibende manuelle Prüfungen.