Búsqueda local de código
Instalación y advertencias
Lee configuración y solución de problemas cuando falten herramientas, al instalar esta habilidad en otra máquina, al verificar la aceleración o al actualizarla. No instales ni reconfiguren herramientas solo porque una tarea de código normal invoque esta habilidad. El ayudante portátil opcional cgrep proporciona marcas de búsqueda; las configuraciones específicas de la plataforma y sus límites están documentados en la configuración.
Comienza con orientación
Al inicio de una sesión de codificación, y antes de investigar una refactorización o pregunta compleja de código, lee las instrucciones del repositorio y la guía del proyecto relevante, luego usa un esquema con ámbito como primer paso de navegación antes de lecturas amplias de código fuente o planificación de implementación. Lee la subguía de esquemas.
Elige el paquete, directorio o archivo relevante más pequeño; no hagas un esquema de todo un monorepo por defecto. Si el área es desconocida, usa nombres de archivo o una consulta ColGREP enfocada para encontrar candidatos, luego haz el esquema. Reutiliza un esquema ya actual en esta sesión; actualiza los archivos afectados después de ediciones estructurales. Las búsquedas exactas simples, los cambios pequeños en código ya comprendido y los chats no relacionados con código pueden proceder directamente. Esto es un hábito de trabajo, no un proceso en segundo plano ni un análisis en cada turno.
Elige la siguiente herramienta
Elige según lo que se sepa sobre el objetivo, y lee solo la subguía relevante. Estas guías pertenecen a esta habilidad, no a registros de habilidades separados.
| Necesidad | Herramienta | Subguía |
|---|---|---|
| Orientación de sesión, superficie de refactorización o investigación de código complejo | ast-grep outline | Esquema primero |
| Cadena exacta, mensaje de error, nombre de archivo o identificador simple | rg | Búsqueda exacta |
| Encontrar una implementación a partir de una descripción de comportamiento | ColGREP / cgrep | Descubrimiento semántico |
| Sintaxis, relaciones dentro de la estructura del código, cambios basados en sintaxis repetibles | ast-grep | Búsqueda estructural |
Comienza con un alcance de archivo o directorio estrecho cuando se conozca el área relevante. Es normal descubrir candidatos con ColGREP, inspeccionar un símbolo conocido con rg y refinar un patrón sintáctico con ast-grep. No ejecutes las tres automáticamente. Usa las herramientas nativas del agente para leer/editar archivos, pruebas y operaciones de git.
Los resultados de búsqueda localizan candidatos; inspecciona la fuente relevante antes de hacer una afirmación de comportamiento. No trates coincidencias sintácticas como referencias resueltas por tipo.
Una instalación canónica sirve para Codex y Claude Code. Mantén la guía de herramientas aquí; no reinstales habilidades de herramientas independientes ni actives ganchos de búsqueda duplicados.