pur4v/scout

Was macht scout?

Eine Claude-Fertigkeit zum Erkunden unbekannter Codebasen und zur Rückkehr von verifizierten Informationen – Kartieren, Verfolgen, Verifizieren und Prüfen von Multi-Repo-Systemen.

Übersicht

Scout hilft dir, Codebasen zu navigieren, indem es:

• Karten von Ordnerstrukturen, Abhängigkeiten und Modulbeziehungen erstellt
• Spuren von Funktionsaufrufen, Imports und Datenflüssen verfolgt
• Verifiziert, dass Annahmen mit tatsächlichem Quellcode übereinstimmen
• Systemübergreifend prüft, ob Protokolle, Schnittstellen und Verträge konsistent sind.

Verwendung

Aktiviere Scout mit natürlichen Anweisungen, wie:

• "Kartiere die Struktur des services/-Verzeichnisses"
• "Verfolge, wie die Funktion handleLogin aufgerufen wird"
• "Verifiziere, ob das Modul auth tatsächlich die erwarteten Endpunkte exportiert"
• "Prüfe die gesamte Repo-Organisation und finde Probleme in Konfigurationsdateien"

Funktionsweise

1. Eingabe: Benutzer gibt ein Ziel an (Datei, Ordner, Funktion oder Muster).
2. Analyse: Scout listet Verzeichnisse, liest relevante Dateien und extrahiert Symbole.
3. Verfolgung: Verwendet Suchmuster, um Aufrufe und Importe in der gesamten Codebasis zu finden.
4. Verifizierung: Kreuzvergleiche mit der Dokumentation, Typdefinitionen oder erwarteten Verhaltensweisen.
5. Ausgabe: Gibt eine strukturierte Zusammenfassung mit den Ergebnissen und etwaigen Warnungen oder Inkonsistenzen zurück.

Beispiel

# Kartiere die Ordnerstruktur
ls -R src/ | head -30

# Beispiel: Verfolge Funktionsaufrufe
import ast

class FunctionVisitor(ast.NodeVisitor):
    def visit_FunctionDef(self, node):
        print(f"Gefundene Funktion: {node.name}")
        self.generic_visit(node)

Einschränkungen

• Funktioniert am besten mit gut strukturierten Codebasen (Modularer Code).
• Bei sehr großen Repos kann die Leistung beeinträchtigt sein.
• Kann nur das analysieren, was innerhalb des Kontextfensters von Claude sichtbar ist – für vollständige Audits ist möglicherweise eine externe Integration erforderlich.

Lizenz

MIT – Siehe LICENSE-Datei für Details.