Breve Reprodução de Bug

Use esta habilidade quando um relatório de bug estiver incompleto, intermitente, específico do ambiente ou misturado com uma causa presumida. O objetivo é provar a menor falha observável antes que o diagnóstico ou o reparo comecem.

1. Registre a falha observada

Capture o erro exato, a saída incorreta, o carimbo de data/hora, a rota ou comando afetado e a menor entrada conhecida. Preserve os logs relevantes sem segredos ou dados pessoais. Rotule descrições de segunda mão como não verificadas.

2. Identifique o ambiente

Registre apenas fatos que você possa inspecionar:

• repositório e commit;
• versões do runtime e do gerenciador de pacotes;
• sistema operacional ou contêiner;
• arquivo de bloqueio de dependências;
• flags de recursos relevantes;
• se o destino é local, teste, staging ou produção.

Nunca adivinhe credenciais ou configuração de produção.

3. Separe o comportamento esperado do real

Escreva duas declarações observáveis explícitas:

Expected: [observable result]
Actual:   [observable result, including status or error]

Não coloque a causa suspeita em nenhuma das declarações.

4. Reduza a reprodução

Comece a partir do caminho relatado, depois remova dados, serviços e etapas não relacionados um por um. Mantenha o menor "fixture" que ainda falha. Se a falha parar, restaure a última condição removida e registre-a.

Prefira um teste isolado, um script mínimo ou a menor solicitação segura em vez de reproduzir contra a produção.

5. Prove a repetibilidade

Execute a reprodução mínima pelo menos duas vezes, onde for seguro. Registre comandos e saídas. Se a falha for intermitente, relate a frequência e a duração observadas em vez de chamá-la de determinística.

6. Pare antes do reparo

Uma reprodução verificada é o entregável. Não edite o código de implementação ao construir o breve, pois isso pode destruir a evidência ou misturar diagnóstico com remediação.

Saída

# Bug Reproduction Brief

- Target and commit:
- Environment:
- Expected:
- Actual:
- Minimal steps:
- Minimal fixture:
- Reproduced: yes / no / intermittent
- Evidence:
- Unknowns:
- Safe next hypothesis to test:

Limites de segurança

• Não altere dados de produção apenas para reproduzir um bug.
• Não publique segredos, registros de clientes ou código-fonte privado.
• Não afirme uma causa raiz apenas por correlação.
• Use descoberta somente leitura ou reversível primeiro.
• Pare após uma reprodução verificada; diagnóstico e reparo são fluxos de trabalho separados.

Exemplo de prompt

Use the Bug Reproduction Brief skill on the failing checkout test. Do not fix it yet. Reduce it to the smallest safe failing fixture and report the exact command evidence, expected result, actual result, and remaining unknowns.

Fonte e licença

Adaptado do fluxo de trabalho licenciado pelo MIT em https://github.com/skyestrela/ai-agent-skill-preview.