CommunityProgramación y desarrollogithub.com

Prueba de Regresión por Parche (patch-regression-test)

Verifica que la funcionalidad existente de la aplicación no se vea afectada tras aplicar parches de CVE, actualizaciones de librerías/entorno o correcciones de análisis de código estático. Identifica y escribe los tests faltantes, compara resultados antes y después del parche, genera un informe y lo publica como comentario en el Issue desencadenante.

¿Qué es Prueba de Regresión por Parche (patch-regression-test)?

Esta habilidad está diseñada para AI agents (como Claude Code, Cursor y Devin) que necesitan realizar pruebas de regresión en parches de seguridad, actualizaciones de dependencias o correcciones de código. El skill analiza la aplicación objetivo (lenguaje, tipo, tests existentes, CI), diagnostica su nivel de preparación, identifica tests faltantes, los implementa (solicitando permiso para nuevas librerías), ejecuta los tests y compara los resultados antes y después del parche. Finalmente, genera un informe detallado de la prueba de no regresión y lo publica como comentario en el Issue correspondiente, registrando también la aprobación del líder. Es crucial para asegurar que los cambios no introduzcan regresiones en entornos de producción, especialmente en correcciones urgentes de CVE.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/doikota/agent-skills/tree/HEAD/.claude/skills/patch-regression-test

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Prueba de Regresión por Parche (patch-regression-test)?

1. Resumen y Supuestos

1.1 Propósito

Verificar que la funcionalidad existente de la aplicación se mantenga intacta después de aplicar un parche o corrección (prueba de no regresión). Para ello, se identifican e implementan los tests faltantes de la aplicación, se comparan los resultados antes y después del parche, y se publica un informe resumido en el Issue.

Este skill se utiliza en los siguientes tres escenarios según la directriz:

  • Respuesta Urgente. Realizar la prueba de no regresión para un parche de CVE solicitado por otro proceso dentro del plazo establecido.
  • Preparación Permanente en Tiempo de Paz. Diagnosticar el nivel de preparación de la aplicación y preparar los tests faltantes con antelación (tanto para la primera vez como para las posteriores).
  • Inspección Planificada. Después de la preparación permanente inicial, realizar la prueba de no regresión para correcciones realizadas por herramientas externas o personas (actualizaciones de dependencias, correcciones de vulnerabilidades, correcciones de código fuente).

1.2 Directrices y Estándares Técnicos

  • Antes de comenzar el trabajo, leer obligatoriamente los siguientes dos documentos:
    • references/guideline.md (en adelante, "Directriz"): Qué se debe cumplir (clasificación, condiciones de aprobación/rechazo, roles, reglas de juicio).
    • references/standards.md (en adelante, "Estándares Técnicos"): Cómo cumplirlo (herramientas, métodos de verificación, métodos de medición, nombres de archivos).
  • Los criterios de juicio siguen la Directriz; los métodos siguen los Estándares Técnicos. Si hay discrepancia entre este skill, los Estándares Técnicos y la Directriz, se prioriza la Directriz.
  • Los términos (alcance de la confirmación, preparación permanente en tiempo de paz, inspección planificada, prueba funcional, punto de llamada, prueba inestable, aprobación provisional, etc.) se adhieren a las definiciones de la Directriz "1.5: Términos".
  • En el repositorio de destino, este skill se coloca en .github/skills/patch-regression-test/ (lugar donde lo leen tanto GitHub Copilot como Devin).

1.3 Lo que hace este skill

  • Análisis de la aplicación objetivo (lenguaje, tipo de aplicación, tests y CI actuales, puntos de llamada).
  • Diagnóstico del nivel de preparación (Directriz "3.1.1: Niveles de Preparación").
  • Creación de una propuesta de determinación del alcance de la confirmación (Directriz "Capítulo 2: Clasificación de Parches y Criterios de Confirmación").
  • Identificación de tests faltantes.
  • Implementación del código de test. La introducción de librerías para ejecutar los tests requiere el permiso del usuario.
  • Ejecución de tests y comparación de resultados antes y después del parche (explicar el contenido del comando antes de ejecutarlo).
  • Generación del informe de prueba de no regresión y publicación como comentario en el Issue (si hay un PR, también comentar el enlace al Issue en el PR).
  • Creación de un Issue si no existe uno desencadenante (requiere permiso).
  • Registro de la aprobación del líder (cotejar con la aprobación del PR y dejar constancia como comentario en el Issue).

1.4 Lo que NO hace este skill

