Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Este guia é destinado a administradores e arquitetos empresariais que precisam governar Agent Skills em toda uma organização. Ele cobre como examinar, avaliar, implantar e gerenciar Skills em escala. Para orientações de criação, consulte as melhores práticas. Para detalhes de arquitetura, consulte a visão geral de Skills.
Implantar Skills em uma empresa requer responder a duas perguntas distintas:
Avalie cada Skill em relação a estes indicadores de risco antes de aprovar a implantação:
| Indicador de risco | O que procurar | Nível de preocupação |
|---|---|---|
| Execução de código | Scripts no diretório da Skill (*.py, *.sh, *.js) | Alto: scripts são executados com acesso total ao ambiente |
| Manipulação de instruções | Diretivas para ignorar regras de segurança, ocultar ações dos usuários ou alterar o comportamento de Claude condicionalmente | Alto: pode contornar controles de segurança |
| Referências a servidores MCP | Instruções referenciando ferramentas MCP (ServerName:tool_name) | Alto: estende o acesso além da própria Skill |
| Padrões de acesso à rede | URLs, endpoints de API, chamadas fetch, curl ou requests | Alto: vetor potencial de exfiltração de dados |
| Credenciais codificadas | Chaves de API, tokens ou senhas em arquivos ou scripts da Skill | Alto: segredos expostos no histórico do Git e na janela de contexto |
| Escopo de acesso ao sistema de arquivos | Caminhos fora do diretório da Skill, padrões glob amplos, travessia de caminho (../) | Médio: pode acessar dados não intencionais |
| Invocações de ferramentas | Instruções direcionando Claude a usar bash, operações de arquivo ou outras ferramentas | Médio: revise quais operações são realizadas |
Antes de implantar qualquer Skill de terceiros ou de um colaborador interno, conclua estas etapas:
http, requests.get, urllib, curl, fetch).Skills podem degradar o desempenho do agente se forem acionadas incorretamente, entrarem em conflito com outras Skills ou fornecerem instruções ruins. Exija avaliação antes de qualquer implantação em produção.
Estabeleça portões de aprovação para estas dimensões antes de implantar qualquer Skill:
| Dimensão | O que mede | Exemplo de falha |
|---|---|---|
| Precisão de acionamento | A Skill é ativada para as consultas certas e permanece inativa para as não relacionadas? | A Skill é acionada em toda menção a planilhas, mesmo quando o usuário só quer discutir dados |
| Comportamento em isolamento | A Skill funciona corretamente sozinha? | A Skill referencia arquivos que não existem em seu diretório |
| Coexistência | Adicionar esta Skill degrada outras Skills? | A descrição da nova Skill é ampla demais, roubando acionamentos de Skills existentes |
| Seguimento de instruções | Claude segue as instruções da Skill com precisão? | Claude pula etapas de validação ou usa bibliotecas erradas |
| Qualidade da saída | A Skill produz resultados corretos e úteis? | Relatórios gerados têm erros de formatação ou dados ausentes |
Exija que os autores de Skills enviem suítes de avaliação com 3–5 consultas representativas por Skill, cobrindo casos em que a Skill deve ser acionada, não deve ser acionada e casos extremos ambíguos. Exija testes em todos os modelos que sua organização usa (Haiku, Sonnet, Opus), porque a eficácia da Skill varia conforme o modelo.
Para orientações detalhadas sobre como construir avaliações, consulte avaliação e iteração nas melhores práticas. Para metodologia geral de avaliação, consulte desenvolver casos de teste.
Os resultados das avaliações sinalizam quando agir:
Planejar
Identifique fluxos de trabalho que são repetitivos, propensos a erros ou que exigem conhecimento especializado. Mapeie-os para funções organizacionais e determine quais são candidatos a Skills.
Criar e revisar
Garanta que o autor da Skill siga as melhores práticas. Exija uma revisão de segurança usando a lista de verificação de revisão. Exija uma suíte de avaliação antes da aprovação. Estabeleça separação de responsabilidades: autores de Skills não devem ser seus próprios revisores.
Testar
Exija avaliações em isolamento (Skill sozinha) e junto com Skills existentes (teste de coexistência). Verifique a precisão de acionamento, a qualidade da saída e a ausência de regressões em seu conjunto ativo de Skills antes de aprovar para produção.
Implantar
Faça upload por meio da Skills API para acesso em todo o workspace. Consulte Usando Skills com a API para upload e gerenciamento de versões. Documente a Skill em seu registro interno com propósito, proprietário e versão.
Monitorar
Acompanhe padrões de uso e colete feedback dos usuários. Execute novamente as avaliações periodicamente para detectar desvios ou regressões à medida que fluxos de trabalho e modelos evoluem. Análises de uso não estão disponíveis atualmente por meio da Skills API. Implemente registro em nível de aplicação para rastrear quais Skills são incluídas nas solicitações.
Iterar ou descontinuar
Exija que a suíte completa de avaliação seja aprovada antes de promover novas versões. Atualize Skills quando os fluxos de trabalho mudarem ou as pontuações de avaliação caírem. Descontinue Skills quando as avaliações falharem consistentemente ou o fluxo de trabalho for desativado.
Como diretriz geral, limite o número de Skills carregadas simultaneamente para manter uma precisão de recuperação confiável. Os metadados de cada Skill (nome e descrição) competem por atenção no prompt do sistema. Com muitas Skills ativas, Claude pode falhar em selecionar a Skill certa ou perder completamente as relevantes. Use sua suíte de avaliação para medir a precisão de recuperação à medida que adiciona Skills, e pare de adicionar quando o desempenho degradar.
Observe que as solicitações de API suportam um máximo de 8 Skills por solicitação (consulte Usando Skills com a API). Se uma função exigir mais Skills do que uma única solicitação suporta, considere consolidar Skills restritas em outras mais amplas ou rotear solicitações para diferentes conjuntos de Skills com base no tipo de tarefa.
Incentive as equipes a começar com Skills restritas e específicas de fluxo de trabalho, em vez de amplas e multipropósito. À medida que padrões emergem em sua organização, consolide Skills relacionadas em pacotes baseados em funções.
Exemplo de progressão:
formatting-sales-reports, querying-pipeline-data, updating-crm-recordssales-operations (quando as avaliações confirmarem desempenho equivalente)Use convenções de nomenclatura consistentes em toda a sua organização. A seção de convenções de nomenclatura nas melhores práticas fornece orientações de formatação.
Mantenha um registro interno para cada Skill com:
Agrupe Skills por função organizacional para manter o conjunto ativo de Skills de cada usuário focado:
Cada pacote baseado em função deve conter apenas as Skills relevantes para os fluxos de trabalho diários daquela função.
Armazene diretórios de Skills no Git para rastreamento de histórico, revisão de código por meio de pull requests e capacidade de rollback. Cada diretório de Skill (contendo SKILL.md e quaisquer arquivos incluídos) mapeia naturalmente para uma pasta rastreada pelo Git.
A Skills API fornece distribuição com escopo de workspace. Skills enviadas por meio da API ficam disponíveis para todos os membros do workspace. Consulte Usando Skills com a API para endpoints de upload, versionamento e gerenciamento.
Mantenha os arquivos-fonte das Skills no Git como a única fonte de verdade. Se sua organização implanta Skills em várias superfícies, implemente seu próprio processo de sincronização para mantê-las consistentes. Para detalhes completos, consulte disponibilidade entre superfícies.
Detalhes de arquitetura e plataforma
Orientações de criação para criadores de Skills
Faça upload e gerencie Skills programaticamente
Was this page helpful?