O que a11y-audit-agent-skill faz?
Habilidade de auditoria de acessibilidade para aplicativos web que combina varredura automatizada, verificação manual e relatórios WCAG prontos para remediação.
Visão Geral
Esta habilidade permite que agentes de IA realizem auditorias completas de acessibilidade em aplicações web. Ela utiliza ferramentas como axe-core e Lighthouse para varredura automatizada, além de fornecer listas de verificação para inspeção manual de elementos que ferramentas automatizadas não conseguem avaliar completamente (como contraste de cores, navegação por teclado e semântica de ARIA).
Funcionalidades
- Varredura Automatizada: Executa análises com axe-core e Lighthouse para detectar violações comuns de acessibilidade.
- Verificação Manual: Guias e listas de verificação para testar aspectos como navegação por teclado, foco visível e leitores de tela.
- Relatórios WCAG: Geração de relatórios estruturados por critérios de sucesso WCAG (níveis A, AA, AAA).
- Sugestões de Correção: Recomendações práticas para remediar cada problema identificado.
- Suporte a Múltiplos Formatos: Saída em Markdown, HTML ou JSON.
Como Usar
- Configurar o Ambiente: Certifique-se de que as dependências necessárias estejam instaladas (por exemplo,
@axe-core/cli,lighthouse). - Executar a Auditoria: O agente irá executar a varredura automatizada na URL fornecida.
- Revisar os Resultados: O relatório gerado conterá itens categorizados por severidade (crítico, grave, moderado, menor).
- Implementar Correções: Siga as sugestões para corrigir cada violação.
- Reauditar: Após as correções, execute novamente a auditoria para verificar a conformidade.
Exemplos de Uso
# Executar auditoria automatizada no site example.com
npx @axe-core/cli https://example.com --save report.json
// Exemplo de chamada de API para gerar relatório
const auditoria = new A11yAudit();
const relatorio = await auditoria.executar('https://exemplo.com');
console.log(relatorio);
Requisitos
- Node.js 14.x ou superior
- Navegador Chromium (para Lighthouse)
- Conexão com a internet
Recursos Adicionais
Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests no repositório.
Licença
MIT