Incluso si el usuario lo solicita o lo permite, NO se realizan las siguientes acciones. Se guiará al responsable correspondiente.

Acción no realizadaResponsable
Aplicación de parches, modificación del código fuente de la aplicación (incluye actualizaciones de versiones de dependencias, manejo de cambios disruptivos, corrección de vulnerabilidades, corrección de señalamientos de análisis de código estático, modificaciones para escribir tests)Otras herramientas como Dependabot, Devin, o una persona
Configuración del entorno para ejecutar la aplicación (cambios en la instalación o configuración del entorno de ejecución/middleware). Se excluye la introducción de librerías para ejecutar testsPersona o CI de cada equipo
Modificación o adición de workflowsCada equipo (siguiendo una directriz definida por separado)
Commit y pushLa herramienta que invocó el skill o la persona
Recolección de información de vulnerabilidades, determinación de la necesidad de respuesta urgente, ejecución de análisis de código estáticoOtro proceso
DespliegueCD existente de cada equipo
Determinación del alcance de la confirmación, aprobación de la diferencia esperada, aprobación del PRLíder del equipo de desarrollo
Decisión de lanzamiento cuando el rendimiento no es aceptable, decisión sobre la superación del plazoSubgerente o superior
Decisión de detención o bloqueo del sistemaFlujo de toma de decisiones definido por separado

1.5 Entregables

EntregableUbicación
Código de testSe alinea con la ubicación de los tests existentes de la aplicación objetivo
Lista de puntos de llamadapatch-regression-reports/call-sites.md de la aplicación objetivo
Lista de tests inestablespatch-regression-reports/flaky-tests.md de la aplicación objetivo
Archivo de configuración para ejecución sin diálogopatch-regression-reports/auto-settings.md de la aplicación objetivo
Informe de prueba de no regresiónDentro del directorio de recursos de test de la aplicación objetivo, en patch-regression-reports/ (el nombre sigue los Estándares Técnicos)
Comentario del informeIssue desencadenante. Si hay múltiples Issues relacionados, todos ("9.4: Publicación de comentarios en Issues y PRs")
Comentario del enlace al informePR objetivo (si existe)
Comentario del registro de aprobaciónIssue desencadenante ("Capítulo 10: Registro de Aprobación")

Los archivos se guardan dentro del repositorio; el commit se delega a la herramienta o persona que invocó el skill.

1.6 Flujo de Trabajo

flowchart TD
  S2[2. Inicio y Escenario] --> J0{¿Escenario?}
  J0 -- Registro de aprobación --> S10[10. Registro de Aprobación]
  J0 -- Respuesta Urgente / Preparación Permanente / Inspección Planificada --> S3[3. Confirmación de Información de Entrada]
  S3 --> S4[4. Análisis de la Aplicación Objetivo]
  S4 --> J{¿Escenario?}
  J -- Respuesta Urgente / Inspección Planificada --> S5[5. Propuesta de Determinación del Alcance de Confirmación]
  J -- Preparación Permanente en Tiempo de Paz --> S6[6. Identificación de Tests Faltantes]
  S5 --> S6
  S6 --> S7[7. Implementación de Tests]
  S7 --> S8[8. Ejecución y Comparación de Tests]
  S8 --> S9[9. Generación de Informe y Publicación en Issue]

1.7 Puntos que requieren confirmación del usuario

En los siguientes puntos, se debe presentar una propuesta y su justificación al usuario, solicitar su confirmación y no avanzar hasta recibir respuesta. En el caso de ejecución sin diálogo (--auto), seguir lo indicado en "2.3: Ejecución sin diálogo (solo para inspección planificada)".

