Kayunangka/claude-skill

Was macht claude-skill?

🔍 Verbessere Codesuchen mit ast-grep, indem du Muster in deiner Codestruktur findest – für eine optimierte Fehlerbehandlung und Analyse.

Diese Fähigkeit integriert ast-grep in deinen KI-Assistenten, um Code auf AST-Ebene (Abstrakter Syntaxbaum) zu durchsuchen. So kannst du problemlos:

• Komplexe Muster erkennen, die mit einfachem Text-Suchen nicht sichtbar wären.
• Fehlerbehandlungsmuster prüfen (z. B. fehlende Catch-Blöcke, falsche Fehlerweitergabe).
• API-Nutzungen analysieren (z. B. Aufrufe ohne ordnungsgemäße Fehlerprüfung).
• Anti-Patterns aufdecken und konsistente Codestandards durchsetzen.

Verwendung

1. Stelle sicher, dass ast-grep global installiert ist: npm install -g @ast-grep/cli oder cargo install ast-grep.
2. Der Skill liefert automatisch die entsprechenden ast-grep-Befehle für deine Anfragen.
3. Gib eine Anfrage zur Code-Mustererkennung ein, z. B. „Finde alle Stellen, wo error geloggt wird, aber kein throw folgt.“

Unterstützte Plattformen

• Claude Code
• Cursor
• Codex (OpenAI) – mit entsprechender Tool-Integration
• Jeder AI-Agent, der benutzerdefinierte Fähigkeiten unterstützt

Wie es funktioniert

Der Skill erzeugt ast-grep-Regeln (YAML-Format) basierend auf deiner natürlichsprachlichen Beschreibung des Musters. Er führt die Regel im Hintergrund aus und gibt die Ergebnisse als strukturierte Liste von Code-Fundstellen (Datei, Zeile, Kontext) zurück.

Beispiel-Regel (YAML):

id: missing-error-throw
language: javascript
rule:
  pattern: |
    console.error($MSG)
  inside:
    not:
      any:
        - pattern: throw $EXPR

Diese Regel findet alle console.error()-Aufrufe, die nicht in einem throw-Statement innerhalb desselben Blocks vorkommen.

Konfiguration

Keine spezielle Konfiguration erforderlich. Du kannst jedoch die Ausgabe anpassen, indem du in deiner Anfrage die gewünschte Sprache (falls nicht automatisch erkannt) oder zusätzliche Filter angibst.