Geofeed Tuner – Crie Melhores Feeds de Geolocalização de IP

Esta habilidade ajuda você a criar e melhorar feeds de geolocalização de IP em formato CSV, através de:

• Garantir que seu CSV esteja bem formado e consistente
• Verificar a conformidade com a RFC 8805 (o padrão da indústria)
• Aplicar melhores práticas opinativas aprendidas em implantações do mundo real
• Sugerir melhorias para precisão, completude e privacidade

Quando Usar Esta Habilidade

• Use esta habilidade quando um usuário pedir ajuda para criar, melhorar ou publicar um arquivo de feed de geolocalização de IP em formato CSV.
• Use-a para ajustar e solucionar problemas de feeds de geolocalização CSV — identificando erros, sugerindo melhorias e garantindo usabilidade no mundo real além da conformidade com a RFC.
• Público-alvo:
  • Operadores de rede, administradores e engenheiros responsáveis por espaço de endereço IP roteável publicamente
  • Organizações como ISPs, operadoras de telefonia móvel, provedores de nuvem, empresas de hospedagem e colocation, operadoras de Internet Exchange e provedores de internet via satélite
• Não use esta habilidade para gerenciamento de endereços IP privados ou internos; ela se aplica apenas a endereços IP roteáveis publicamente.

Pré-requisitos

• Python 3 é necessário.

Estrutura de Diretórios e Gerenciamento de Arquivos

Esta habilidade usa uma separação clara entre arquivos de distribuição (somente leitura) e arquivos de trabalho (gerados em tempo de execução).

Diretórios Somente Leitura (Não Modifique)

Os seguintes diretórios contêm ativos de distribuição estáticos. Não crie, modifique ou exclua arquivos nestes diretórios:

Diretórios de Trabalho (Conteúdo Gerado)

Todos os arquivos gerados, temporários e de saída vão para estes diretórios:

Regras de Gerenciamento de Arquivos

1. Nunca escreva em assets/, references/ ou scripts/ — estes fazem parte da distribuição da habilidade e devem permanecer inalterados.
2. Todos os arquivos de entrada baixados (de URLs remotas) devem ser salvos em ./run/data/.
3. Todos os relatórios HTML gerados devem ser salvos em ./run/report/.
4. Todos os scripts Python gerados devem ser salvos em ./run/.
5. O diretório run/ pode ser limpo entre as sessões; não armazene dados permanentes lá.
6. Diretório de trabalho para execução: Todos os scripts gerados em ./run/ devem ser executados com o diretório raiz da habilidade (o diretório que contém SKILL.md) como o diretório de trabalho atual, para que caminhos relativos como assets/iso3166-1.json e ./run/data/report-data.json sejam resolvidos corretamente. Não entre em cd em ./run/ antes de executar os scripts.

Pipeline de Processamento: Execução Sequencial de Fases

Todas as fases devem ser executadas em ordem, da Fase 1 à Fase 6. Cada fase depende da conclusão bem-sucedida da fase anterior. Por exemplo, as verificações de estrutura devem ser concluídas antes que a análise de qualidade possa ser executada.

As fases são resumidas abaixo. O agente deve seguir as etapas detalhadas descritas mais adiante em cada seção de fase.

…