O que spotter faz?
Uma habilidade de agente de "escopo antes da leitura" (SKILL.md) que localiza arquivos relevantes antes que seu agente de codificação os leia. Como um observador de atirador apontando coordenadas.
Visão Geral
O Spotter implementa o padrão escopo antes da leitura para agentes de codificação. Ele ajuda a:
- Reduzir o consumo de tokens lendo apenas arquivos relevantes
- Acelerar o processamento evitando buscas cegas no diretório
- Melhorar a precisão fornecendo contexto direcionado
Como Funciona
O Spotter usa comandos como find, grep, tree e git log para entender a estrutura do projeto e identificar os arquivos mais relevantes para a tarefa.
Comportamento Padrão
Ao ser invocado, o Spotter:
- Analisa a estrutura do diretório atual
- Filtra arquivos por padrões (extensões, nomes, palavras-chave)
- Verifica o histórico do git para alterações recentes
- Retorna uma lista dos arquivos mais relevantes
Uso
# Ativar o Spotter via prompt
@spotter: encontre todos os arquivos relacionados a autenticação
# Exemplo de saída
Arquivos relevantes encontrados:
- src/auth/login.ts
- src/auth/register.ts
- src/auth/middleware.ts
- tests/auth.test.ts
Plataformas Suportadas
- Claude Code
- Cursor
- Codex
- Qualquer plataforma com suporte a SKILL.md
Instalação
- Adicione o arquivo
SKILL.mdao seu projeto - Configure o gatilho de prompt
- Use
@spotterseguido da sua consulta
Exemplo de SKILL.md
name: spotter
description: Localiza arquivos relevantes antes da leitura
triggers:
- "@spotter"
- "/scope"
actions:
- run: find . -type f -name "*${query}*" | head -20
Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.
Licença
MIT