Al solicitar confirmación, preguntar también el nombre y rol de la persona que tomará la decisión (ej. líder del equipo de desarrollo).

  • Confirmación del escenario y objetivo (número de CVE/PR), nivel de preparación objetivo para la preparación permanente en tiempo de paz ("Capítulo 2: Inicio y Escenario").
  • Guardado/actualización del archivo de configuración ("2.3: Ejecución sin diálogo (solo para inspección planificada)").
  • Manejo de contradicciones en la información o información de entrada faltante ("3.3: Confirmación del estado" / "3.4: Manejo de información faltante").
  • Tipo de aplicación ("4.2: Tipo de aplicación").
  • Propuesta de determinación del alcance de confirmación, elementos a incluir en el alcance 3, lista de cambios disruptivos, puntos de corrección a incluir en los tests ("Capítulo 5: Propuesta de Determinación del Alcance de Confirmación").
  • Niveles de test a excluir, si se incluye V9: Concurrencia y Recursos ("6.2: Puntos a confirmar con el usuario").
  • Alcance de la implementación ("6.4: Selección del alcance de implementación").
  • Adición de librerías para ejecutar tests, selección de herramientas cuando no hay mecanismo de test ("7.1: Principios de Implementación").
  • Adición a la lista de tests inestables ("7.2: Implementación por tipo de test" / "8.4: Aislamiento de fallos").
  • Instalación de librerías para ejecutar tests, escaneo de vulnerabilidades que usan red/análisis de código estático, ejecución local de tests de larga duración ("Capítulo 8: Ejecución y Comparación de Tests").
  • Si la diferencia encontrada en la ejecución de tests es la esperada, actualización de valores esperados ("8.5: Manejo de diferencias").
  • Creación de Issues, publicación de comentarios en Issues y PRs ("9.4: Publicación de comentarios en Issues y PRs").

2. Inicio y Escenario

2.1 Método de inicio

Recibir el escenario como argumento al iniciar.

EscenarioEjemplo de argumento
Respuesta Urgenteurgente CVE-2026-12345 (para múltiples CVEs, urgente CVE-2026-12345 CVE-2026-23456)
Preparación Permanente en Tiempo de Pazreadiness
Inspección Planificadaplanned 123 (123 es el número del PR de la corrección. Opcional)
Inspección Planificada sin diálogoplanned 123 --auto
Registro de Aprobaciónapprove 123 (123 es el número del PR)
  • PR objetivo. En respuesta urgente, inspección planificada y registro de aprobación, se asume que el PR que contiene el parche o la corrección ha sido creado antes de invocar el skill (por Dependabot, Devin o una persona).
  • Issue objetivo (lugar de publicación). El Issue donde se publica el informe se identifica según el escenario de la siguiente manera. Si hay múltiples Issues relacionados, todos son objetivo.
    • Respuesta Urgente: Issue cuyo título incluye el número de CVE objetivo (Directriz "7.1: Ubicación de la información de vulnerabilidad y el contenido del cambio del parche").
    • Inspección Planificada: Issue vinculado al PR. Si no existe, buscar por la regla del título ("Verificación periódica de desviación", "Análisis de código estático"). Si no se encuentra, crearlo.
    • Preparación Permanente en Tiempo de Paz: No hay Issue, por lo que se crea.
    • Registro de Aprobación: Issue vinculado al PR.
  • Si no hay argumentos, preguntar al usuario cuál es el escenario.
  • Incluso si hay argumentos, mostrar al usuario el escenario y el objetivo recibidos (CVE, PR, Issue de publicación) y obtener confirmación antes de continuar. En caso de --auto, seguir "2.3: Ejecución sin diálogo (solo para inspección planificada)".
  • PR de inspección planificada. Si se omite el número de PR, identificar el PR correspondiente a la rama actual con gh, mostrarlo al usuario y obtener confirmación.
  • --auto solo se puede usar para inspección planificada (planned). Si se especifica --auto en otros escenarios, informar que no es posible y cambiar a ejecución interactiva.

2.2 Trabajo por escenario

EscenarioCapítulos a seguirAcción en "Capítulo 8: Ejecución y Comparación de Tests"
Respuesta UrgenteCapítulos 3 a 9Ejecución individual de los tests añadidos, comparación antes y después del parche, ejecución de "2.4: Tests comunes a todos los alcances de confirmación" de la Directriz
Preparación Permanente en Tiempo de PazCapítulos 3, 4, 6 a 9 (no se realiza el capítulo 5)Ejecución individual de los tests añadidos, ejecución de C1 a C4 de "2.4: Tests comunes a todos los alcances de confirmación" de la Directriz (no se realizan C1 (comparación de árbol de dependencias) ni C5, C7 porque no hay objetivo ni contraparte de vulnerabilidad)
Inspección PlanificadaCapítulos 3 a 9Ejecución individual de los tests añadidos, comparación antes y después de la corrección, ejecución de "2.4: Tests comunes a todos los alcances de confirmación" de la Directriz
Registro de AprobaciónSolo capítulo 10No se realiza
  • Reemplazo de "parche". En la inspección planificada, en todo este skill, "parche" se reemplaza por "corrección" (ej. "antes del parche" se convierte en "antes de la corrección").
  • Objetivo de la preparación permanente en tiempo de paz. El usuario elige hasta qué nivel de preparación se alcanzará (ej. hasta L2).
  • Visualización del tiempo en respuesta urgente. Inmediatamente después de confirmar la hora de solicitud de inicio (I12) en "Capítulo 3: Confirmación de Información de Entrada", mostrar los plazos (24 horas hasta el despliegue en staging, 48 horas hasta la implementación en producción, 12 horas estimadas para la adición y ejecución de tests). A partir de ahí, al finalizar cada capítulo, informar al usuario del tiempo transcurrido y registrarlo en el informe.
  • Si se excede el plazo (respuesta urgente). No se deben omitir las confirmaciones. Informar al usuario que es probable que se exceda el plazo y que se requiere la escalada del líder del equipo de desarrollo al subgerente o superior, y registrarlo en "Elementos que requieren escalada" del informe.
  • No hay plazo en tiempo de paz. En preparación permanente en tiempo de paz e inspección planificada, no se muestran plazos ni se informa del tiempo transcurrido. Tampoco se utiliza la aprobación provisional.

