Was macht update-oo-component-documentation?
Aktualisieren Sie vorhandene objektorientierte Komponentendokumentation gemäß bewährter Branchenpraktiken und Architekturdokumentationsstandards.
Beschreibung
Diese Fähigkeit überprüft automatisch vorhandene objektorientierte (OO) Komponentendokumentation und gleicht sie mit Industriestandards für Architektur- und Softwaredokumentation ab. Sie identifiziert Lücken, veraltete Abschnitte und Inkonsistenzen und generiert Aktualisierungen, die die Dokumentation auf dem neuesten Stand halten. Der Skill konzentriert sich auf Schlüsselaspekte wie Klassenspezifikationen, Vererbungshierarchien, Schnittstellenverträge und Abhängigkeitsdiagramme.
Verwendung
- Laden Sie den Skill in Ihre agentenbasierte Entwicklungsumgebung (z. B. Claude Code, Cursor).
- Bereiten Sie vorhandene Dokumentation vor: Stellen Sie sicher, dass die OO-Komponentendokumentation im Projektverzeichnis vorhanden ist (z. B.
docs/components/). - Ruft den Skill auf: Verwenden Sie einen Befehl oder eine Anfrage wie:
/skill update-oo-component-documentation --component UserAuthentication - Überprüfen der Änderungen: Der Skill generiert einen Patch oder schlägt Änderungen direkt in der Dokumentation vor. Überprüfen und akzeptieren Sie sie nach Bedarf.
Anforderungen
- Zugriff auf das Repository mit vorhandener OO-Codebasis und Dokumentation.
- Unterstützte Plattformen: Claude Code, Cursor, Codex (oder andere kompatible Agenten).
- Abhängigkeiten:
git,python3odernode(falls Skriptausführung erforderlich ist).
Konfiguration
Sie können den Skill konfigurieren, indem Sie eine .skillconfig-Datei im Stammverzeichnis des Projekts ablegen:
oo_components:
doc_path: docs/components
template: standard-oo-doc.md
languages:
- Java
- Python
- C++
strict_mode: false
Beispiel
Vor:
# Klasse: Benutzer
Diese Klasse repräsentiert einen Benutzer.
Nach (vorgeschlagene Aktualisierung):
# Klasse: Benutzer
**Verantwortlichkeit:** Verwaltet Benutzerauthentifizierung und Profildaten.
**Vererbung:** Erbt von `BaseEntity`.
**Abhängigkeiten:** `DatabaseService`, `Logger`.
**Prinzipien:** Folgt dem Single-Responsibility-Prinzip.
Lizenz
Siehe LICENSE im Repository.