CommunityRedacción y edicióngithub.com

DerrickZeng33/find-files-with-everything

Búsqueda rápida de archivos en Windows para Codex, Claude Code y agentes de IA compatibles utilizando el CLI de Voidtools Everything.

¿Qué es find-files-with-everything?

Este skill permite a los agentes de IA (como Claude Code, Cursor, Codex y otros) realizar descubrimiento de archivos en Windows a gran velocidad utilizando el motor de indexación de Voidtools Everything a través de su herramienta de línea de comandos `es.exe`. Está diseñado para minimizar el número de llamadas a herramientas y reducir el volumen de texto devuelto, optimizando así el rendimiento del agente. El skill guía al agente para elegir la ruta de búsqueda más eficiente (usar `Test-Path` para rutas exactas, `rg` para búsquedas dentro del espacio de trabajo conocido, y Everything para exploraciones amplias o fuera del espacio de trabajo). Incluye ejemplos concretos de consultas en PowerShell con filtros como `ext:`, `size:`, `-path`, y especifica cómo limitar resultados, usar JSON solo cuando sea necesario y tratar correctamente los casos de resultados cero. La filosofía clave es mantener las búsquedas como de solo lectura, sin modificar el índice de Everything ni los archivos del sistema.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Buscar archivos con Everything

Usa es.exe como un cliente de solo lectura para el índice de Everything en ejecución. Minimiza las llamadas a herramientas y el texto devuelto.

Enrutar la búsqueda

  1. Usa Test-Path o Get-Item para una ruta exacta conocida.
  2. Usa rg --files para nombres de archivo dentro de un espacio de trabajo conocido y rg para contenido en un árbol conocido.
  3. Usa Everything primero cuando la ubicación sea desconocida, esté fuera del espacio de trabajo, abarque todo el equipo o se base en metadatos indexados.

Ejecutar una consulta eficiente

  1. Verifica la disponibilidad como máximo una vez por sesión, o después de una consulta fallida:

    Get-Command es.exe -ErrorAction SilentlyContinue
    

    De lo contrario, ejecuta la búsqueda directamente. Si ES falta o devuelve un error IPC 8, usa un respaldo de alcance reducido. No instales, inicies ni repares software a menos que el usuario lo solicite.

  2. Reduce la consulta antes de aumentar la salida:

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

    Usa /ad para carpetas, /a-d para archivos, -path para un subárbol, y términos de búsqueda de Everything como ext:, size:, dm: y dc:. Pon entre comillas las rutas y términos que contengan espacios.

  3. Al invocar desde PowerShell 7 o posterior, coloca -argv primero. Omítelo en Windows PowerShell 5.1 y otros shells.

  4. Devuelve rutas simples por defecto. Usa -json y columnas adicionales solo cuando se requieran metadatos estructurados. Usa -get-result-count solo cuando el recuento sea importante o una consulta limitada necesite refinamiento.

  5. Mantén el límite predeterminado en 20. Si se alcanza el límite, refina la consulta antes de solicitar más resultados. No exportes resultados a un archivo a menos que se te pida.

Informar el resultado

  • Devuelve el conjunto más pequeño suficiente de rutas exactas y resume las coincidencias omitidas.
  • Indica la consulta o el ámbito cuando no se encuentre ningún resultado.
  • Trata una búsqueda con cero resultados como evidencia sobre el índice actual de Everything, no como prueba de que una ubicación no indexada esté vacía.
  • Evita content: para un árbol de proyecto conocido; no está indexado por defecto y suele ser menos eficiente que rg.

Mantén las búsquedas de solo lectura

No uses opciones de ES que cambien el estado, como -exit, -reindex, -save-db, modificadores de contador de ejecuciones o cambios en configuraciones guardadas. No elimines, muevas, copies ni abras resultados a menos que el usuario lo solicite por separado.

Skills relacionados