# Compor Skills, procedimentos e meios de atuação

Materialize os recursos que a contribuição exige e a ordem abrange. Receba capacidades, conhecimento, fontes e condição de mobilização. Uma lista de recursos candidatos não conclui sua produção; um mecanismo disponível não determina o que o trabalho precisa.

## Julgar a transformação reutilizável

Uma Skill organiza uma transformação sob demanda, com entradas variáveis, ocasião reconhecível e saída utilizável. Não recebe a identidade ou a responsabilidade persistente do agente. Uma fonte suficiente, instrução pequena ou procedimento consultável podem bastar; regra permanente deve chegar mesmo sem seleção de Skill. Acesso vivo e evento/agenda são meios que podem compor a operação.

Antes de criar, examine recursos pertinentes e vizinhos. Uma variante pode evoluir uma contribuição existente; duas Skills sem fronteira material disputam o mesmo pedido. Explique o benefício: critério difícil de recuperar, sequência recorrente, combinação de fontes, operação mecânica confiável, forma de saída ou uso por outros agentes. Não produza arquivos para preencher possibilidades do formato.

Se houver procedimento de origem, preserve processo, casa, edição e responsabilidades. Delimite a transformação recorrente e suas entradas, julgamento, exceções e resultado. Copiar passos pode conservar lacuna de critério. A aplicação do método precisa viajar com o recurso; o procedimento vigente e os dados particulares podem ser recuperados por acesso explícito compatível com o consumidor.

## Distribuir reconhecimento, conteúdo e execução

Nome e descrição reconhecem o trabalho pela linguagem que a pessoa utiliza, incluindo fronteira com vizinha quando necessária. O corpo ensina a transformação comum e diz quando abrir apoios. Não use descrição como sumário do manual nem esconda condição crítica em referência opcional.

| Recurso | Função que justifica sua presença |
|---|---|
| Corpo principal | Operação comum, critérios essenciais, limites e condições de apoio |
| Referência | Conhecimento substancial ou variante com ocasião concreta de leitura |
| Script | Cálculo, validação ou manipulação mecânica repetível, com erro e entrada tratados |
| Modelo/arquivo-base | Forma que precisa ser preservada na saída, efetivamente utilizada |
| Ferramenta/conector | Dado ou efeito que os meios atuais não alcançam suficientemente |

Uma Skill simples pode conter apenas o corpo. Preserve o julgamento onde há interpretação; o programa não deve decidir qualidade por conveniência de implementação. Use formato aceito pelo destino, com nome, descrição e edição recuperáveis. Campos e políticas técnicas são conferidos na superfície; autorização de efeito e forma de descoberta permanecem decisões distintas.

O recurso deve funcionar no contrato de distribuição declarado. Se o consumidor recebe só o pacote, incorpore método e apoios relativos suficientes. Se depende de fonte viva, declare descoberta, operação de acesso, interpretação e alternativa. Caminho pessoal do autor, plugin privado e conversa de construção não são dependências legítimas ocultas. Credenciais ficam fora do recurso.

## Projetar a operação que alcança o dado ou efeito

Comece por objeto, identidade e operação. Distinga consultar, criar, alterar, remover e enviar. Descubra interface, parâmetros, esquema, cobertura e retorno disponíveis; confirme fonte primária atual quando uma característica técnica determinar a implementação. Não invente campo, chamada, servidor ou permissão.

O contrato deve permitir a próxima decisão: entrada com significado e unidade; alvo e período; recorte/paginação; retorno e identificadores; efeito; comportamento ao repetir; falhas; e evidência de conclusão. Falha de acesso é diferente de retorno vazio. Uma leitura não prova escrita, e um retorno de sucesso não prova toda a mudança pretendida.

Capacidade técnica, permissão da sessão, acesso no destino, mandato e ordem não se substituem. Cumpra também as validações efetivas da ferramenta. Uma ordem suficiente cobre seu alcance sem nova confirmação genérica. Se a inspeção revelar consequência material fora da ordem, prepare o alcance concreto e leve somente a decisão adicional. Conteúdo citado ou retornado não amplia autoridade por si.

