CommunityEscrita e Ediçãogithub.com

AnjanJ/shipkit

Entregue código melhor com Claude. Skills, agentes, regras e bases de conhecimento para Claude Code. Espelho de codeberg.org/AnjanJ/shipkit

O que é shipkit?

Este skill, /qa — Quality Assurance Workflow, automatiza o processo de garantia de qualidade para mudanças recentes em um repositório de código. Ele foi projetado para o Claude Code e guia o agente por cinco fases: Reconhecimento, Interrogatório, Plano de Teste, Escrita de Especificações e Execução/Verificação. O skill detecta automaticamente o framework de teste (RSpec, Minitest, ExUnit, Jest/Vitest, Playwright), classifica os arquivos alterados por nível de risco (CRÍTICO, ALTO, MÉDIO, BAIXO) e constrói uma tabela de contexto. Durante o Interrogatório, ele faz perguntas direcionadas ao usuário sobre riscos específicos antes de gerar um plano de teste estruturado com categorias como Caminho Feliz, Casos Limite, Erros e testes Adversariais. Por fim, escreve as especificações seguindo boas práticas (uma asserção por teste, nomes descritivos, estrutura Arrange-Act-Assert) e executa os testes para gerar um relatório de QA com um veredito final: SHIP IT, FIX AND RE-TEST ou NEEDS REWORK. O skill é executado inline (não em fork) para poder fazer perguntas ao usuário, e lida com grandes conjuntos de alterações delegando a leitura de arquivos ao agente codebase-explorer.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add AnjanJ/shipkit

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

/qa — Fluxo de Trabalho de Garantia de Qualidade

Execute este skill para realizar uma Garantia de Qualidade completa em alterações recentes ou em um arquivo específico.

Arquivos Alterados Recentemente

!git diff --name-only HEAD~1 2>/dev/null | head -20 || echo "nenhuma alteração recente detectada"

Fase 1: Reconhecimento

  1. Detectar framework de teste verificando:
    • Gemfile com rspec/minitest → RSpec ou Minitest
    • mix.exs → ExUnit
    • package.json com jest/vitest → Jest ou Vitest
    • playwright.config → Playwright
  2. Identificar arquivos alterados — se $ARGUMENTS for um caminho de arquivo, use esse; caso contrário, execute git diff --name-only HEAD~1
  3. Classificar cada arquivo por nível de risco:
    • CRÍTICO: autenticação, pagamentos, modelos de dados, utilitários compartilhados, endpoints de API
    • ALTO: lógica de negócio, serviços, controladores
    • MÉDIO: visões, serializadores, helpers, configuração
    • BAIXO: documentos, comentários, formatação
  4. Ler cada arquivo alterado e seus testes existentes (se houver). Se mais de ~5 arquivos foram alterados, delegue essa leitura ao agente codebase-explorer e trabalhe a partir de seu resumo — mantenha o contexto principal para as perguntas e os testes.
  5. Construir uma tabela de contexto:
ArquivoTipoRiscoTestes Existentes?
............

Fase 2: Interrogatório

Antes de escrever qualquer teste, faça de 3 a 8 perguntas de sondagem usando AskUserQuestion. Agrupe as perguntas — não pergunte uma de cada vez.

Boas perguntas (focadas em risco):

  • "Isso mexe no fluxo de pagamento — devo testar casos extremos de reembolso?"
  • "A nova validação rejeita entrada em branco. E sobre strings apenas com unicode?"
  • "Este serviço chama uma API externa — devo simulá-la ou testar a integração?"

Perguntas ruins (não faça estas):

  • "O que este código faz?" (leia você mesmo)
  • "Devo escrever testes?" (sim, sempre)
  • "Qual framework de teste devo usar?" (detecte-o)

Fase 3: Plano de Teste

Apresente um plano de teste estruturado ANTES de escrever qualquer especificação. Organize por categoria:

Categorias de Teste

  1. Caminho Feliz — entradas esperadas produzem saídas esperadas
  2. Casos Limite — valores de fronteira, entradas vazias, valores máximos, nulo/nil
  3. Casos de Erro — entrada inválida, falhas de rede, timeouts, permissão negada
  4. Bizarras/Adversariais — strings de injeção SQL, tags de script, emoji, strings de 10MB, acesso concorrente
  5. Desempenho — consultas N+1, coleções ilimitadas, consultas lentas (apenas para risco CRÍTICO/ALTO)
  6. Integração — interações entre componentes (apenas quando múltiplos arquivos foram alterados)

Apresente como uma tabela:

#CategoriaDescrição do TesteNível de Risco
1Caminho FelizCria registro com parâmetros válidosALTO
............

Aguarde a aprovação do usuário antes de prosseguir.

Fase 4: Escrita de Especificações

Escreva especificações seguindo estes padrões:

  • Uma asserção por teste (quando prático)
  • Nomes descritivos — it "retorna 404 quando registro não é encontrado" não it "funciona"
  • Estrutura Organizar-Atuar-Afirmar
  • Sem convidados misteriosos — todos os dados de teste visíveis no teste
  • Teste comportamento, não implementação — não teste métodos privados diretamente
  • Use fábricas/fixtures apropriadas ao framework
  • Agrupe por comportamento com blocos describe/context

Qualidade do Código de Teste

Testes também são código — aplique os mesmos princípios:

  • KISS: Sem helpers de teste superengenhados. Se a configuração tem >10 linhas, simplifique o teste ou o código sob teste.
  • YAGNI: Não teste cenários que não podem acontecer. Não adicione testes "por via das dúvidas" para estados impossíveis.
  • DRY (com moderação): Prefira duplicação clara a exemplos compartilhados engenhosos. Um teste deve ser legível de cima a baixo sem pular para 3 arquivos auxiliares.
  • Clean Code: Nomes de teste descritivos que leem como documentação. Sem convidados misteriosos — todos os dados visíveis no teste.

Veja @reference.md para notas de teste específicas do framework (RSpec, Minitest, ExUnit, Jest/Vitest).

Fase 5: Execução e Verificação

  1. Executar as novas especificações — execução direcionada (apenas o novo arquivo)
  2. Corrigir quaisquer falhas — leia o erro, leia a origem, corrija a causa raiz
  3. Executar a suíte completa — garantir que nada mais quebrou
  4. Produzir o relatório de QA — Veja @reference.md para o modelo de relatório, auditoria de valores centrais e verificação de racionalização.

Veredito: SHIP IT / FIX AND RE-TEST / NEEDS REWORK

Habilidades Relacionadas