Lokale Code-Suche
Installation und Fallstricke
Lies Setup und Fehlerbehebung, wenn Werkzeuge fehlen, dieses Skill auf einer anderen Maschine installiert wird, Beschleunigung geprüft oder Updates durchgeführt werden müssen. Installiere oder konfiguriere Werkzeuge nicht neu, nur weil eine normale Code-Aufgabe dieses Skill aufruft. Der optionale portable cgrep-Helfer stellt Such-Flags bereit; plattformspezifische Einstellungen und deren Grenzen sind im Setup dokumentiert.
Starte mit Orientierung
Zu Beginn einer Coding-Session und bevor du ein Refactoring oder eine komplexe Code-Frage untersuchst, lies die Anweisungen des Repositorys und relevante Projekt-Hinweise. Verwende dann einen eingegrenzten Umriss als ersten Code-Navigations-Schritt, bevor du breite Quelltext-Durchläufe oder Implementierungsplanungen startest. Lies dazu den Umriss-Subguide.
Wähle das kleinste relevante Paket, Verzeichnis oder die kleinste relevante Datei; skizziere nicht standardmäßig ein gesamtes Monorepo. Falls der Bereich unbekannt ist, finde Kandidaten über Dateinamen oder eine fokussierte ColGREP-Abfrage und skizziere sie dann. Verwende einen bereits in dieser Session aktuellen Umriss erneut; aktualisiere betroffene Dateien nach strukturellen Änderungen. Einfache exakte Nachschlagevorgänge, kleine Änderungen in bereits verstandenem Code und Nicht-Code-Chats können direkt erfolgen. Dies ist eine Arbeitsgewohnheit, kein Hintergrundprozess oder eine dauerhafte Suche.
Wähle das nächste Werkzeug
Wähle basierend auf dem, was über das Ziel bekannt ist, und lies nur den relevanten Subguide. Diese Guides gehören zu diesem Skill, nicht zu separaten Skill-Registrierungen.
| Bedarf | Werkzeug | Subguide |
|---|---|---|
| Session-Orientierung, Refactoring-Oberfläche oder komplexe Code-Untersuchung | ast-grep outline | Zuerst umreißen |
| Exakter String, Fehlermeldung, Dateiname oder einfaches Identifier-Vorkommen | rg | Exakte Suche |
| Implementierung anhand einer Verhaltensbeschreibung finden | ColGREP / cgrep | Semantische Entdeckung |
| Syntax, Beziehungen innerhalb der Code-Struktur, wiederholbare syntaxbasierte Änderungen | ast-grep | Strukturelle Suche |
Beginne mit einem engen Datei- oder Verzeichnis-Scope, wenn der relevante Bereich bekannt ist. Es ist normal, Kandidaten mit ColGREP zu entdecken, ein bekanntes Symbol mit rg zu untersuchen und ein syntaktisches Muster mit ast-grep zu verfeinern. Führe nicht automatisch alle drei aus. Verwende native Agenten-Werkzeuge zum Lesen/Bearbeiten von Dateien, für Tests und Git-Operationen.
Suchergebnisse lokalisieren Kandidaten; untersuche die relevante Quelle, bevor du eine Verhaltensaussage triffst. Behandle syntaktische Treffer nicht als typaufgelöste Referenzen.
Eine kanonische Installation dient Codex und Claude Code. Pflege die Werkzeug-Anleitung hier; installiere keine eigenständigen Werkzeug-Skills neu und aktiviere keine doppelten Such-Hooks.