2.3 Ejecución sin diálogo (solo para inspección planificada)

En la inspección planificada, las herramientas de desarrollo de IA pueden ejecutar este skill sin diálogo para un PR de corrección (planned <número de PR> --auto). El tipo de inspección (actualización de dependencias, corrección de vulnerabilidad, corrección de código fuente) no importa.

Los elementos que se habrían decidido consultando a la persona en la ejecución interactiva se registran en la sección "Elementos que requieren confirmación encontrados durante la ejecución sin diálogo" (en adelante, "Pendientes de confirmación") del informe. El responsable debe atender los "Pendientes de confirmación" del informe publicado en el Issue al revisar el PR.

2.3.1 Archivo de configuración

  • La ejecución sin diálogo presupone el archivo de configuración patch-regression-reports/auto-settings.md. La plantilla es templates/auto-settings-template.md.
  • Cancelar si el PR modifica el archivo de configuración. Si el archivo de configuración está incluido en la lista de archivos modificados del PR (ej. git diff --name-only <rama de origen>...HEAD), cancelar sin comenzar el trabajo, informar que se requiere ejecución interactiva y finalizar. Esto es para evitar que el PR mismo pueda cambiar el alcance del permiso.
  • Guardado. Al ejecutar la preparación permanente en tiempo de paz o la inspección planificada de forma interactiva, al final, resumir las respuestas del usuario en el archivo de configuración. Mostrar el contenido al usuario y obtener confirmación antes de guardar. Para los elementos no preguntados en ese momento, preguntar al usuario sin inferirlos. Si ya existe un archivo de configuración, mostrar los cambios y obtener confirmación para la actualización.
  • Si no hay archivo de configuración, o su formato es incorrecto. --auto no se puede usar. Cancelar sin comenzar el trabajo, informar la razón y finalizar.
  • --auto no actualiza el archivo de configuración. Si se nota un punto que debería cambiarse en la configuración, registrarlo en "Pendientes de confirmación".

2.3.2 Manejo de los puntos de confirmación

En el caso de --auto, en "1.7: Puntos que requieren confirmación del usuario", en lugar de preguntar al usuario, se maneja de la siguiente manera.

Punto de confirmaciónManejo sin diálogo
Escenario y PR objetivoTratar como inspección planificada. Usar el número del PR del argumento. Si no hay número, cancelar
Guardado/actualización del archivo de configuraciónNo se realiza. Los puntos a cambiar se registran en "Pendientes de confirmación"
Explicación de comandosComo no hay a quién explicar, registrar el comando ejecutado y su contenido en el informe
Contradicciones en la informaciónRegistrar en "Pendientes de confirmación" y proceder con el contenido del repositorio
Información de entrada faltanteRegistrar como riesgo residual
Tipo de aplicaciónUsar el valor del archivo de configuración. Si difiere de la estimación del código fuente, registrar en "Pendientes de confirmación" y proceder con el valor del archivo de configuración
Propuesta de determinación del alcance de confirmación, elementos a incluir en el alcance 3, lista de cambios disruptivos, puntos de corrección a incluir en los testsProceder con la propuesta y la lista. La determinación final se registra en "Pendientes de confirmación" y la realiza el líder en la revisión del PR
Niveles de test a excluir, si se incluye V9: Concurrencia y RecursosUsar el valor del archivo de configuración
Alcance de implementaciónSeguir la política del archivo de configuración
Selección de herramientas cuando no hay mecanismo de testUsar la herramienta registrada en el archivo de configuración
Adición de librerías para ejecutar testsAgregar solo las que estén en la lista de permisos del archivo de configuración. No agregar las demás y registrarlo en "Pendientes de confirmación"
Adición a la lista de tests inestablesNo se realiza. Los candidatos se registran en "Pendientes de confirmación"
Instalación de librerías, escaneo de vulnerabilidades que usan red/análisis de código estáticoSeguir los permisos del archivo de configuración. Si no hay permiso, no realizar y registrar "Confirmar en CI"
Tests de larga duraciónSeguir la política del archivo de configuración. Si no hay política, delegar en CI
Si la diferencia es la esperada, actualización de valores esperadosNo juzgar. Tampoco actualizar los valores esperados. Si hay diferencias, registrarlo en "Pendientes de confirmación"
Publicación de comentarios en Issues y PRsRealizar. Omitir la confirmación antes de la publicación
Creación de Issue si no existe uno desencadenanteCrear. Omitir la confirmación antes de la creación