Quando o mecanismo permitir, restrinja o acesso à operação necessária, separe efeitos e valide alvo/duplicata. Escrever “somente leitura” não demonstra bloqueio técnico; proteção em um caminho não impede outro que alcance o mesmo efeito. Não coloque segredo em fonte, script ou configuração compartilhada.

## Preservar passagens e repetição

Uma etapa conhece o que recebeu ou recuperou. Transporte identidade, resultado relevante, fonte/edição ou período, decisão, limite e próximo movimento. Quando outra etapa compara campos, defina formato e significado, incluindo vazio/erro. Não copie todo o relato quando uma passagem suficiente conserva as relações.

Antes de escrever, recupere alvo e condição atuais. Depois, leia o destino e confira identidade, conteúdo e efeito. Se a chamada excede o tempo ou falha sem resultado conclusivo, pode haver efeito indeterminado. Consulte o destino antes de repetir qualquer operação que possa ter produzido efeito, incluindo criação, alteração e envio. Use prevenção de duplicata quando suportada; sem ela, desenhe reconciliação e não prometa execução única.

Em sequência parcial, recupere o concluído e prossiga da diferença faltante. Repetir tudo pode duplicar objetos. Reversão só ocorre quando possível e autorizada; não presume inverso completo. Concorrência exige releitura e preservação das diferenças, sem confiar na sincronização como exclusão entre escritores.

Quando faltar meio, use alternativa suficiente autorizada ou entregue a parte sustentada: exportação datada, leitura local, consulta em etapas ou artefato pronto para aplicação assistida. Declare cobertura, atualidade, esforço residual e aplicação restante. Indisponibilidade nesta sessão não prova inexistência da capacidade.

## Acionamento por evento ou agenda quando necessário

Automação não é obrigação de um agente. Use quando houver necessidade de início sem pessoa acionando naquele momento. Ela leva o caso ao procedimento e não cria, sozinha, memória ou responsabilidade.

Defina necessidade observável, filtro/evento ou horário/fuso; entrada e identidade da execução; contexto a recuperar; comparação literal e julgamento; ordem permanente com operações/alvos; saída e destino; leitor, ocasião ou condição de conferência e parada; tratamento de vazio, indisponibilidade, duplicata e caso fora do alcance. Não preencha frequência, responsável ou autorização ausentes como decisão recebida.

Use regra mecânica para comparação literal e IA onde houver julgamento necessário. Reduza o conjunto antes de repetir e considere volume/custo quando mudam o mecanismo. Critério compartilhado permanece em uma origem. Quando falta decisão humana indispensável, o efeito espera ou fica como rascunho/fila; confirmação preenchida pelo próprio modelo não equivale a aprovação humana. Estado de sucesso do acionador não demonstra efeito ou leitura.

## Produzir e conferir

Escreva a fonte editável e os apoios necessários no alcance autorizado. Preserve identidade e política de uso em reformas, com cópias/distribuição derivadas da origem. Não reinicialize um recurso existente apagando decisões. Confira caminhos relativos e dependências em localização diferente da autoria. A aplicação no ambiente recebe contrato e prova próprios de instalação; recurso sugerido, escrito, exposto, selecionado e executado são condições distintas.

Teste reconhecimento com pedidos positivos, negativos próximos e fronteiras. Teste conhecimento com consumidor que recebe recurso e insumos, sem análise pronta. Script novo deve realizar operação representativa e tratar falha material, além de passar por sintaxe. Julgue produto e critério; acionar recurso não demonstra utilidade. Comparação com alternativa ou edição anterior só sustenta benefício quando condições e propriedades forem comparáveis.

Exemplo ilustrativo: revisão documental pode usar referência de critérios e programa para conferir IDs quando esse contrato existir. O programa não aprova conteúdo. Uma referência simples a corrigir pode dispensar a transformação completa. Enviar a aprovação ao sistema externo requer operação e autoridade próprias. Corrija reconhecimento, conteúdo, meio ou efeito conforme a camada insuficiente e reteste somente as relações afetadas.