Assay

Visão Geral

Uma página que você acabou de escrever ainda não tem testes. assay carrega a página localmente, abre-a em um navegador Chromium real através do Playwright, encontra todos os controles nela, utiliza todos eles e relata onde a página se contradiz. Não há testes para escrever, nenhum LLM, nenhuma chave de API e nenhuma rede. A mesma página fornece o mesmo resultado toda vez.

Use essa habilidade após criar ou alterar uma página da web, para executar o assay nessa página e relatar a única linha que ela imprime. A habilidade relata o resultado e não altera o código por causa dele, a menos que você peça.

Quando Usar Esta Habilidade

• Use quando você acabou de criar uma página HTML e quer saber se seus controles funcionam antes de seguir em frente.
• Use quando você alterou uma página, ou o JavaScript ou CSS que uma página carrega, e quer confirmar que a página ainda se mantém unida.
• Use quando o usuário pede para você verificar, fazer QA ou smoke-test de uma página web local.
• Execute uma vez no final, após a última edição, em cada página que você alterou. Não execute enquanto ainda estiver fazendo alterações.

Como Funciona

Passo 1: Instale o CLI uma vez

Instale o assay do PyPI. O pacote é chamado assay-ui e o comando que ele instala é assay.

pip install assay-ui

Ele precisa de Python 3.10 ou mais recente. Na primeira execução, o assay baixa a compilação do Chromium que o Playwright usa.

Passo 2: Execute o assay na página que você alterou

Aponte o assay para a própria página e peça o resumo de uma linha.

assay <the page you changed> --one-line

Aponte-o para um arquivo como todo.html ou dist/index.html. Uma pasta também funciona e abre o index.html dentro dela. A página geralmente está uma ou duas pastas acima do arquivo que você editou, então uma alteração em um script ou folha de estilo ainda significa executar o assay na página que a carrega. O assay não precisa de chave, rede ou configuração. Uma página pequena leva segundos, e uma página movimentada pode levar um minuto ou mais.

Passo 3: Relate a única linha que o assay imprimiu, literalmente

Coloque a saída do assay, palavra por palavra, como a última coisa em sua resposta. Já é uma linha, ou uma linha e uma lista curta. Não resuma, reformate, adicione ou escreva sua própria versão.

Uma execução limpa se parece com isto, com os próprios números e palavras do assay.

assay: checked todo/todo.html, 8 checks, nothing flagged.

Uma execução que sinalizou algo se parece com isto, seguida por uma lista curta.

assay: checked notes/index.html, 12 checks, 4 flagged:

Relate a linha, quer ela tenha sinalizado algo ou não. Sem ela, o leitor não consegue distinguir uma página limpa de uma verificação que nunca foi executada.

Se o comando não foi executado, diga isso com suas próprias palavras, nomeie a página e cite o que o shell realmente imprimiu. Nunca descreva uma verificação que não aconteceu como uma que passou, e nunca adivinhe a causa.

Passo 4: Relate a descoberta e pare

Relate o que o assay encontrou e pare. Não edite o código em resposta a uma descoberta na mesma resposta. Se o usuário então pedir para você corrigir, corrija.

Exemplos

Exemplo 1: Uma página que verifica limpa

Usuário: Adicionei uma lista de tarefas em todo/todo.html. Funciona?

assay todo/todo.html --one-line

assay: checked todo/todo.html, 8 checks, nothing flagged.

Relate essa linha como a última coisa na resposta, e não altere a página.

Exemplo 2: Uma página onde o assay sinalizou algo

assay notes/ --one-line

assay: checked notes/index.html, 12 checks, 4 flagged:
  - draw on canvas twice, then press Undo twice: it reacted one press late

Relate a linha inteira e sua lista curta, diga que uma descoberta é um lugar para olhar em vez de um bug confirmado, e espere o usuário pedir antes de alterar qualquer coisa.

Exemplo 3: O comando não foi executado

assay dist/index.html --one-line

assay: error: dist/index.html does not exist

Diga que o assay não foi executado, nomeie a página e cite a mensagem. Não relate uma verificação que não ocorreu como uma que passou.

Melhores Práticas

• ✅ Execute o assay uma vez, no final, em cada página que você alterou.
• ✅ Aponte para a página compilada, como dist/index.html, não para um template de origem.
• ✅ Imprima a única linha do assay exatamente como saiu, como a última coisa em sua resposta.
• ✅ Quando o assay sinalizar algo, trate como um lugar para olhar e espere ser solicitado antes de alterar o código.
• ❌ Não execute o assay enquanto ainda estiver editando a página.
• ❌ Não resuma, reformule ou invente o resultado, e nunca relate uma verificação que não foi executada como uma que passou.

Limitações

…