--- name: criar-protocolo description: Constrói com você, por entrevista, um protocolo (um arquivo SKILL.md) a partir de uma tarefa que você repete no trabalho — sem programar. Pergunta o que entra, o que sai, o passo a passo e as condições de parada, e entrega o arquivo pronto para usar. Use quando quiser ensinar um procedimento seu para a IA executar sempre igual. --- # Criar Protocolo — construa o seu primeiro protocolo, sem programar Esta é a skill que cria outros protocolos. Ela conduz uma **entrevista curta** para transformar um procedimento que você já faz na cabeça (ou no automático) em um `SKILL.md` que a IA passa a executar sempre do mesmo jeito. Um **protocolo** é o seu procedimento escrito em português; a **skill** (`SKILL.md`) é o formato em que esse protocolo é entregue a um agente de IA. Você não vai programar nada. A ideia central: **todo trabalho jurídico já é um procedimento.** Você já sabe ler um processo, montar uma petição, analisar um contrato. Só não escreveu esse caminho para a IA. > Todo protocolo responde a três perguntas (a anatomia de qualquer automação): > **1. O que ENTRA** (os dados que você já tem) → **2. O que SAI** (o resultado que > você quer) → **3. O PROCEDIMENTO** (o passo a passo que liga um ao outro) — mais as > **condições de parada**. A entrevista abaixo descobre essas coisas com você. --- ## Instrução Se o usuário já informou uma ideia de tarefa (ex.: "resumir contratos de locação"), use-a como ponto de partida. Se não informou, comece perguntando pela tarefa. **Conduza como uma conversa, não como um formulário.** Faça uma pergunta de cada vez, em linguagem simples, e use as respostas anteriores para fazer a próxima. Se o usuário não souber responder algo, ofereça exemplos e siga em frente — o protocolo pode ser refinado depois. ### Passo 1 — A tarefa (o gatilho) Pergunte: - "Qual tarefa você **repete** e gostaria que a IA fizesse por você?" - "Me dá um exemplo concreto da última vez que você fez isso." Ouça e devolva em uma frase o que entendeu, para confirmar. Sugira um **nome curto** em kebab-case para o protocolo (ex.: `resumir-contrato`, `minutar-notificacao`, `triar-processo-novo`). ### Passo 2 — O que ENTRA (os dados que você TEM) Pergunte: - "Quando você vai fazer essa tarefa, **o que você tem em mãos**?" (PDFs dos autos, um contrato, um áudio de reunião, um e-mail do cliente, uma planilha…) - "Onde isso costuma estar?" (uma pasta do caso, um arquivo solto, um texto colado) - "Tem algum dado que **precisa estar organizado antes**?" Se for áudio, aponte o protocolo `transcrever`; se for uma pilha de documentos, aponte o protocolo `organizar-caso`. ### Passo 3 — O que SAI (o resultado que você PRECISA) Pergunte: - "No fim, **o que você quer receber**?" (um resumo de 1 página, uma minuta de peça, uma tabela de prazos, uma lista de riscos…) - "Em que **formato**?" (um arquivo `.md`, uma resposta na tela, uma peça salva em `pecas/`…) - "Como é um resultado **bom**? E o que tornaria o resultado **ruim**?" (isso vira as regras de qualidade do protocolo) ### Passo 4 — O PROCEDIMENTO (o passo a passo) Peça para a pessoa narrar como ela faz hoje, e transforme em passos numerados: - "Me conta, **passo a passo**, como você faria isso na mão." - A cada passo, pergunte o "porquê" quando não for óbvio — o motivo vira instrução para a IA não errar. - Identifique pontos onde a IA **não pode inventar** (números, citações de lei, jurisprudência, prazos) e onde ela deve **conferir na fonte** ou **perguntar** em vez de chutar. ### Passo 5 — As condições de parada Pergunte: - "Em que situações a IA deve **parar e te perguntar**, em vez de seguir?" (falta um documento, um prazo não confere, o pedido está ambíguo…) - "Como saber que a tarefa **terminou bem**?" Essas respostas viram as condições de parada do protocolo — o que impede a IA de completar a lacuna com o provável quando falta base. ### Passo 6 — Mostrar o rascunho e confirmar Antes de salvar, **mostre ao usuário** um resumo do que o protocolo vai fazer (entra → sai → passos → condições de parada) e pergunte se está certo. Ajuste conforme o retorno. **Não gere o arquivo antes da confirmação.** ### Passo 7 — Gerar o arquivo do protocolo Crie o arquivo em `.agents/skills//SKILL.md` com esta estrutura: ```markdown --- name: description: <1 frase clara em português dizendo o que o protocolo faz e QUANDO usá-lo — é por aqui que a IA decide acioná-lo sozinha> --- # <1-2 frases explicando o objetivo do protocolo.> ## Instrução Considere como entrada . Se a entrada não estiver presente, peça-a antes de continuar. ### Passo 1 — ### Passo 2 — <...> <...> ## Regras - - - Nunca inventar fatos, números, citações de lei ou jurisprudência: usar só o que está nos documentos ou em fonte verificada. ``` Regras ao gerar: - A `description` é a parte mais importante: escreva-a pensando em "quando a IA deve usar isto?". É ela que faz o protocolo ser acionado na hora certa. - Use **caminhos relativos** (`casos//...`), nunca caminhos absolutos. - Linguagem em português, simples. É um procedimento, não código. - Escreva instruções independentes de fornecedor: use capacidades como "leia o arquivo" em vez de nomes de ferramentas exclusivos de um agente. - Se a tarefa se conecta a outros protocolos do kit, referencie-os pelo nome (ex.: "antes, execute o protocolo `organizar-caso`"; "depois, use o protocolo `revisar-peca`"). Depois de salvar, rode: ```bash bash "${CLAUDE_PLUGIN_ROOT:-.}/ferramentas/manutencao/sincronizar-skills.sh" python3 "${CLAUDE_PLUGIN_ROOT:-.}/ferramentas/manutencao/verificar_compatibilidade.py" ``` ### Passo 8 — Explicar como usar Ao terminar, diga ao usuário: - "Pronto: criei o protocolo ****. No Claude Code, use `/`; no Codex, mencione `$` ou peça a tarefa em linguagem natural." - Se preferir usar sem clonar o repositório, o mesmo `SKILL.md` pode ser instalado como skill autônoma no assistente (por exemplo, em Customize → Skills, no claude.ai). - Sugira testá-lo agora com um exemplo real. - Lembre que ele pode ser ajustado quando quiser — é só abrir o arquivo `.agents/skills//SKILL.md` e editar, ou usar o protocolo `criar-protocolo` de novo para refinar. --- ## Dica de ouro (diga ao usuário se ele travar na ideia) O melhor primeiro protocolo é uma tarefa **chata, repetitiva e bem definida** — não a mais impressionante. Exemplos que funcionam bem: resumir uma pilha de documentos novos, montar a linha do tempo de um caso, gerar a minuta de uma notificação padrão, conferir se uma peça citou todas as provas. Comece pequeno; a IA aprende o seu jeito e você expande depois.