Aumente autonomia conforme a evidência
O que é
O método da bicicleta representa uma supervisão que muda ao longo do aprendizado. Nas primeiras execuções, acompanhe tudo. Depois de observar estabilidade, revise amostras e mantenha controles sobre ações de maior impacto.
Por que aprender
Confiar mais não significa retirar toda proteção. Uma skill que produz um rascunho pode operar com pouca supervisão; publicar, enviar ou alterar registros envolve consequências diferentes. O nível de autonomia depende do risco e das evidências.
Conceitos-chave
Fase 1: acompanhar três casos diferentes.
Fase 2: revisar cada entrega final.
Fase 3: amostrar saídas de baixo impacto.
Sempre: revisar bloqueios e mudanças de comportamento.
✓ Faça assim
Reaumente a supervisão quando a entrada ou o ambiente mudar.
✗ Evite este erro
Tratar algumas execuções boas como autorização ilimitada.
Pratique antes de revelar
Uma skill estável começa a usar uma nova ferramenta de publicação. O que muda?
Ver resposta comentada
A capacidade e o risco mudaram. Reavalie permissões, casos de teste e supervisão. A estabilidade do rascunho não prova a segurança da publicação.
Dê feedback que identifica a menor correção
O que é
Um feedback eficaz nomeia o resultado observado, o esperado, o impacto e a alteração proposta. Inclua também o que funcionou e deve ser preservado. Isso reduz o risco de uma reescrita desnecessária quebrar partes boas.
Por que aprender
“Ficou ruim” empurra o agente para adivinhar. “O total está correto, mas falta o período no cabeçalho” localiza o defeito. A correção é adicionar e testar o período, não trocar todo o pipeline de cálculo.
Conceitos-chave
Funcionou: totais por canal estão corretos.
Falhou: o período não aparece antes do resumo.
Impacto: leitor não sabe a qual semana se refere.
Ajuste: exigir período no cabeçalho e verificar as duas datas.
Do conceito à ação
- Observado: identificar a condição inicial.
- Esperado: aplicar a decisão descrita.
- Correção mínima: conferir o efeito no exemplo.
- Teste: registrar a evidência de saída.
✓ Faça assim
Cite arquivo, seção ou exemplo concreto.
✗ Evite este erro
Pedir “refaça tudo melhor” quando há um defeito localizado.
Pratique antes de revelar
Transforme “o texto não soa como eu” em feedback utilizável.
Ver resposta comentada
“Você usou frases longas e três superlativos que não aparecem nos meus exemplos. Preserve os fatos, encurte essas frases e use os dois textos aprovados como referência de tom.”
Transforme a falha em teste de regressão
O que é
Depois de corrigir, guarde um caso que teria detectado a falha antes. Esse teste entra na próxima avaliação. Também rode os casos anteriores para garantir que a proteção nova não inviabilizou entradas válidas.
Por que aprender
A correção de uma execução é local; o teste preserva o aprendizado. Se uma regra de privacidade passou a ocultar todos os números, por exemplo, a regressão deve revelar que ela também removeu dados essenciais que eram públicos.
Conceitos-chave
Falha: relatório sem período.
Caso: CSV com datas diferentes.
Teste: cabeçalho contém menor e maior data.
Regressão: total e canais continuam corretos.
✓ Faça assim
Veja o teste falhar antes de confiar que ele protege o caso.
✗ Evite este erro
Acumular regras que nunca são exercitadas.
Pratique antes de revelar
A entrada vazia agora dá erro claro, mas a válida parou de funcionar. A correção terminou?
Ver resposta comentada
Não. Você corrigiu um caso e introduziu uma regressão. Ajuste a condição e repita ambos os testes.
Versione a receita e preserve a reversão
O que é
Guarde mudanças da skill em controle de versão ou em cópias identificadas, com um histórico curto do motivo. Registre a versão usada em cada experimento para distinguir melhora de instrução de mudança de ambiente.
Por que aprender
Um histórico útil permite voltar à versão anterior quando uma correção piora o resultado. Não basta salvar “final”, “final2” e “agora-vai”. Identifique o que mudou e a evidência que justificou a decisão.
Conceitos-chave
Versão do projeto: 1.0.0
Patch de correção: 1.0.1
Nova funcionalidade: 1.1.1
Convenção deste projeto: minor preserva o patch.
Registrar sempre motivo e testes no histórico.
✓ Faça assim
Use a convenção de versão documentada pelo projeto.
✗ Evite este erro
Confundir uma convenção local com a regra universal de semver.
Pratique antes de revelar
Qual informação deve acompanhar “ajustei a descrição”?
Ver resposta comentada
O gatilho que falhava, o texto alterado e os pedidos positivos e negativos reavaliados. Assim alguém consegue entender por que a mudança existe.
Conclua o projeto: relatório semanal
O que é
Reúna a skill, o CSV sintético, o gerador, casos negativos e a evidência de execução. O kit fornece um ponto de partida funcional; sua tarefa é executar, explicar o resultado e adaptar uma regra pequena com um teste correspondente.
Por que aprender
O projeto final comprova o ciclo completo: contrato, implementação, verificação e melhoria. Ler o SKILL.md é apenas uma parte. Você precisa abrir os artefatos, conferir a conta e observar como a skill reage a uma entrada inválida.
Conceitos-chave
python3 scripts/gerar_relatorio.py dados/vendas.csv \
--outdir saidas/rodada-01
python3 scripts/testar_relatorio.py
# Depois, pedir ao Codex a execução pela skill
# e comparar com o resultado do script.
Do conceito à ação
- Instalar o exemplo: identificar a condição inicial.
- Gerar relatório: aplicar a decisão descrita.
- Testar falhas: conferir o efeito no exemplo.
- Entregar evidências: registrar a evidência de saída.
✓ Faça assim
Compare a execução direta com a execução orientada pela skill.
✗ Evite este erro
Afirmar que o gatilho do Codex foi testado só porque o Python passou.
Pratique antes de revelar
Adicione um limite de valor por linha, documente-o e crie um caso que o exceda.
Ver resposta comentada
Uma solução aceitável define o limite, rejeita o valor excedente com mensagem clara e mantém o caso de R$ 500 aprovado. Esse limite é uma escolha do exercício, não uma regra comercial universal.
Revise seu portfólio de skills
O que é
Uma biblioteca saudável contém tarefas com fronteiras claras, exemplos e manutenção possível. Revise skills parecidas, gatilhos que competem e regras obsoletas. Consolide duplicações quando houver evidência de que representam o mesmo processo.
Por que aprender
A habilidade final não é escrever mais instruções: é manter um sistema em que cada procedimento pode ser encontrado, executado e avaliado. Refaça a revisão quando o trabalho mudar, não apenas quando o texto parecer antigo.
Conceitos-chave
Revisão final
[ ] Saída aprovada e contrato claros
[ ] Um trabalho e gatilhos testados
[ ] Liberdade calibrada por etapa
[ ] QA com evidências
[ ] Configuração avaliada
[ ] Feedback virou teste
✓ Faça assim
Priorize a skill que causa mais retrabalho observável.
✗ Evite este erro
Aumentar instruções para cada incidente sem remover contradições.
Pratique antes de revelar
Explique sua skill a outra pessoa em 60 segundos: entrada, saída, limite e evidência.
Ver resposta comentada
Se a pessoa consegue localizar a pasta, executar o exemplo, reconhecer uma falha e revisar o QA, o pacote está ensinável. O próximo passo é testá-lo com novas entradas reais devidamente preparadas.
Confira seu entendimento
Qual mudança fecha o ciclo de aprendizado?
O que você leva deste módulo
Entregar uma skill, casos de teste, QA e histórico de melhoria.
- Aumente autonomia conforme a evidência.
- Dê feedback que identifica a menor correção.
- Transforme a falha em teste de regressão.
- Versione a receita e preserve a reversão.
- Conclua o projeto: relatório semanal.
- Revise seu portfólio de skills.
Próxima ação: guarde o exercício no seu laboratório e registre o que ainda precisa de revisão.