Bruno91dev/portfolio-qa

Transforma anotações soltas sobre um defeito em um bug report claro e reproduzível. Use quando o usuário descrever um bug encontrado e pedir para registrá-lo.

O que é portfolio-qa?

Esta skill (habilidade) é projetada para agentes de IA (como Claude Code, Cursor ou Codex) que auxiliam desenvolvedores e QAs no registro de bugs. Ela recebe uma descrição informal (em português) de um defeito e a converte automaticamente em um bug report estruturado, seguindo um modelo pré-definido (docs/modelo-bug-report.md). A skill aplica regras específicas de qualidade: garante títulos descritivos iniciados pelo módulo, passos numerados para reprodução, separação clara entre resultado esperado e obtido, sugestões justificadas de severidade/prioridade e descrição do impacto para o cliente. Se faltarem informações essenciais (ambiente, perfil, dados), a skill lista perguntas ao invés de inventar dados. Caso uma requisição/resposta de API esteja envolvida, ela inclui ambas em blocos de código, removendo tokens, senhas e dados pessoais. O resultado final é um bug report em Markdown pronto para copiar e colar em ferramentas de gestão (Jira, Trello, etc).

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Bruno91dev/portfolio-qa/tree/HEAD/claude-skills/escrever-bug-report

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Transforme a descrição do usuário em um bug report seguindo o modelo do arquivo docs/modelo-bug-report.md deste repositório.

Regras

  • Título: [Módulo] o que acontece + em qual situação. Nada de "erro no sistema".
  • Passos para reproduzir: numerados, um passo por ação, com os dados usados.
  • Esperado x obtido: sempre separados. Se o resultado esperado não estiver claro, pergunte ou marque [confirmar].
  • Severidade e prioridade: sugira e explique em uma linha. A decisão final é do QA.
  • Impacto para o cliente: descreva como o problema afeta quem usa o sistema.
  • Se faltar informação essencial (ambiente, perfil do usuário, dados), liste as perguntas no final em vez de inventar.
  • Se houver requisição e resposta de API, inclua as duas em blocos de código, removendo tokens, senhas e dados pessoais.

Entrega

O bug report pronto em Markdown, para copiar na ferramenta de gestão do time.

Individual skills in this repo

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

Habilidades Relacionadas