CommunityRedacción y edicióngithub.com

AnjanJ/shipkit

Mejora tu código con Claude. Skills, agentes, reglas y bases de conocimiento para Claude Code. Espejo de codeberg.org/AnjanJ/shipkit

¿Qué es shipkit?

Esta skill, denominada **/qa (Quality Assurance Workflow)**, está diseñada para realizar un control de calidad exhaustivo automatizado sobre cambios recientes en un repositorio o sobre un archivo específico. Es compatible con Claude Code y se ejecuta inline, sin contexto de bifurcación, lo que permite realizar preguntas al usuario o solicitar aprobación de planes. La skill detecta automáticamente el framework de pruebas (RSpec, Minitest, ExUnit, Jest, Vitest, Playwright) y clasifica los archivos modificados por nivel de riesgo (CRÍTICO, ALTO, MEDIO, BAJO). Durante el proceso, plantea preguntas de sondeo enfocadas en riesgos, elabora un plan de pruebas estructurado (Happy Path, Edge Cases, Error Cases, Bizarre/Adversarial, Performance, Integration), espera aprobación para escribir las pruebas, y finalmente ejecuta y verifica los resultados, emitiendo un veredicto final: SHIP IT, FIX AND RE-TEST o NEEDS REWORK. Incorpora principios de calidad de código como KISS, YAGNI, DRY con moderación y nombres descriptivos.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add AnjanJ/shipkit

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

/qa — Flujo de Trabajo de Control de Calidad

Ejecuta esta skill para realizar un control de calidad exhaustivo sobre cambios recientes o un archivo específico.

Archivos Modificados Recientemente

!git diff --name-only HEAD~1 2>/dev/null | head -20 || echo "no se detectaron cambios recientes"

Fase 1: Reconocimiento

  1. Detectar framework de pruebas comprobando:
    • Gemfile con rspec/minitest → RSpec o Minitest
    • mix.exs → ExUnit
    • package.json con jest/vitest → Jest o Vitest
    • playwright.config → Playwright
  2. Identificar archivos modificados — si $ARGUMENTS es la ruta de un archivo, usar ese; en caso contrario ejecutar git diff --name-only HEAD~1
  3. Clasificar cada archivo por nivel de riesgo:
    • CRÍTICO: autenticación, pagos, modelos de datos, utilidades compartidas, endpoints de API
    • ALTO: lógica de negocio, servicios, controladores
    • MEDIO: vistas, serializadores, ayudantes, configuración
    • BAJO: documentación, comentarios, formato
  4. Leer cada archivo modificado y sus pruebas existentes (si las hay). Si se han modificado más de ~5 archivos, delegar esta lectura al agente codebase-explorer y trabajar a partir de su resumen — mantener el contexto principal para las preguntas y las pruebas.
  5. Construir una tabla de contexto:
ArchivoTipoRiesgo¿Pruebas Existentes?
............

Fase 2: Interrogatorio

Antes de escribir cualquier prueba, realizar de 3 a 8 preguntas de sondeo usando AskUserQuestion. Agrupar las preguntas — no preguntar de una en una.

Buenas preguntas (centradas en el riesgo):

  • "Esto afecta al flujo de pagos — ¿debo probar casos extremos de reembolso?"
  • "La nueva validación rechaza la entrada vacía. ¿Qué pasa con cadenas solo unicode?"
  • "Este servicio llama a una API externa — ¿debo simularla o probar la integración?"

Malas preguntas (no preguntar esto):

  • "¿Qué hace este código?" (léelo tú mismo)
  • "¿Debo escribir pruebas?" (sí, siempre)
  • "¿Qué framework de pruebas debo usar?" (detéctalo)

Fase 3: Plan de Pruebas

Presentar un plan de pruebas estructurado ANTES de escribir cualquier especificación. Organizar por categoría:

Categorías de Pruebas

  1. Camino Feliz — las entradas esperadas producen salidas esperadas
  2. Casos Extremos — valores límite, entradas vacías, valores máximos, nil/null
  3. Casos de Error — entrada no válida, fallos de red, tiempos de espera, permiso denegado
  4. Bizarro/Adversarial — cadenas de inyección SQL, etiquetas de script, emojis, cadenas de 10MB, acceso concurrente
  5. Rendimiento — consultas N+1, colecciones ilimitadas, consultas lentas (solo para riesgo CRÍTICO/ALTO)
  6. Integración — interacciones entre componentes (solo cuando se modifican varios archivos)

Presentar como tabla:

#CategoríaDescripción de la PruebaNivel de Riesgo
1Camino FelizCrea registro con parámetros válidosALTO
............

Esperar la aprobación del usuario antes de continuar.

Fase 4: Escritura de Especificaciones

Escribir las especificaciones siguiendo estos patrones:

  • Una aserción por prueba (cuando sea práctico)
  • Nombres descriptivos — it "devuelve 404 cuando el registro no se encuentra" no it "funciona"
  • Estructura Arrange-Act-Assert
  • Sin invitados misteriosos — todos los datos de la prueba visibles en ella
  • Probar comportamiento, no implementación — no probar métodos privados directamente
  • Usar fábricas/fixtures adecuados al framework
  • Agrupar por comportamiento con bloques describe/context

Calidad del Código de Prueba

Las pruebas también son código — aplicar los mismos principios:

  • KISS: Sin ayudantes de prueba sobreingenierizados. Si la configuración tiene más de 10 líneas, simplificar la prueba o el código bajo prueba.
  • YAGNI: No probar escenarios que no pueden ocurrir. No añadir pruebas "por si acaso" para estados imposibles.
  • DRY (con moderación): Preferir duplicación clara sobre ejemplos compartidos ingeniosos. Una prueba debe leerse de principio a fin sin saltar a 3 archivos auxiliares.
  • Código Limpio: Nombres de prueba descriptivos que se lean como documentación. Sin invitados misteriosos — todos los datos visibles en la prueba.

Ver @reference.md para notas de pruebas específicas del framework (RSpec, Minitest, ExUnit, Jest/Vitest).

Fase 5: Ejecución y Verificación

  1. Ejecutar las nuevas especificaciones — ejecución dirigida (solo el nuevo archivo)
  2. Corregir cualquier fallo — leer error, leer fuente, corregir causa raíz
  3. Ejecutar la suite completa — asegurar que nada más se rompe
  4. Producir el informe de QA — Ver @reference.md para la plantilla del informe, auditoría de valores centrales y verificación de racionalización.

Veredicto: ENVIAR / CORREGIR Y VOLVER A PROBAR / NECESITA RETRABAJO

Skills relacionados