3. Confirmación de Información de Entrada

De acuerdo con la tabla (I1 a I14) de la Directriz "Capítulo 7: Información a Recopilar Antes de Comenzar", reunir la información necesaria para el trabajo.

3.1 Elementos a confirmar

EscenarioElementos a confirmar
Respuesta UrgenteTodos de I1 a I13. Si incluye corrección de código fuente, incluir la diferencia del PR de la corrección en I5
Preparación Permanente en Tiempo de PazI7, I8, I8a, I9, I10, I13
Inspección PlanificadaSegún el tipo de inspección, según la tabla "Información utilizada en la inspección planificada" de la Directriz "Capítulo 7: Información a Recopilar Antes de Comenzar" (Actualización de dependencias: I3 a I11, I13; Corrección de vulnerabilidad: I1 a I11, I13; Corrección de código fuente: I5 a I11, I13, I14). Además, el Issue desencadenante y el momento de aplicar la corrección

I11 (Entorno de staging) es obligatorio para los alcances de confirmación 2 y 3. I12 (Hora de solicitud de inicio y plazo) se usa solo para respuesta urgente.

3.2 Método de recopilación de información

  • Información recopilada por sí mismo del repositorio. La siguiente información se recopila leyendo el repositorio de la aplicación objetivo.
    • I3: Versiones antes y después de la actualización (comparar archivos de dependencias de la rama de origen y la rama actual. Para actualizaciones del entorno de ejecución, comparar también los archivos de "3.3: Confirmación del estado").
    • I5: Diferencia del código fuente antes y después de la actualización. Si incluye corrección del código fuente de la aplicación, la diferencia del PR.
    • I6: Árbol de dependencias, dependencias indirectas actualizadas conjuntamente.
    • I7: Lenguaje, tipo de aplicación, destinos de conexión externa.
    • I8 / I8a: Tests actuales, workflows de GitHub Actions, informes de cobertura.
  • Información proporcionada externamente. La siguiente información la recopila otro proceso (Directriz "7.1: Ubicación de la información de vulnerabilidad y el contenido del cambio del parche"). Leer con el comando gh. El método para identificar el Issue sigue lo indicado en "2.1: Método de inicio" en "Issue objetivo (lugar de publicación)".
    1. Información de vulnerabilidad (I1, I2. Respuesta urgente y corrección de vulnerabilidad en inspección planificada). Leer del Issue cuyo título incluya el número de CVE.
    2. Resultado del análisis de código estático (I14. Corrección de código fuente en inspección planificada). Leer del Issue cuyo título incluya "Análisis de código estático" y el identificador del señalamiento.
    3. Issue de verificación periódica de desviación (Actualización de dependencias en inspección planificada). Leer del Issue cuyo título incluya "Verificación periódica de desviación" y el nombre del objetivo de actualización.
    4. Contenido del cambio del parche (I4, I5). Leer de la descripción del PR que contiene el parche o la corrección (ej. PR de Dependabot).
    5. Momento de aplicar la corrección (Inspección planificada). Leer del Issue desencadenante (1 a 3).
    6. Si no se encuentra, o si gh no está disponible (no autenticado, etc.), solicitar al usuario que lo proporcione mediante conversación.
  • Información a preguntar al usuario. I9 (Línea base de rendimiento), I10 (Niveles de test a excluir), I11 (Entorno de staging), I12 (Hora de solicitud de inicio y plazo), I13 (Estructura de personal) se preguntan al usuario si no se encuentran en el repositorio o en el Issue. I13 es obligatorio como destino de la solicitud de juicio y aprobación, y no se avanza hasta recibir respuesta.

