Prove It (Prove Isso)
Prove a alteração da forma como uma pessoa a usa. Não afirme que funciona sem essa prova.
Este skill não carrega automaticamente ao dizer "pronto". O usuário deve solicitar. Ele não carrega outros skills.
Quando Usar
Carregue quando o usuário:
- executar
/prove-it - disser "prove it", "prove the changes", "show me in the browser" ou a mesma ideia (inclusive na primeira mensagem)
Pule se ele não pediu. Pule trabalho somente de tipos, comentários, lockfile, documentação sem comportamento.
Portões Rígidos (Hard Gates)
- Usuário pediu. Se ele não pediu para provar, este skill não executa.
- Não diga que funciona, está pronto ou está corrigido a menos que este skill realmente tenha provado. Pular significa não provado.
- Uma captura de tela de uma tela não é prova. Clique, digite, envie, navegue.
- Nenhum novo pacote, dependência, aplicativo de exemplo ou executor de navegador a menos que o usuário tenha escolhido essa opção e dito sim.
- Pare qualquer servidor que este skill iniciou antes de o skill terminar. Não deixe
dev/previewem execução.
UI vs Servidor
- UI (página, componente, rota, formulário, estado visível): prove no navegador.
- Servidor / API / biblioteca sem tela: pergunte como provar. Não escolha em silêncio.
- Ambos: navegador para a UI e pergunte como provar a parte do servidor.
Procedimentos
Procedimento 1: Classificar
- Liste as superfícies: UI, servidor/API ou ambos.
- UI → Procedimento 2.
- Servidor/API → Procedimento 3.
- Ambos → Procedimento 2, depois Procedimento 3 para a API.
Procedimento 2: Navegador (UI)
- Se o aplicativo não estiver em execução, inicie apenas um comando existente (
dev,preview, o início documentado do repositório). Se não houver nenhum, diga que a UI não pode ser provada. Ofereça pular ou que o usuário inicie o aplicativo. - Use-o como um usuário:
- clique, digite, envie, navegue
- em toda rota/página que compartilha este estado
- UI vazia e de erro se esta alteração as tiver
- desktop e uma viewport estreita se o layout ou CSS mudou
- Caça por quebras, não apenas o caminho feliz.
- No chat, diga o que fez e o que viu. Não diga "parece bom" sem passos.
- Pare o processo do passo 1 se este skill o iniciou.
- Procedimento 4.
Procedimento 3: Perguntar (servidor / API)
- Pare. Mostre 2–3 opções. Coloque uma primeira escolha razoável primeiro. Sempre inclua pular.
- exemplo / playground / demo existente
- aplicativo de exemplo que usa a nova API (apenas se eles confirmarem o local + qualquer novo pacote/dep)
- curl ou um pequeno script contra um servidor em execução
- pular
- Aguarde. Não construa nem execute até que eles escolham.
- Se pular: diga não provado. Não diga que funciona. Pare (sem Procedimento 4).
- Se playground existente: execute-o, depois prove no navegador se tiver UI, ou mostre a saída do comando se for um script.
- Se aplicativo de exemplo: pergunte onde. Prefira um exemplo existente. Não adicione um pacote ou dependência a menos que ele tenha dito sim. Depois execute-o e prove.
- Se curl/script: execute-o. Cite o código de saída e a parte da saída que prova a afirmação.
- Procedimento 4.
Procedimento 4: Relatório opcional
- Após uma prova real, pergunte: escrever um relatório com capturas de tela? Padrão não.
- Se não: pare. O chat já tem a evidência.
- Se sim: escreva
.agent/scratch/prove-it.md(sobrescreva). Adicione.agent/scratch/ao.gitignorese estiver faltando (igual a outros arquivos temporários). Inclua o que foi clicado e as capturas. Abra o arquivo. Não o commite. - Pular prova → sem relatório.
Procedimento 5: Parar
Após a prova ou pular, pare. Não inicie trabalho não relacionado a partir deste skill.
Árvore de Decisão
- Usuário não pediu para provar → este skill não se aplica.
- UI → Procedimento 2 → 4 → 5.
- Servidor/API → Procedimento 3 → 4 → 5 (pular termina em 3).
- Ambos → 2 depois 3, depois 4 → 5.
- Nenhum comando de início e aplicativo não está em execução → diga que não pode provar a UI. Pular ou usuário inicia.
- Usuário diz pular → não provado. Nenhuma afirmação de sucesso.
Bandeiras Vermelhas (Red Flags)
| Sinal | O que significa | O que fazer em vez disso |
|---|---|---|
| Dizer "pronto" porque os testes passaram | Este skill não foi solicitado ou a prova foi pulada | Afirme "provado" somente após o Procedimento 2 ou 3. |
| Uma captura de tela, sem cliques | Não é um caminho de usuário | Procedimento 2, passo 2. |
Construir examples/foo antes de eles escolherem | Aplicativo não solicitado | Procedimento 3. Aguarde. |
| Adicionar Playwright / um novo servidor | Nova dependência | Somente comando de início existente. |
Deixar pnpm dev em execução | Watcher deixado ligado | Portão rígido 5. |
| "Pular, mas funciona" | Pular transformado em afirmação | Diga "não provado". |
Arquivo de relatório em docs/ | Documentação do produto | .agent/scratch/prove-it.md. |
| Abrir o relatório quando eles disseram não | Arquivo não solicitado | Procedimento 4, padrão não. |
| Provar apenas a página para uma nova API pública | Parte do servidor pulada em silêncio | Procedimento 3 para a API. |
Tratamento de Erros
- Sem ferramentas de navegador: diga que a UI não pode ser provada aqui. Ofereça pular ou que eles cliquem enquanto você espera em uma URL. Não finja uma captura de tela.
- Comando de início falha: cite o erro. Não diga que a UI funciona. Ofereça pular ou uma correção, depois prove novamente.
- Prova falha (clique faz a coisa errada, curl não retorna 200): diga não provado. Nomeie o que falhou. Não o chame de "pronto".
- Eles escolhem aplicativo de exemplo e depois recusam um novo pacote: use curl, um exemplo existente ou pule. Não adicione o pacote mesmo assim.
- Falha ao escrever em scratch: mantenha a prova no chat. Diga que o arquivo de relatório não foi escrito.
Não veja mais nada. O chat é a evidência padrão. O arquivo markdown é opcional.