Communitygithub.com

AaronAsAChimp/skills

Use para avaliar uma aplicação construída com

O que é skills?

A skill AaronAsAChimp/skills foi projetada para revisar codebases criados com

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AaronAsAChimp/skills/tree/HEAD/skills/immaculate-vibes

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Vibes Imaculadas

Você está sendo solicitado a revisar este codebase construído com "vibe coding". Você não está sendo solicitado a corrigir nenhum dos problemas que encontrar, apenas a fornecer recomendações.

Processo

O processo de alto nível é o seguinte:

  1. Reúna toda a documentação disponível do produto.
  2. Faça perguntas ao usuário para aprofundar seu entendimento da aplicação.
  3. Revise o código com base nos pilares de qualidade.
  4. Crie um relatório com suas descobertas.

Pilares de qualidade

Estes são os pilares para escrever software de alta qualidade. Listados em ordem de importância, use-os como sua lente para visualizar este projeto.

  • Segurança – Autenticação, permissões, exposição de dados e comportamento inseguro do navegador.
  • Confiabilidade – Fluxos críticos, saúde das rotas, asserções, erros no console e estados quebrados.
  • Desempenho – Comportamento de carregamento, capacidade de resposta, recursos caros e latência visível ao usuário.
  • UI/UX – Navegação, clareza, validação, expectativas de conteúdo e coesão visual.
  • Acessibilidade – Acesso pelo teclado, semântica, rótulos, ARIA, contraste e sinais de tecnologia assistiva.

Processo detalhado

1. Reúna a documentação disponível do produto

Nesta fase, você procurará por qualquer documentação do produto disponível. Isso estabelecerá a base para sua revisão, portanto, encontre tudo que possa estar relacionado aos pilares de qualidade.

Locais comuns para procurar:

  • PRODUCT.md
  • PRD.md
  • README.md
  • docs/

2. Faça perguntas ao usuário

A documentação do produto pode estar incompleta ou dessincronizada com o estado atual da aplicação. Faça perguntas ao usuário que ajudem a aprofundar seu entendimento do projeto e seus requisitos. Se disponível, use a ferramenta de fazer perguntas; caso contrário, converse com o usuário.

Exemplos de perguntas:

  • Quem precisa ter acesso a esta aplicação?
  • Qual é o plano para manutenção contínua?
  • Como você vai monitorar esta aplicação e verificar seu desempenho e confiabilidade?
  • Onde esta aplicação será hospedada?

3. Revise o código

Usando as informações coletadas, inicie subagentes para revisar o código de cada pilar de qualidade. Mantenha-os separados para evitar poluição do contexto. Atribua a eles a tarefa de encontrar problemas e fornecer uma avaliação go/no-go com base em seu pilar de qualidade individual.

Cada problema:

  • deve ser um problema concreto e acionável
  • inclui uma avaliação de impacto do problema
    • Atribua um destes níveis de impacto a cada problema: Showstopper, Crítico, Moderado ou Bom ter
  • inclui uma descrição clara do problema e o nome do arquivo e números de linha relevantes (se houver)
  • fornece uma recomendação de solução

4. Crie um relatório

Finalize reunindo todos os resultados dos subagentes e crie um relatório HTML detalhado, além de fornecer um resumo de alto nível no chat. Abra o relatório HTML no navegador para o usuário revisar.

Principais características do relatório:

  • Uma recomendação go/no-go
  • Requisitos: resumo de alto nível do produto e seus requisitos principais
  • Problemas: uma lista dos problemas encontrados, ordenados por nível de impacto (do mais grave ao menos)
  • Outras informações: quaisquer outras descobertas importantes que um revisor precisaria saber

Exemplo de relatório:

Recomendação: No-go

O classificador de cafés Fourgrounds é uma aplicação pública que permite que os clientes da cafeteria Fourgrounds classifiquem suas bebidas de café favoritas.

Requisitos principais:

  • O usuário deve ver uma lista das bebidas atualmente disponíveis no Fourgrounds
  • O usuário deve poder arrastar para reordenar as bebidas conforme sua preferência
  • O usuário deve poder enviar sua classificação e ser recompensado com um item de padaria gratuito de sua escolha
  • O usuário deve poder enviar sua classificação apenas uma vez

Problemas:

O usuário pode enviar múltiplas vezes às quintas-feiras

Impacto: CRÍTICO – O usuário pode acumular múltiplas recompensas gratuitas.

Devido a um erro na análise da data em date.js linha: 42, uma exceção não tratada pode fazer com que a verificação de envio anterior seja ignorada em check-reward.js linha: 16.

Recomendação: Use o analisador de data interno e envolva a análise da data em um try/catch para evitar que exceções afetem outras áreas da aplicação.

Outras informações:

  • O arquivo coffee-products.json é gerado diariamente; se os produtos mudarem no meio do dia, ele pode estar desatualizado. Consumidores externos das classificações devem tomar cuidado para validar a existência dos produtos.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

Habilidades Relacionadas