Auditoria de Segurança de Habilidades

Visão Geral

Revise uma Habilidade de Agente de terceiros, servidor MCP, conector ou extensão de desktop antes da instalação. O fluxo de trabalho padrão é somente leitura: não instale dependências, execute código do projeto, faça login, forneça credenciais ou conecte o projeto a uma conta real durante a revisão estática.

Quando Usar Esta Habilidade

• Use antes de instalar uma Habilidade, servidor MCP, conector, plugin ou extensão de desktop desconhecida.
• Use quando um projeto lida com arquivos, credenciais, sessões de navegador, contas externas, requisições de rede ou ações destrutivas.
• Use quando uma release, binário, dependência ou instalador remoto não puder ser verificado independentemente.

Como Funciona

1. Registre o repositório exato, revisão ou release, licença, status do arquivo compactado, última atualização significativa e arquivos revisados. Declare qualquer limitação de escopo.
2. Leia o SKILL.md completo ou instruções equivalentes e todos os arquivos que ele invoca diretamente. Siga referências a scripts, hooks, manifestos, etapas de instalação de pacotes, binários, URLs remotos, variáveis de ambiente e ativos empacotados.
3. Inventarie as capacidades: acesso ao sistema de arquivos, execução de comandos, acesso à rede, controle de navegador, ações de conta, publicação, mensagens, exclusão, pagamento, acesso a credenciais, persistência e comportamento de autoatualização.
4. Rastreie dados sensíveis de sua origem para armazenamentos locais, subprocessos, logs, modelos, APIs, servidores MCP, serviços de análise e outros destinos de rede. Documentação ausente é uma questão não resolvida, não prova de que os dados permanecem locais.
5. Inspecione manifestos de dependência, lockfiles, scripts de instalação e proveniência da release. Observe execução remota sem fixação de versão (unpinned), dependências amplas, binários opacos e incompatibilidades entre os artefatos de origem e distribuídos.
6. Separe as descobertas confirmadas dos riscos contextuais e perguntas sem resposta. Cite caminhos de arquivo, números de linha, campos de configuração, comandos ou documentação primária para cada alegação material.
7. Proponha um teste de permissão mínima usando dados ou contas descartáveis; não o execute sem aprovação explícita do usuário.

Saída

Comece com a identidade auditada e um veredito:

• Risco observado menor: nenhuma preocupação material foi encontrada no escopo revisado; isso não é uma garantia.
• Revisão necessária: comportamento, proveniência, permissões ou fluxo de dados importantes permanecem incertos.
• Risco observado alto: comportamento confirmado pode expor dados sensíveis, enfraquecer a segurança da conta ou do dispositivo, causar ação irreversível ou contornar o controle informado.

Em seguida, forneça:

1. Escopo e limitações.
2. Uma tabela de capacidades e permissões.
3. Uma tabela de fluxo de dados.
4. Descobertas ordenadas por gravidade, com evidências, impacto e mitigação.
5. Perguntas sem resposta.
6. Um plano de teste de permissão mínima.

Exemplos

Exemplo 1: Uma Habilidade local, somente leitura

Entrada: um repositório contendo apenas SKILL.md e referências Markdown, sem scripts, dependências, credenciais ou instruções de rede.

Relatório: registre a revisão e os arquivos revisados, marque as capacidades de comando/rede/credenciais como não observadas no escopo, observe qualquer licença ou evidência de proveniência ausente e recomende um teste com dados descartáveis apenas se as perguntas restantes forem resolvidas.

Exemplo 2: Um servidor MCP com um token

Entrada: um servidor cuja configuração lê API_TOKEN e cujas ferramentas podem criar ou excluir registros.

Relatório: rastreie o token e os destinos das requisições, classifique a capacidade de escrita/exclusão separadamente do acesso de leitura, exija uma conta de teste de privilégio mínimo e confirmação no momento da ação, e não execute o servidor com credenciais de produção durante a revisão.

Melhores Práticas

• ✅ Prefira a implementação e a documentação primária atual em vez de selos, capturas de tela, descrições ou popularidade.
• ✅ Fixe revisões e inspecione manifestos, lockfiles, checksums e proveniência da release.
• ✅ Use dados descartáveis, privilégio mínimo, vinculação a localhost, execuções de teste (dry runs), backups, portões de confirmação e rollback onde aplicável.
• ✅ Marque o comportamento desconhecido explicitamente e preserve a revisão exata revisada.
• ❌ Não chame um projeto de seguro, malicioso, oficial ou em conformidade sem evidências para essa afirmação.
• ❌ Não execute comandos de instalação, scripts remotos, binários, ações de conta ou fluxos de credenciais durante a revisão estática.

Notas de Segurança e Proteção

…