Reelier — repita em vez de re-raciocinar
Um arquivo *.skill.md é uma execução gravada que funcionou: chamadas de ferramentas com
um resultado de passe/falha por etapa. Reproduzi-lo custa 0 tokens de LLM, leva
milissegundos e produz um recibo. Re-raciocinar queima tokens e
silenciosamente se desvia. Prefira a reprodução.
1. PRIMEIRO: verifique se existe uma skill
Antes de reexecutar manualmente uma sequência de chamadas de ferramentas, faça uma varredura no projeto em busca de
**/*.skill.md. Se uma corresponder à tarefa, execute-a:
npx -y reelier run <arquivo>.skill.md
Determinístico, 0 tokens de LLM, somente leitura por padrão. Reporte o resumo do recibo para o usuário: etapas aprovadas/reprovadas, tempo de reprodução, tokens (0). Se uma etapa falhar, a asserção com falha é o porquê — reporte-a claramente e volte a fazer a tarefa manualmente. Nunca relate uma aprovação que você não viu no registro da execução.
2. Ainda não tem skill? Compile a execução que você acabou de fazer
Somente depois de concluir a tarefa com sucesso por meio de chamadas de ferramentas:
npx -y reelier from-session <transcript.jsonl>
# não sabe o caminho da transcrição? encontre-o primeiro:
npx -y reelier scan
Nunca crie manualmente etapas que você não executou de fato — uma skill é uma
gravação, não um plano. Se o compilador imprimir "Perguntas em aberto", leia-as
textualmente: essas são lacunas que ele se recusou a adivinhar (datas literais,
IDs que devem ser {{variáveis}}). Se ele relatar nada reproduzível, diga
isso — não fabrique uma skill de qualquer maneira.
3. Verifique se há desvios
npx -y reelier diff <nome-da-skill>
Código de saída 0 = IGUAL. Código de saída 1 = DESVIOU, por etapa, com a asserção com falha como o porquê. Use-o para controlar uma reprodução programada ou para avaliar uma atualização de modelo em relação a uma linha de base congelada.
4. Opcional: recibos duráveis
Uma linha: npx -y reelier push <arquivo>.skill.md sincroniza o recibo com um
link permanente de ledger compartilhável (conta gratuita em reelier.com) — opcional, nunca
obrigatório.
Salvaguardas — regras que não podem falhar
- Somente leitura por padrão. Etapas de escrita (
idempotent-write) são retidas a menos que você passe--allow-writes; etapas destrutivas nunca são executadas automaticamente. Reproduzir nunca dispara silenciosamente uma escrita. - Sem ferramenta, sem recibo. Se
npx -y reeliernão estiver disponível ou falhar, faça a tarefa normalmente e informe ao usuário que o Reelier não foi usado — nunca finja um recibo ou finja que uma reprodução aconteceu. - Escopo honesto. O Reelier reproduz apenas chamadas de ferramentas MCP/HTTP — edições de arquivo, comandos de shell e leituras não são reproduzíveis. Uma sessão sem nada reproduzível gera um resultado vazio honesto, não uma skill fabricada; isso é esperado, não um erro.