Install
npx skills add https://github.com/currents-dev/playwright-best-practices-skillPara quem
Este guia é para quem escreve, depura ou mantém testes Playwright em TypeScript e quer que um agente dê conselhos apontados à atividade atual. Oficialmente é impulsionado pela atividade: o que está a fazer aponta para as referências correspondentes, em vez de carregar tudo de uma vez.
Repositório:
https://github.com/currents-dev/playwright-best-practices-skill
Serve quando o repositório já tem testes Playwright e precisa de corrigir um caso instável ou acrescentar verificações de acessibilidade. O material diz que não precisa de pronunciar o nome da competência nem “Playwright best practices”; basta enunciá-la com clareza.
Não serve em ambientes que escrevem sobretudo testes noutras linguagens, ou sem um mecanismo compatível de instalação de competências. O material existente limita a orientação a testes Playwright em TypeScript; não a alargue a linguagens não escritas.
Primeira tentativa em 3 minutos
Siga só o caminho oficial recomendado.
Pré-condições: esta máquina consegue executar npx, o agente atual aceita esta instalação e o espaço de trabalho tem um teste Playwright discutível. Antes de instalar, confirme que está a gravar no ambiente de agente que realmente usa.
Local de instalação: tratado pelo npx skills add. O material não nomeia uma pasta-alvo; não complete um caminho que não aparece.
Copie e execute:
npx skills add https://github.com/currents-dev/playwright-best-practices-skill
Sinal de sucesso: o comando termina normalmente. Faça primeiro uma verificação só de leitura: abra um teste ligado ao início de sessão e diga ao agente «veja este teste de início instável, indique primeiro possíveis causas, não mude ficheiros». O exemplo oficial é exatamente “fix this flaky login test”. Se a resposta citar esperas, alvos ou asserções concretas em vez de uma reescrita vaga, as referências correspondentes foram usadas.
Depois de aceitar a análise, autorize explicitamente que ficheiro pode mudar. Mudar testes tem efeitos colaterais; não o deixe aplicar remendos até confirmar o âmbito.
Casos de uso
Caso 1: investigar um teste de início instável. Corresponde à tarefa de exemplo oficial “fix this flaky login test”. Serve quando um teste às vezes passa e às vezes falha e quer primeiro um conselho focado. Descreva o sintoma e o registo de falha e peça só análise. Em sucesso, a resposta aterra nas referências da atividade atual, sem despejar os 57 documentos de uma vez. O material não nomeia as oito categorias; não invente categorias nem nomes de ficheiro. Antes de mudar de verdade, confirme o ficheiro e o comportamento esperado.
Caso 2: acrescentar testes de acessibilidade. Corresponde ao exemplo oficial “add accessibility tests”. Serve se já existe um fluxo de página e quer verificações de acessibilidade. Peça primeiro asserções propostas a partir do teste de página atual, ainda sem gravar ficheiros. Depois de confirmar seletores e cobertura, deixe acrescentar casos. Sinal de sucesso: o conselho corresponde à página que nomeou, não um modelo genérico. O material existente só mostra que esta descrição de tarefa pode disparar; não expande API nem chaves de configuração.
Limites de uso
O material existente dá um comando de instalação e o uso «apontar referências segundo a atividade». Não mude para um comando de mercado, um caminho de clone ou outro instalador que não aparece. Também não nomeia clientes obrigatórios; não escreva suporte exclusivo de alguns agentes.
A biblioteca de referências tem 57 documentos em 8 classes; nomes de classe e caminhos por documento não estão escritos. Não invente caminhos de documentos nem subpastas de competência.
Orienta escrever, depurar e manter testes Playwright em TypeScript. Passos para outras linguagens ou outros enquadramentos de teste não se completam com o material existente. Mudar testes muda o repositório; analise primeiro e depois autorize a escrita. Mais pormenor no repositório oficial:
https://github.com/currents-dev/playwright-best-practices-skill