Busca de código local
Instalação e peculiaridades
Leia configuração e solução de problemas quando faltarem ferramentas, ao instalar esta skill em outra máquina, verificar aceleração ou atualizá-la. Não instale ou reconfigure ferramentas apenas porque uma tarefa de código comum invoca esta skill. O cgrep helper portátil opcional fornece flags de busca; configurações específicas de plataforma e seus limites estão documentados na configuração.
Comece com orientação
No início de uma sessão de codificação, e antes de investigar uma refatoração ou pergunta complexa de código, leia as instruções do repositório e as orientações relevantes do projeto, em seguida use um outline com escopo definido como a primeira passagem de navegação no código antes de leituras amplas de fontes ou planejamento de implementação. Leia o subguia de outline.
Escolha o menor pacote, diretório ou arquivo relevante; não faça outline de um monorepo inteiro por padrão. Se a área for desconhecida, use nomes de arquivo ou uma consulta ColGREP focada para encontrar candidatos, depois faça o outline deles. Reutilize um outline já atual nesta sessão; atualize arquivos afetados após edições estruturais. Consultas simples de busca exata, pequenas alterações em código já compreendido e conversas não relacionadas a código podem prosseguir diretamente. Este é um hábito de trabalho, não um processo em segundo plano ou uma varredura a cada turno.
Escolha a próxima ferramenta
Escolha com base no que se sabe sobre o alvo e leia apenas o subguia relevante. Esses guias pertencem a esta skill, não a registros de skills separados.
| Necessidade | Ferramenta | Subguia |
|---|---|---|
| Orientação de sessão, superfície de refatoração ou investigação de código complexo | ast-grep outline | Outline primeiro |
| String exata, mensagem de erro, nome de arquivo ou ocorrência de identificador simples | rg | Busca exata |
| Encontrar uma implementação a partir da descrição de um comportamento | ColGREP / cgrep | Descoberta semântica |
| Sintaxe, relações dentro da estrutura do código, alterações baseadas em sintaxe repetíveis | ast-grep | Busca estrutural |
Comece com um escopo estreito de arquivo ou diretório quando a área relevante for conhecida. É normal descobrir candidatos com ColGREP, inspecionar um símbolo conhecido com rg e refinar um padrão sintático com ast-grep. Não execute todos os três automaticamente. Use ferramentas nativas do agente para ler/editar arquivos, testes e operações git.
Os resultados de busca localizam candidatos; inspecione a fonte relevante antes de fazer uma afirmação comportamental. Não trate correspondências sintáticas como referências resolvidas por tipo.
Uma instalação canônica atende Codex e Claude Code. Mantenha a orientação das ferramentas aqui; não reinstale skills de ferramentas independentes nem ative hooks de busca duplicados.