--- titulo: Construção e evolução de Skills versao: "1.1.0" aplica: "Modelo de Gestão de Agentes de IA 1.2.0-rc.1; M09 e M11" consumo: integral ao conceber ou reformar uma Skill; focal ao rever um componente --- # Construção e evolução de Skills Uma Skill torna uma transformação reutilizável sob demanda. Seu desenho resolve três problemas diferentes: reconhecer quando entra, carregar conhecimento suficiente e realizar a transformação com os meios disponíveis. Ela não recebe automaticamente a identidade ou a autoridade do agente que a utiliza. ## Julgar a pertinência da forma Parta da ocorrência, da entrada variável e da saída utilizável. A recorrência pode acontecer por necessidade, evento ou tempo, sem frequência fixa. Se uma instrução pequena já resolve uma tarefa pontual, ela pode ser suficiente. Se existe responsabilidade entre execuções, a Skill pode contribuir, mas essa responsabilidade pertence ao agente e à organização do trabalho. Procure recursos existentes pelo que transformam, além do nome. Compare a fronteira com Skills vizinhas: duas podem consultar os mesmos materiais e produzir resultados diferentes. Construção desenvolve ou altera; avaliação confronta e diagnostica; organização/instalação torna ambiente e componentes utilizáveis. Uma falha sem reforma decidida não deve acionar silenciosamente uma reconstrução integral. ## Escrever a inteligência da transformação Defina o que entra, quais distinções e critérios governam, que operações transformam o insumo, que saída permite continuar e onde termina. Desenvolva razões, exceções e tratamento de lacunas. Se a fonte de negócio não estiver disponível, a Skill deve saber qual parte pode produzir e qual condição continua dependente. O pacote leva uma aplicação suficiente do método. Um ponteiro privado, um título de capítulo ou a instrução de “usar nosso padrão” não basta para um consumidor que não recebe esse contexto. Dados atuais e procedimentos mantidos pelo usuário podem continuar externos, desde que exista acesso explícito e comportamento suficiente para sua ausência. Separe método estável, dado variável e detalhe técnico. Um parâmetro próprio de um cliente não vira critério universal. Um POP pode orientar uma situação de processo com entradas, sequência e responsáveis; a Skill pode mobilizá-lo quando houver transformação reconhecível. Não é necessário converter todo procedimento em Skill. ## Distribuir conteúdo e execução O nome e a descrição precisam permitir reconhecimento antes da leitura do corpo. Diga o que faz e quando usar, com fronteira material quando houver vizinhas semelhantes. O corpo conserva propósito, seleção de modos, operação comum e condições críticas; referências desenvolvem contribuições condicionais, ligadas diretamente ao ponto de uso. Escolha scripts quando uma operação determinística precisa de repetição confiável, como validar formato ou reconciliar inventário. Um script não substitui julgamento de verdade, autoridade ou utilidade. Explique se o recurso deve ser executado ou lido. Não introduza programa para conferir o que uma leitura simples já resolve suficientemente. Modelos de saída entram quando a forma altera utilização ou conferência. A pessoa não precisa preencher toda a arquitetura da Skill para iniciar. Campos sem sustentação permanecem desconhecidos; um formulário completo não demonstra trabalho concluído. Formato e descoberta técnica pertencem ao saber de implementação. O método não depende de uma marca, caminho global ou segredo. Um pacote distribuído pode ser consultado por leitura explícita; a seleção nativa depende do mecanismo e da exposição correspondentes. ## Conferir reconhecimento e qualidade Use pedidos realistas que deveriam e que não deveriam mobilizar a Skill. Uma descrição ampla demais pode tomar o trabalho de uma vizinha; uma estreita demais pode esconder contribuição pertinente. Nome listado, seleção observada, corpo lido e método aplicado são provas distintas. Confronte a saída com o trabalho. O recurso desenvolveu conhecimento ou apenas produziu cabeçalhos? Preservou decisões e insumos? Tratou uma exceção sem inventar política? Ajudou a próxima etapa a agir? Escolha casos que possam revelar o erro material; não reproduza somente o exemplo que já expõe a resposta. Quando apropriado, use consumidor separado com pedido, candidata e insumos normais. Registre condições conhecidas e resultado sem alegar isolamento absoluto. Corrija reconhecimento, conteúdo, apoio, acesso ou execução conforme a causa. Mudança de descrição pede conferência de seleção; mudança de critério pede confronto do resultado afetado. ## Manter fonte e distribuição coerentes O original editável, a pasta instalada e o ZIP têm relações identificáveis. Atualize a fonte, confira a transformação, gere os derivados e compare seu conteúdo. Pacote antigo preservado não concorre silenciosamente com o vigente. Se houver alterações locais, compare origem anterior, origem nova e uso atual antes de substituir. Quando a fonte de método mudar, julgue impacto na Skill: nenhum, ajuste necessário agora ou melhoria na ocasião pertinente. Uma aplicação tem edição própria; ela não recebe automaticamente todo o histórico da origem. A instalação de cada pessoa e ambiente também tem condição própria. ## Aplicação no Couto-IAS O conjunto oferece três operações de gestão — construir-agentes-de-ia, avaliar-agentes-de-ia e instalar-gestao-de-agentes — e dois recursos de entrega: produzir-documentos-markdown-para-ia e desenhar-agentes-e-sistemas. O primeiro prepara fontes Markdown preservando conhecimento e condições; o segundo produz o Design do Agente e outras representações com modelo e leitura textual. Mobilize cada recurso pela contribuição, sem executar os cinco a cada pedido. O Couto-IAS escolhe pela contribuição que falta e mantém a demanda integrada. Uma passagem leva objeto, decisões, material, último resultado, limite e próximo trabalho. Sem exposição nativa, o mesmo método pode ser aplicado pelos arquivos completos, com essa realização identificada. Exemplo ilustrativo: a avaliação encontra bom núcleo, mas uma fonte especializada sem critério para comparar versões. A construção recebe essa lacuna e desenvolve a contribuição correspondente; não precisa criar um agente novo. A instalação entra se o conteúdo corrigido tiver de chegar a outro ambiente. O trabalho só se encerra quando a correção pertinente tiver destino e conferência, além da invocação das três Skills.