3.3 Confirmación del estado

Esta sección se realiza para respuesta urgente e inspección planificada. Se omite para la preparación permanente en tiempo de paz.

  • Confirmar que el parche está aplicado. Se asume que el skill se inicia con la rama del PR que contiene el parche o la corrección ya obtenida. Comparar la rama de origen con la rama actual para verificar que el parche esté aplicado.
    • Para actualizaciones de librerías, comparar los archivos de dependencias.
    • Para actualizaciones del entorno de ejecución, SO o middleware (alcance de confirmación 3), comparar también Dockerfile, la especificación del entorno de ejecución en el workflow (versiones como setup-java), archivos que especifican la versión del entorno de ejecución (.java-version, .python-version, .nvmrc, global.json, etc.).
    • Para correcciones de señalamientos de análisis de código estático, verificar que el archivo y la línea del señalamiento (I14) estén incluidos en la diferencia del PR.
    • Si no está aplicado, informar al usuario y detener el trabajo.
  • Código fuente corregido externamente. Verificar si la diferencia del PR incluye cambios en el código fuente de la aplicación. Si los incluye, registrar el archivo y la ubicación corregidos. Independientemente de la causa, añadirlos al objetivo de los tests (Directriz "2.4: Tests comunes a todos los alcances de confirmación").
  • Rama de origen. Determinar la rama de origen utilizada en "Capítulo 8: Ejecución y Comparación de Tests" y mostrarla al usuario. La rama de origen es la rama de destino de la fusión del PR. Si el workflow definido en otra directriz especifica una rama diferente como origen, ajustarse a ella.
  • Contradicciones en la información. Si la información proporcionada y el contenido del repositorio son inconsistentes (ej. la versión posterior a la actualización escrita en el Issue no coincide con el archivo lock), confirmar con el usuario.

3.4 Manejo de información faltante

Seguir la Directriz "Capítulo 7: Información a Recopilar Antes de Comenzar".

EscenarioManejo
Respuesta UrgenteHacer una lista de la información obligatoria faltante, mostrarla al usuario (líder del equipo de desarrollo) y esperar su decisión en el acto. No avanzar hasta recibir respuesta
Preparación Permanente en Tiempo de PazRegistrar la información faltante como riesgo residual en el informe
Inspección PlanificadaRegistrar la información faltante como riesgo residual en el informe y continuar con el trabajo

La información faltante y las decisiones tomadas se registran en el informe.

3.5 Registro

La información recopilada y su fuente (nombre de archivo del repositorio, número de Issue o PR, conversación, etc.) se registran al comienzo del informe de "Capítulo 9: Generación de Informe y Publicación en Issue".

4. Análisis de la Aplicación Objetivo

4.1 Lenguaje y herramientas de compilación

Determinar el lenguaje y las herramientas de compilación a partir de los archivos de dependencias.

ArchivoLenguaje / Herramienta de compilación
pom.xml / build.gradle*Java (Maven / Gradle)
pyproject.toml / requirements*.txt / poetry.lockPython
package.json / package-lock.json / tsconfig.jsonTypeScript
*.csproj / *.sln / packages.lock.jsonC#

4.2 Tipo de aplicación

Estimar el tipo de aplicación a partir del punto de entrada de inicio (framework web, definición de la función main o del job, framework de interfaz, etc.). Mostrar al usuario el tipo estimado seleccionado de entre las opciones, adjuntando la justificación, y solicitar confirmación. Si la estimación es incorrecta, el usuario puede volver a seleccionar.

  • Opciones: Backend, Procesamiento por lotes, Frontend web, Aplicación de escritorio (se pueden seleccionar múltiples si aplica).

4.3 Inventario de tests y CI actuales

  • Tests. Investigar el framework de test utilizado, el número y ubicación por tipo de test (unitario, integración, E2E, contrato, rendimiento), y el comando para ejecutar los tests.
  • CI. Leer .github/workflows/ para verificar si los tests se ejecutan en CI y si existe un mecanismo para ejecutar los mismos tests antes y después del parche y comparar los resultados (P7 de la Directriz "3.1.1: Niveles de Preparación"). Solo leer el workflow, no modificarlo.
  • Tests inestables. Verificar si existe una lista de tests inestables (patch-regression-reports/flaky-tests.md).
  • Destinos de conexión externa. Identificar las interacciones externas como BD, API, archivos, etc. Se utiliza para determinar el objetivo de los tests de contrato.

