operacoes

Transformar tarefa recorrente em workflow de IA

Converte uma tarefa textual recorrente em um workflow verificável, com contratos, decisões, exceções e testes.

Quando usar e quando não usar

Quando usar

Use para descrever uma tarefa textual que se repete e cujo início, término e resultado podem ser observados. Bons casos incluem transformar um briefing confirmado em um rascunho padronizado, classificar solicitações recebidas ou preparar um relatório a partir de materiais autorizados. A entrega é um workflow legível e testável, não uma automação implantada.

O trabalho é adequado quando existem dois ou três casos recentes anonimizados, porque eles revelam decisões e exceções que uma descrição abstrata costuma esconder. O workflow deve tornar explícito o que entra, o que uma pessoa decide, o que dependeria de sistema externo e como reconhecer uma saída aceitável.

Quando não usar

Não use para operar contas, enviar mensagens, publicar conteúdo, movimentar dinheiro ou conceder acesso. Não converta uma intenção vaga, como “melhorar o atendimento”, em passos fictícios. Primeiro delimite uma tarefa e um resultado. Se o processo envolver decisão legal, médica, financeira, trabalhista ou de segurança, preserve a autoridade humana e peça os controles aplicáveis.

Não registre senhas, chaves, dados pessoais desnecessários nem exemplos identificáveis. Não suponha integração disponível. Uma ação externa pode ser descrita como dependência, com responsável e confirmação, mas não como algo que esta Skill já executou.

Resultado e entradas

Resultado

  • Workflow textual com contratos de entrada e saída, decisões, exceções, critérios de aceite e dois cenários de teste

Entradas necessárias

  • Dois ou três casos recentes anonimizados
  • Gatilho de início e condição de término
  • Materiais, passos, exceções e formato de saída conhecidos

Formato de saída

Siga o modelo de saída. Entregue objetivo e escopo, gatilho e término, contrato de entrada, fluxo numerado, matriz de decisões e exceções, contrato de saída, critérios de aceite, cenário comum, cenário de exceção, lacunas e próximo teste manual.

Cada passo deve indicar entrada consumida, transformação textual, decisão necessária, saída intermediária e próximo estado. Aponte claramente ações externas que não serão executadas. Consulte o exemplo como demonstração fictícia do nível de detalhe, sem transportar seus nomes ou regras para outro negócio.

Como funciona

Procedimento

  1. Delimite uma tarefa e um resultado. Escreva uma frase com gatilho, trabalho textual e estado final observável. Retire objetivos amplos que exigiriam vários workflows. Confirme o que fica fora do escopo e não confunda resultado produzido com impacto de negócio futuro.
  2. Reconstrua casos recentes. Percorra dois ou três casos anonimizados do início ao fim. Registre entradas realmente usadas, ordem dos passos, perguntas feitas, retrabalho e motivo de variação. Quando os relatos divergirem, preserve a divergência e indique quem tem autoridade para resolvê-la.
  3. Separe texto, decisão humana e ação externa. Marque o que o agente pode redigir ou analisar, o que exige julgamento ou aprovação humana e o que dependeria de outro sistema. Nunca esconda envio, publicação, alteração de cadastro ou consulta privada dentro de um verbo genérico como “processar”.
  4. Defina o contrato de entrada. Para cada campo, informe nome, finalidade, origem, formato aceito, obrigatoriedade, limite e tratamento de ausência. Rejeite credenciais e dados sem necessidade. Se uma entrada obrigatória faltar, o workflow deve perguntar ou parar, não fabricar um valor plausível.
  5. Modele decisões, exceções e recuperação. Escreva condições observáveis no formato “se/então”. Para cada exceção, indique estado seguro, pergunta necessária, responsável conhecido e como retomar. Uma falha externa não autoriza repetir indefinidamente, contornar aprovação ou declarar sucesso.
  6. Defina saída e aceite. Especifique campos, ordem, rótulos e critérios que uma pessoa pode conferir. Separe completude, sustentação e formato. Evite critérios subjetivos como “ficar excelente”; traduza-os em presença de fontes, limites, decisões e pendências.
  7. Crie cenários comum e de exceção. O cenário comum percorre uma entrada válida até a saída aceita. O cenário de exceção deve ativar uma falta, conflito ou dependência indisponível e provar que o workflow para, pergunta ou bloqueia corretamente. Use dados fictícios e não alegue execução em agente.
  8. Exponha somente responsáveis e lacunas conhecidos. Nomeie responsáveis apenas quando informados. Termine com decisões abertas, integrações não verificadas, riscos e o próximo teste manual. Não converta uma lacuna em dono inventado nem uma hipótese em regra operacional.

Regra de parada

Pare sem concluir o workflow quando não houver um caso concreto, um gatilho de início, uma condição de término ou um resultado observável. Faça perguntas específicas sobre o elemento ausente. Se os casos se contradisserem e não houver autoridade informada, registre o conflito e não escolha uma versão.

Pare também diante de credenciais, dados privados desnecessários ou solicitação de executar sistemas externos. Você pode descrever a interface e o ponto de confirmação, mas não alegar conexão, envio ou teste. A entrega termina quando o workflow textual, os dois cenários e as lacunas estão explícitos. Para instalar a pasta e fazer um ensaio manual não sensível, consulte instalação.

Exemplo limitado

Entrada

Dois casos anonimizados mostram uma equipe recebendo um pedido textual por canal autorizado, comparando-o com uma política vigente e preparando um resumo para revisão humana. O início é a chegada do texto e da identificação interna não pessoal. O término é um resumo revisável com pendências. Uma exceção observada é a ausência da versão da política.

Saída

Objetivo: preparar um resumo sustentado; não responder nem alterar sistemas. Contrato de entrada: texto do pedido, finalidade, versão da política e formato do resumo. Se a versão faltar, perguntar e manter estado bloqueado.

Fluxo comum: validar campos, separar pedidos e contexto, relacionar cada conclusão a um trecho da política, listar pendências e entregar o resumo para aprovação. Critérios de aceite: todos os pedidos aparecem; conclusões apontam a fonte; nenhuma resposta foi enviada.

Cenário de exceção: a política chega sem versão. Resultado esperado: o workflow não escolhe uma versão, registra a lacuna e pede ao responsável informado a referência vigente. A retomada começa na validação da fonte. Dono da decisão: não informado no exemplo; permanece como lacuna.

Arquivos do pacote

  • references/
    • entrada.md
    • exemplo.md
    • instalacao.md
    • modelo-de-saida.md
  • SKILL.md

Skill e prompt

Um prompt pede uma resposta pontual. Esta Skill preserva procedimento, critérios, regra de parada, exemplos e modelos entre usos.

Compatibilidade

  • Claude Code: ainda não verificado
  • Codex: ainda não verificado
  • Antigravity: ainda não verificado

Validação

Estrutura verificada

Estrutura verificada confere arquivos, caminhos e checksums. Não comprova o comportamento em um agente.

Autoria, fonte e licença

Criada pelo PromptMestre

URL canônica

Licença: CC-BY-4.0