Integración de CI

La historia de CI más segura no es complicada. Es simplemente estricto con el contrato público.

La puerta CI mínima

Para la mayoría de los proyectos escritos, esta es la línea de base:

plugin-kit-ai doctor .
plugin-kit-ai generate .
plugin-kit-ai validate . --platform <target> --strict

Si su carril tiene pruebas de humo estable o controles de paquetes, agréguelos después de la puerta de validación en lugar de reemplazarlos.

Por qué funciona esto

• doctor detecta anticipadamente los requisitos previos de tiempo de ejecución que faltan
• generate demuestra que los resultados generados se pueden reproducir desde el estado de autor
• validate --strict demuestra que el repositorio es internamente coherente para el objetivo elegido
• para un repositorio de múltiples objetivos, la misma lógica debe aplicarse para cada objetivo en el alcance de soporte

Notas específicas del tiempo de ejecución

Go

Go es la ruta de CI más limpia porque la máquina de ejecución no necesita Python o Node solo para satisfacer el carril de tiempo de ejecución.

Node/TypeScript

Agregue bootstrap explícitamente:

plugin-kit-ai doctor .
plugin-kit-ai bootstrap .
plugin-kit-ai generate .
plugin-kit-ai validate . --platform codex-runtime --strict

Python

Utilice el mismo patrón que Node y haga explícita la versión Python en CI.

Errores comunes de CI

• ejecutando validate --strict sin generate
• tratar los artefactos generados como archivos mantenidos manualmente
• olvidar los requisitos previos de tiempo de ejecución para los carriles Node o Python
• compatibilidad prometedora para un objetivo que está fuera del límite de soporte estable

Regla recomendada

Si CI no puede reproducir los resultados creados y pasar validate --strict, el repositorio no está listo para una transferencia estable. Para un repositorio de múltiples objetivos, eso significa una ejecución verde explícita para cada objetivo dentro del alcance del soporte.

Empareje esta página con Preparación para la producción, Límite de soporte y Solución de problemas.