CommunitySchreiben & Editierengithub.com

DerrickZeng33/find-files-with-everything

Schnelle Windows-Dateisuche für Codex, Claude Code und kompatible KI-Agenten mittels Voidtools Everything CLI.

Was ist find-files-with-everything?

Dieses Skill ermöglicht es KI-Agenten auf Windows-Systemen, extrem schnell Dateien und Ordner zu finden, indem es das `es.exe`-CLI-Tool von Voidtools Everything als schreibgeschützten Client nutzt. Es ist speziell für Entwicklungsumgebungen wie Codex, Claude Code und andere kompatible KI-Agenten ausgelegt. Der Skill priorisiert die Everything-Suche gegenüber traditionellen Methoden wie `rg` (ripgrep) oder `Test-Path`, wenn der Speicherort unbekannt ist, außerhalb des Arbeitsbereichs liegt oder auf indizierten Metadaten wie Dateigröße, Änderungsdatum oder Erweiterung basiert. Er definiert klare Richtlinien für effiziente Abfragen: Standardmäßig werden maximal 20 Ergebnisse zurückgegeben, die Abfrage muss präzise sein (z. B. durch `-path`, `-n`, `ext:`, `size:`), bevor die Ausgabe erhöht wird. Der Agent muss schreibgeschützt bleiben, keine Zustandsänderungen wie `-reindex` oder `-exit` vornehmen und Ergebnisse nicht in Dateien exportieren. Bei Fehlern (z. B. fehlendes `es.exe` oder IPC-Fehler 8) wird auf eine eng gefasste Fallback-Suche zurückgegriffen, ohne Software zu installieren oder zu reparieren. Die Ausgabe erfolgt standardmäßig als reine Pfadliste, nur bei Bedarf mit `-json` und zusätzlichen Spalten. Das Skill ist für PowerShell 5.1, PowerShell 7+ und andere Shells optimiert und vermeidet unnötige Aufrufe von `rg` oder `content:` für indizierte Bereiche.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add DerrickZeng33/find-files-with-everything

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Find Files With Everything

Verwenden Sie es.exe als schreibgeschützten Client für den laufenden Everything-Index. Minimieren Sie Tool-Aufrufe und zurückgegebenen Text.

Leiten Sie die Suche

  1. Verwenden Sie Test-Path oder Get-Item für einen exakt bekannten Pfad.
  2. Verwenden Sie rg --files für Dateinamen innerhalb eines bekannten Arbeitsbereichs und rg für Inhalte in einem bekannten Verzeichnisbaum.
  3. Verwenden Sie Everything zuerst, wenn der Speicherort unbekannt ist, außerhalb des Arbeitsbereichs liegt, systemweit oder auf indizierten Metadaten basiert.

Führen Sie eine effiziente Abfrage durch

  1. Überprüfen Sie die Verfügbarkeit höchstens einmal pro Sitzung oder nach einer fehlgeschlagenen Abfrage:

    Get-Command es.exe -ErrorAction SilentlyContinue
    

    Führen Sie andernfalls die Suche direkt aus. Wenn ES fehlt oder den IPC-Fehler 8 zurückgibt, verwenden Sie eine eng gefasste Fallback-Suche. Installieren, starten oder reparieren Sie keine Software, es sei denn, der Benutzer fordert dies an.

  2. Grenzen Sie die Abfrage ein, bevor Sie die Ausgabe erhöhen:

    es.exe -n 20 "report"
    es.exe -path "C:\Work" /a-d -n 20 "ext:xlsx"
    es.exe -size -dm -n 20 "size:>1gb"
    

    Verwenden Sie /ad für Ordner, /a-d für Dateien, -path für einen Unterbaum und Everything-Suchbegriffe wie ext:, size:, dm: und dc:. Setzen Sie Pfade und Begriffe, die Leerzeichen enthalten, in Anführungszeichen.

  3. Wenn Sie von PowerShell 7 oder höher aufrufen, setzen Sie -argv an die erste Stelle. Lassen Sie es in Windows PowerShell 5.1 und anderen Shells weg.

  4. Geben Sie standardmäßig einfache Pfade zurück. Verwenden Sie -json und zusätzliche Spalten nur, wenn strukturierte Metadaten erforderlich sind. Verwenden Sie -get-result-count nur, wenn die Anzahl wichtig ist oder eine begrenzte Abfrage verfeinert werden muss.

  5. Behalten Sie das Standardlimit von 20 bei. Wenn das Limit erreicht ist, verfeinern Sie die Abfrage, bevor Sie weitere Ergebnisse anfordern. Exportieren Sie Ergebnisse nicht in eine Datei, es sei denn, Sie werden darum gebeten.

Melden Sie das Ergebnis

  • Geben Sie die kleinste ausreichende Menge an exakten Pfaden zurück und fassen Sie ausgelassene Treffer zusammen.
  • Geben Sie die Abfrage oder den Bereich an, wenn kein Ergebnis gefunden wurde.
  • Behandeln Sie eine Suche mit null Ergebnissen als Hinweis auf den aktuellen Everything-Index, nicht als Beweis dafür, dass ein nicht indizierter Speicherort leer ist.
  • Vermeiden Sie content: für einen bekannten Projektbaum; es ist standardmäßig nicht indiziert und normalerweise weniger effizient als rg.

Halten Sie Suchvorgänge schreibgeschützt

Verwenden Sie keine ES-Optionen, die den Zustand ändern, wie -exit, -reindex, -save-db, Laufzähler-Setter oder Änderungen an gespeicherten Einstellungen. Löschen, verschieben, kopieren oder öffnen Sie keine Ergebnisse, es sei denn, der Benutzer fordert dies separat an.

Verwandte Skills