Fähigkeitsmeister: Entdeckung von Codebase-Mustern und Generierung von SKILL-Dateien

--- name: skill-master description: Entdecke Codebase-Muster und generiere automatisch SKILL-Dateien für .claude/skills/. Verwende dies bei der Analyse eines Projekts auf fehlende Skills, beim Erstellen neuer Skills aus Codebase-Mustern oder beim Synchronisieren von Skills mit der Projektstruktur. version: 1.0.0 --- # Skill Master ## Überblick Analysiere die Codebase, um Muster zu entdecken und SKILL-Dateien in `.claude/skills/` zu generieren/aktualisieren. Unterstützt Multi-Plattform-Projekte mit stack-spezifischer Mustererkennung. **Fähigkeiten:** - Scanne die Codebase nach architektonischen Mustern (ViewModel, Repository, Room, etc.) - Vergleiche erkannte Muster mit vorhandenen Skills - Generiere automatisch SKILL-Dateien mit echten Codebeispielen - Versionsverfolgung und intelligente Updates ## Wie die KI dieses Skill entdeckt und nutzt Dieses Skill wird ausgelöst, wenn der Benutzer: - Bittet, das Projekt auf fehlende Skills zu analysieren - Die Generierung von Skills aus Codebase-Mustern anfordert - Vorhandene Skills synchronisieren oder aktualisieren möchte - "Skill-Discovery", "Skills generieren" oder "Skill-Sync" erwähnt **Erkennungssignale:** - Vorhandensein des Verzeichnisses `.claude/skills/` - Projektstruktur, die bekannten Mustern entspricht - Build-/Konfigurationsdateien, die auf die Plattform hinweisen (siehe Referenzen) ## Modi ### Entdeckungsmodus Analysiere die Codebase und melde fehlende Skills. **Schritte:** 1. Plattform über Build-/Konfigurationsdateien erkennen (siehe Referenzen) 2. Quellwurzeln nach Musterindikatoren scannen 3. Erkannte Muster mit vorhandenen `.claude/skills/` vergleichen 4. Gap-Analyse-Bericht ausgeben **Ausgabeformat:** ``` Erkannte Muster: {Anzahl} | Muster | Dateien gefunden | Beispiel-Speicherort | |--------|------------------|----------------------| | {Name} | {Anzahl} | {Pfad} | Vorhandene Skills: {Anzahl} Fehlende Skills: {Anzahl} - {Skill-Name}: {Muster}, {Dateianzahl} Dateien gefunden ``` ### Generierungsmodus Erstelle SKILL-Dateien aus erkannten Mustern. **Schritte:** 1. Discovery ausführen, um fehlende Skills zu identifizieren 2. Für jeden fehlenden Skill: - 2-3 repräsentative Quelldateien finden - Extrahieren: Imports, Annotationen, Klassenstruktur, Konventionen - Regeln aus `.ruler/*.md` extrahieren, falls vorhanden 3. SKILL.md mit Vorlagenstruktur generieren 4. Version und Quellmarker hinzufügen **Generierte SKILL-Struktur:** ```yaml --- name: {Muster-Name} description: {Generierte Beschreibung mit Trigger-Keywords} version: 1.0.0 --- # {Titel} ## Überblick {Kurzbeschreibung aus der Musteranalyse} ## Dateistruktur {Aus der Codebase extrahiert} ## Implementierungsmuster {Echte Codebeispiele - anonymisiert} ## Regeln ### Do {Aus .ruler/*.md + Codebase-Konventionen} ### Don't {Gefundene Anti-Patterns} ## Dateispeicherort {Tatsächliche Pfade aus der Codebase} ``` ## Erstellungsstrategie Wenn die Ziel-SKILL-Datei nicht existiert: 1. Neue Datei mit Vorlage generieren 2. `version: 1.0.0` im Frontmatter setzen 3. Alle Pflichtabschnitte einfügen 4. Quellmarker am Ende hinzufügen (siehe Marker-Format) ## Aktualisierungsstrategie **Marker-Prüfung:** Suche nach `<!-- Generated by skill-master command` am Dateiende. **Wenn Marker vorhanden (Folgelauf):** - Intelligenter Merge: Benutzerdefinierten Inhalt bewahren, fehlende Abschnitte hinzufügen - Version erhöhen: Major (Breaking) / Minor (Feature) / Patch (Fix) - Quellenliste im Marker aktualisieren **Wenn Marker nicht vorhanden (erster Lauf bei vorhandener Datei):** - Backup: `SKILL.md` → `SKILL.md.bak` - Backup als Quelle verwenden, relevanten Inhalt extrahieren - Neue Datei mit Marker generieren - `version: 1.0.0` setzen ## Marker-Format Am ENDE der generierten SKILL.md platzieren: ```html <!-- Generated by skill-master command Version: {Version} Quellen: - pfad/zu/quelle1.kt - pfad/zu/quelle2.md - .ruler/regel-datei.md Zuletzt aktualisiert: {JJJJ-MM-TT} --> ``` ## Plattform-Referenzen Relevante Referenz lesen, wenn Plattform erkannt wird: | Plattform | Erkennungsdateien | Referenz | |-----------|-------------------|----------| | Android/Gradle | `build.gradle`, `settings.gradle` | `references/android.md` | | iOS/Xcode | `*.xcodeproj`, `Package.swift` | `references/ios.md` | | React (Web) | `package.json` + react | `references/react-web.md` | | React Native | `package.json` + react-native | `references/react-native.md` | | Flutter/Dart | `pubspec.yaml` | `references/flutter.md` | | Node.js | `package.json` | `references/node.md` | | Python | `pyproject.toml`, `requirements.txt` | `references/python.md` | | Java/JVM | `pom.xml`, `build.gradle` | `references/java.md` | | .NET/C# | `*.csproj`, `*.sln` | `references/dotnet.md` | | Go | `go.mod` | `references/go.md` | | Rust | `Cargo.toml` | `references/rust.md` | | PHP | `composer.json` | `references/php.md` | | Ruby | `Gemfile` | `references/ruby.md` | | Elixir | `mix.exs` | `references/elixir.md` | | C/C++ | `CMakeLists.txt`, `Makefile` | `references/cpp.md` | | Unbekannt | - | `references/generic.md` | Wenn mehrere Plattformen erkannt werden, mehrere Referenzen lesen. ## Regeln ### Do - Nur Muster extrahieren, die in der Codebase verifiziert wurden - Echte Codebeispiele verwenden (Geschäftslogik anonymisieren) - Trigger-Keywords in die Beschreibung aufnehmen - SKILL.md unter 500 Zeilen halten - Externe Dateien für detaillierte Inhalte referenzieren - Benutzerdefinierte Abschnitte bei Updates bewahren - Vor der ersten Änderung immer ein Backup erstellen ### Don't - Geheimnisse, Token oder Anmeldedaten einfügen - Geschäftsspezifische Logikdetails einfügen - Platzhalter ohne echten Inhalt generieren - Benutzeranpassungen ohne Backup überschreiben - Tiefe Referenzketten erstellen (max. 1 Ebene) - Außerhalb von `.claude/skills/` schreiben ## Regeln zur Inhaltsextraktion **Aus der Codebase:** - Extrahieren: Klassenstrukturen, Annotationen, Importmuster, Dateispeicherorte, Namenskonventionen - Niemals: Hardcodierte Werte, Geheimnisse, API-Schlüssel, personenbezogene Daten **Aus .ruler/*.md (falls vorhanden):** - Extrahieren: Do/Don't-Regeln, Architekturbeschränkungen, Abhängigkeitsregeln ## Ausgabebericht Nach der Generierung ausgeben: ``` SKILL-GENERIERUNGSBERICHT Generierte Skills: {Anzahl} {Skill-Name} [ERSTELLT | AKTUALISIERT | BACKUP+ERSTELLT] ├── Analysiert: {Dateianzahl} Quelldateien ├── Quellen: {Liste der Quelldateien} ├── Regeln aus: {.ruler-Dateien, falls vorhanden} └── Ausgabe: .claude/skills/{Skill-Name}/SKILL.md ({Zeilenzahl} Zeilen) Validierung: ✓ YAML-Frontmatter gültig ✓ Beschreibung enthält Trigger-Keywords ✓ Inhalt unter 500 Zeilen ✓ Erforderliche Abschnitte vorhanden ``` ## Sicherheitsbeschränkungen - Niemals außerhalb von `.claude/skills/` schreiben - Niemals Inhalte ohne Backup löschen - Vor der ersten Änderung immer ein Backup erstellen - Benutzeranpassungen bewahren - Deterministisch: gleiche Eingabe → gleiche Ausgabe