4.4 Diagnóstico del nivel de preparación

Para cada uno de los elementos P1 a P11 de la Directriz "3.1.1: Niveles de Preparación", determinar si corresponde a "Presente", "Ausente" o "Excluido registrando la razón", y resumirlo en una tabla con la justificación. Luego, determinar el nivel de preparación de la aplicación (L0 a L3).

La condición para el nivel de preparación es "que se ejecute en CI". Por lo tanto, la mera presencia de tests o escaneos en el repositorio no se considera "Presente". Se considera "Presente" solo después de verificar que realmente se ejecutan en el workflow leído en "4.3: Inventario de tests y CI actuales". Los elementos que están en el repositorio pero no se ejecutan en CI se consideran "Ausente (no ejecutado en CI)".

En la inspección planificada, si existe un informe de la preparación permanente en tiempo de paz o de la inspección planificada anterior en patch-regression-reports/, compararlo con el más reciente y registrar si el nivel de preparación ha disminuido. Si ha disminuido, registrar la necesidad de prepararlo como preparación permanente en tiempo de paz en "A cargo del equipo" de los riesgos residuales y la lista de deficiencias.

4.5 Lista de puntos de llamada

Crear una lista de los puntos en el código fuente de la aplicación donde se invocan librerías externas (P4 de la Directriz "3.1.1: Niveles de Preparación").

EscenarioObjetivo
Respuesta Urgente / Inspección PlanificadaLa librería a actualizar (incluyendo las dependencias indirectas que se actualizan conjuntamente si la aplicación las invoca directamente)
Preparación Permanente en Tiempo de PazTodas las librerías de las que se depende directamente
  • Si se encuentra código fuente corregido externamente en "3.3: Confirmación del estado", independientemente del escenario, añadir también la ubicación corregida y el proceso que la invoca al objetivo.
  • Para cada punto de llamada, verificar si existe un test que lo cubra. Leer el contenido del código de test para juzgar; si hay informes de cobertura, usarlos como ayuda.
  • La lista se guarda en patch-regression-reports/call-sites.md. Si ya existe, actualizar el contenido para que coincida con el código fuente actual.

4.6 Registro

Los resultados de "4.1: Lenguaje y herramientas de compilación" a "4.5: Lista de puntos de llamada" se registran en el informe de "Capítulo 9: Generación de Informe y Publicación en Issue".

5. Propuesta de Determinación del Alcance de Confirmación

Este capítulo se realiza para respuesta urgente e inspección planificada. La determinación final del alcance de confirmación la realiza el líder del equipo de desarrollo; este skill solo crea una propuesta.

5.1 Tipo de inspección (solo para inspección planificada)

A partir del Issue desencadenante y el PR, determinar el tipo según "3.5.1: Causa y tipo de inspección" de la Directriz (Actualización de dependencias, Corrección de vulnerabilidad, Corrección de código fuente). Si un solo PR contiene múltiples tipos, realizar lo siguiente para cada uno.

5.2 Procedimiento de determinación

  • Actualización de dependencias, corrección de vulnerabilidad y respuesta urgente. Seguir el diagrama de flujo del procedimiento de determinación de la Directriz "2.2: Procedimiento de determinación", mostrando la justificación para cada bifurcación. Para la justificación, utilizar las versiones antes y después de la actualización (I3), las notas de la versión, el historial de cambios y la guía de migración (I4), la diferencia del código fuente antes y después de la actualización (I5), y el árbol de dependencias (I6).
    • Si también cambian las versiones de las dependencias indirectas, considerar también las dependencias indirectas que cambian como objetivo de la actualización para la determinación, y ajustar al alcance de confirmación más grande (Directriz "2.3: Puntos a tener en cuenta en la determinación").
    • Los cambios de firma se verifican mediante el método de verificación por lenguaje de los Estándares Técnicos. Explicar el contenido del comando antes de ejecutarlo. Si la compilación implica la descarga de librerías de dependencias, obtener el permiso del usuario según lo indicado al comienzo de "Capítulo 8: Ejecución y Comparación de Tests".
  • Corrección de código fuente (inspección planificada). No se utiliza el alcance de confirmación. Hacer una lista de los puntos de corrección registrados en "3.3: Confirmación del estado" y los procesos que los invocan como objetivo de los tests. Registrar también si el señalamiento es de vulnerabilidad (se utiliza para determinar la necesidad de C5).

5.3 Cuando no se puede verificar el cambio

