Was macht ghost-repo-context?
Durchsucht die Verzeichnisstruktur, erkennt Projekte, kartiert Abhängigkeiten und dokumentiert die Codeorganisation in einer repo.md-Datei. Verwenden Sie dies, wenn der Benutzer eine Codebasis-Übersicht, eine Projektstruktur-Karte oder einen Repository-Kontext vor einer Sicherheitsanalyse benötigt.
Funktionsweise
Dieses Skill analysiert das angegebene Repository rekursiv, identifiziert Projektdateien und -abhängigkeiten und erstellt einen strukturierten Bericht im Markdown-Format.
- Verzeichnisscan: Durchsucht alle Ordner des Repositorys nach Quellcode-Dateien und Konfigurationsdateien.
- Projekterkennung: Erkennt Projekttypen anhand typischer Konfigurationsdateien wie
package.json(Node.js),requirements.txt(Python),pom.xml(Java) oderCargo.toml(Rust). - Abhängigkeitskartierung: Listet alle externen und internen Abhängigkeiten auf, die im Projekt verwendet werden.
- Dokumentation: Schreibt die Ergebnisse in eine
repo.md-Datei im Stammverzeichnis des Repositorys.
Verwendung
# Repository analysieren (Standardpfad: aktuelles Verzeichnis)
repo-context
# Bestimmten Pfad analysieren
repo-context --path /pfad/zum/repository
# Ausgabedatei festlegen
repo-context --output /pfad/zur/repo.md
Ausgabeformat
Die generierte repo.md enthält folgende Abschnitte:
- Projektübersicht: Name, Typ und Kurzbeschreibung des Hauptprojekts.
- Verzeichnisstruktur: Hierarchische Darstellung der Ordnerstruktur.
- Erkannte Projekte: Liste aller identifizierten Projekte mit ihren Metadaten.
- Abhängigkeiten: Tabelle mit Abhängigkeitsname, Version und Typ.
- Hauptdateien: Wichtige Dateien wie Konfigurationen, Einstiegspunkte und Tests.
Konfiguration
Über Umgebungsvariablen können folgende Einstellungen vorgenommen werden:
| Variable | Beschreibung | Standard |
|---|---|---|
REPO_CONTEXT_PATH | Pfad zum Repository | . |
REPO_CONTEXT_OUTPUT | Ausgabedatei | repo.md |
REPO_CONTEXT_DEPTH | Maximale Tiefe der Analyse | 5 |
Hinweise
- Große Repositorys können die Analysezeit verlängern; beschränken Sie die Tiefe bei Bedarf.
- Empfindliche Informationen wie API-Schlüssel in Code-Dateien werden nicht automatisch gefiltert – bitte überprüfen Sie die Ausgabe vor der Weitergabe.
- Dieses Skill ist optimiert für die Verwendung mit KI-Agenten wie Claude Code, Cursor und Codex.