Communitygithub.com

Lev-it/lev-skills (Sessão de QA)

Sessão interativa de QA onde o usuário relata bugs ou problemas de forma conversacional, e o agente cria issues no GitHub. Explora o código-fonte em segundo plano para obter contexto e linguagem do domínio. Use quando o usuário quiser relatar bugs, fazer QA, criar issues de forma conversacional, ou mencionar 'sessão de QA'.

O que é lev-skills (Sessão de QA)?

Esta skill transforma uma conversa com o usuário em issues de GitHub bem estruturadas e acionáveis. Em vez de o usuário preencher formulários ou escrever relatórios técnicos, ele descreve os problemas em linguagem natural, e o agente assume a responsabilidade de esclarecer, explorar o código-fonte em busca de contexto e linguagem do domínio, e criar issues que sejam compreensíveis e úteis para outros desenvolvedores — mesmo após grandes refatorações. A skill suporta a criação de issues únicas ou a decomposição de relatos complexos em múltiplas issues menores, cada uma com dependências claras e passos de reprodução obrigatórios. É particularmente útil para desenvolvedores, testadores ou gerentes de produto que desejam uma maneira rápida e conversacional de transformar feedback em tarefas no GitHub, maximizando a paralelização do trabalho. A skill utiliza ferramentas de linha de comando (`gh issue create`) e agentes de exploração de código, mas não exige que o usuário revise as issues antes de serem criadas, agilizando o fluxo de QA.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/qa

Perguntar na sua IA favorita

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

Documentação

Sessão de QA

Execute uma sessão interativa de QA. O usuário descreve os problemas que está encontrando. Você esclarece, explora o código-fonte para obter contexto e cria issues no GitHub que sejam duráveis, focadas no usuário e que utilizem a linguagem do domínio do projeto.

Para cada issue que o usuário levantar

1. Escute e esclareça levemente

Deixe o usuário descrever o problema com suas próprias palavras. Faça no máximo 2 a 3 perguntas curtas de esclarecimento, focadas em:

  • O que ele esperava vs o que realmente aconteceu
  • Passos para reproduzir (se não for óbvio)
  • Se é consistente ou intermitente

NÃO faça muitas perguntas. Se a descrição for clara o suficiente para criar a issue, siga em frente.

2. Explore o código-fonte em segundo plano

Enquanto conversa com o usuário, inicie um Agente (subagent_type=Explore) em segundo plano para entender a área relevante. O objetivo NÃO é encontrar uma correção — é:

  • Aprender a linguagem do domínio usada naquela área (verifique UBIQUITOUS_LANGUAGE.md)
  • Entender o que o recurso deve fazer
  • Identificar o limite do comportamento visível para o usuário

Esse contexto ajuda você a escrever uma issue melhor — mas a issue em si NÃO deve fazer referência a arquivos, números de linha ou detalhes internos de implementação.

3. Avalie o escopo: issue única ou divisão?

Antes de criar a issue, decida se isso é uma issue única ou se precisa ser dividida em várias issues.

Divida quando:

  • A correção abrange várias áreas independentes (por exemplo, "a validação do formulário está errada E a mensagem de sucesso está ausente E o redirecionamento está quebrado")
  • Há preocupações claramente separáveis nas quais pessoas diferentes poderiam trabalhar em paralelo
  • O usuário descreve algo que tem vários modos de falha ou sintomas distintos

Mantenha como issue única quando:

  • É um comportamento único que está errado em um único lugar
  • Os sintomas são todos causados pelo mesmo comportamento raiz

4. Crie a(s) issue(s) no GitHub

Crie as issues com gh issue create. NÃO peça para o usuário revisar primeiro — apenas crie e compartilhe as URLs.

As issues devem ser duráveis — elas devem fazer sentido mesmo após grandes refatorações. Escreva da perspectiva do usuário.

Para uma issue única

Use este modelo:

## O que aconteceu

[Descreva o comportamento real que o usuário experimentou, em linguagem simples]

## O que eu esperava

[Descreva o comportamento esperado]

## Passos para reproduzir

1. [Passos concretos e numerados que um desenvolvedor possa seguir]
2. [Use termos de domínio do código-fonte, não nomes de módulos internos]
3. [Inclua entradas, sinalizadores ou configurações relevantes]

## Contexto adicional

[Quaisquer observações extras do usuário ou da exploração do código-fonte que ajudem a contextualizar a issue — por exemplo, "isso só acontece ao usar a camada Docker, não a camada de sistema de arquivos" — use linguagem de domínio, mas não cite arquivos]

Para uma divisão (várias issues)

Crie as issues em ordem de dependência (bloqueadores primeiro) para que você possa referenciar números de issues reais.

Use este modelo para cada sub-issue:

## Issue pai

#<número-da-issue-pai> (se você criou uma issue de rastreamento) ou "Relatado durante a sessão de QA"

## O que está errado

[Descreva este problema de comportamento específico — apenas esta parte, não o relatório inteiro]

## O que eu esperava

[Comportamento esperado para esta parte específica]

## Passos para reproduzir

1. [Passos específicos para ESTA issue]

## Bloqueado por

- #<número-da-issue> (se esta issue não puder ser corrigida até que outra seja resolvida)

Ou "Nenhum — pode começar imediatamente" se não houver bloqueadores.

## Contexto adicional

[Quaisquer observações extras relevantes para esta parte]

Ao criar uma divisão:

  • Prefira muitas issues finas a poucas issues grossas — cada uma deve ser corrigível e verificável de forma independente
  • Marque as relações de bloqueio honestamente — se a issue B genuinamente não puder ser testada até que a issue A seja corrigida, diga isso. Se forem independentes, marque ambas como "Nenhum — pode começar imediatamente"
  • Crie as issues em ordem de dependência para que você possa referenciar números de issues reais em "Bloqueado por"
  • Maximize o paralelismo — o objetivo é que várias pessoas (ou agentes) possam pegar issues diferentes simultaneamente

Regras para todos os corpos de issue

  • Sem caminhos de arquivo ou números de linha — eles ficam desatualizados
  • Use a linguagem de domínio do projeto (verifique UBIQUITOUS_LANGUAGE.md se existir)
  • Descreva comportamentos, não código — "o serviço de sincronização falha ao aplicar o patch", não "applyPatch() lança exceção na linha 42"
  • Passos de reprodução são obrigatórios — se você não conseguir determiná-los, pergunte ao usuário
  • Seja conciso — um desenvolvedor deve ser capaz de ler a issue em 30 segundos

Após criar, imprima todas as URLs das issues (com as relações de bloqueio resumidas) e pergunte: "Próxima issue, ou terminamos?"

5. Continue a sessão

Continue até que o usuário diga que terminou. Cada issue é independente — não as agrupe.

Individual skills in this repo

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

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Teach the user a new skill or concept, within this workspace.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Move issues through a state machine of triage roles — categorise, reproduce, grill if needed, and write agent-ready briefs.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

Habilidades Relacionadas