Para actualizaciones que abarcan múltiples versiones, etc., cuando no se puede verificar el cambio por versión mediante notas de la versión o diferencias, según lo indicado en "2.1.1: Cuando no se puede verificar el cambio" de la Directriz, determinar el alcance de confirmación según el incremento de versión. Escribir como justificación qué versión no se pudo verificar.

5.4 Elementos a incluir en el alcance de confirmación 3

En el alcance de confirmación 3, determinar qué elementos del alcance 2 de "2.5: Tests adicionales por alcance de confirmación" de la Directriz son aplicables, según el contenido de la actualización.

  • Para actualizaciones que no implican cambios en la API de la librería (ej. actualización de la imagen base del contenedor), "Análisis de la diferencia de comportamiento del lado de la librería" y "Lista de cambios disruptivos" no tienen objetivo. Se indica "No aplica (razón)".
  • Para actualizaciones que implican cambios en la API de la librería, como actualizaciones de una serie de frameworks, todos los elementos del alcance de confirmación 2 son objetivo.
  • Si la verificación del entorno para el alcance 3 (Directriz "3.3: Automatización CI de la verificación del entorno para el alcance de confirmación 3") no está integrada en la CI, se considera "A cargo del equipo" en la lista de deficiencias, y la propuesta de determinación se considera "Pendiente de decisión". Este skill NO debe crear este workflow de verificación del entorno.

5.5 Lista de cambios disruptivos (Alcances de confirmación 2 y 3)

Leer la guía de migración por cada versión major y crear una lista de cambios disruptivos. Las actualizaciones que abarcan dos o más versiones major se tratan como un solo PR; para poder aislar a qué cambio de versión se debe una diferencia cuando surja, la lista se escribe separada por versión. La lista se utiliza para "Capítulo 6: Identificación de Tests Faltantes" y para la clasificación de diferencias en "8.5: Manejo de diferencias". Si la guía de migración no está en la descripción del PR, solicitar al usuario que la proporcione.

5.6 Cotejo con el nivel de preparación (solo para respuesta urgente)

  • Basándose en el alcance de confirmación determinado y el nivel de preparación diagnosticado en "4.4: Diagnóstico del nivel de preparación", mostrar una estimación de si se puede completar la respuesta dentro del plazo (12 horas estimadas para la adición y ejecución de tests, 24 horas hasta el despliegue en staging). Si la preparación es insuficiente y es probable que no se pueda completar a tiempo, según la Directriz "3.1.1: Niveles de Preparación", indicar al usuario que se requiere la escalada del líder al subgerente o superior.
  • Para el alcance de confirmación 3, si la verificación del entorno no está integrada en la CI, según la Directriz "4.2: Cuando se maneja el alcance de confirmación 3 como respuesta urgente", indicar que se requiere escalada. La decisión sobre la detención del sistema o la superación del plazo no la toma este skill.

5.7 Determinación y registro

Mostrar al usuario (líder del equipo de desarrollo) el tipo de inspección, la propuesta de determinación del alcance de confirmación, los elementos a incluir en el alcance 3, la lista de cambios disruptivos y los puntos de corrección a incluir en los tests. No avanzar hasta que se determine. El contenido determinado, la razón de la determinación y la persona que lo determinó se registran en el informe de "Capítulo 9: Generación de Informe y Publicación en Issue".

6. Identificación de Tests Faltantes

6.1 Criterios de comparación

EscenarioCriterios
Respuesta Urgente / Inspección Planificada"2.4: Tests comunes a todos los alcances de confirmación" de la Directriz y los tests adicionales del alcance de confirmación determinado según "2.5: Tests adicionales por alcance de confirmación" de la Directriz (para el alcance 3, los elementos incluidos en "5.4: Elementos a incluir en el alcance de confirmación 3"). Si hay código fuente corregido externamente, incluir los tests de la ubicación corregida y los procesos que la invocan
Preparación Permanente en Tiempo de PazDe los P1 a P11 de "3.1.1: Niveles de Preparación" de la Directriz, los elementos hasta el nivel de preparación seleccionado por el usuario

Si los criterios no coinciden en un caso particular, en caso de duda, inclinarse hacia una verificación más amplia e informarlo al usuario.

En cualquier escenario, utilizar los V1 a V11 de la Directriz "Capítulo 5: Lista de Verificación de Puntos de Vista" como perspectivas al diseñar los tests. El método de verificación para cada punto de vista sigue los Estándares Técnicos...

Skills relacionados