Una potente herramienta de verificación de API que detecta la deriva de especificación y admite pruebas de contrato bidireccionales (Bi-Directional Contract Testing) utilizando especificaciones OpenAPI.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install drift-testing
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <project>/skills/ Prioridad: Espacio de trabajo > Local > Integrado
3. Instalación del prompt
Copia este prompt en OpenClaw para instalarlo automáticamente.
Ayúdame a instalar drift-testing usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).
¿Prefieres descargar?
Obtén los archivos originales de la habilidad en un archivo ZIP.
¿Qué es Drift Testing?
La skill drift-testing es un conjunto de herramientas integral para Openclaw Skills diseñado para sincronizar las implementaciones de API con sus especificaciones OpenAPI. Aprovecha la Drift CLI para realizar pruebas de contrato bidireccionales (BDCT), garantizando que la implementación de su proveedor refleje con precisión el contrato documentado. Esta skill es fundamental para los desarrolladores que necesitan mantener la conformidad de la API, prevenir cambios disruptivos y automatizar la verificación del proveedor en pipelines de CI/CD.
Más allá de la validación simple, esta skill proporciona un ciclo de vida completo para pruebas de API, incluyendo análisis de cobertura, bucles de feedback automatizados y scripting basado en Lua para la gestión compleja de estados. Ya sea que esté probando en un entorno de producción real o en un servidor Prism mock local, esta utilidad de Openclaw Skills garantiza que sus endpoints estén totalmente cubiertos y cumplan con sus estándares definidos.
Casos de uso de Drift Testing
- Verificar que una implementación de API coincida con su especificación OpenAPI para evitar la deriva de especificación.
- Implementar pruebas de contrato bidireccionales (BDCT) dentro de un ecosistema PactFlow.
- Generar automáticamente esqueletos y scaffolds de prueba a partir de un documento OpenAPI existente.
- Garantizar una cobertura completa de endpoints identificando casos de prueba faltantes para códigos de respuesta específicos.
- Depurar fallos de API utilizando un bucle de reintento automático que se ejecuta hasta que todas las pruebas pasen.
Cómo funciona Drift Testing
- La skill analiza la especificación OpenAPI proporcionada para identificar todas las operaciones, métodos y códigos de respuesta disponibles.
- Los usuarios inicializan el entorno utilizando el comando drift init para crear la estructura de configuración, conjuntos de datos y archivos de hook.
- Los casos de prueba se redactan en YAML, mapeando operaciones específicas a códigos de estado y parámetros esperados.
- La Drift CLI ejecuta las pruebas contra una URL de servidor objetivo o un servidor mock local.
- Los scripts de cobertura comparan las pruebas ejecutadas contra la especificación para informar brechas en la verificación de endpoints o códigos de respuesta.
- Se puede usar un bucle de feedback (run_loop.sh) para iterar en pruebas fallidas y cobertura faltante hasta que la API esté totalmente verificada.
Configuración de Drift Testing
Puede usar la Drift CLI mediante npx o instalarla localmente para su proyecto.
# Usar mediante npx sin instalación
npx @pactflow/drift --help
# Instalación local para equipos de desarrollo
npm install --save-dev @pactflow/drift
# Inicializar un nuevo proyecto Drift
drift init
Esquema de datos y taxonomía de Drift Testing
La skill organiza su configuración y datos de prueba en una estructura de directorio específica para usuarios de Openclaw Skills:
| Archivo | Propósito |
|---|---|
drift.yaml |
Archivo de configuración principal que define fuentes, plugins y configuraciones de autenticación global. |
drift.lua |
Script Lua que contiene hooks de ciclo de vida (ej: operation:started) y funciones auxiliares. |
*.dataset.yaml |
Datos de prueba externalizados y variables utilizadas en expresiones de prueba. |
*.tests.yaml |
La suite de pruebas principal que contiene objetivos de operación y respuestas esperadas. |
Funciones avanzadas de Drift Testing
- Hooks de ciclo de vida Lua: Programe comportamientos complejos para
http:request,operation:startedyoperation:finishedpara gestionar el estado o popular datos. - Pruebas de contrato bidireccionales: Publique resultados en PactFlow para mantener la integridad del contrato en sistemas distribuidos.
- Análisis de cobertura automatizado: Utilice scripts de Python integrados para comparar su suite de pruebas contra la especificación OpenAPI para una verificación del 100%.
- Integración con Mock Server: Soporte integrado para servidores Prism mock para probar la lógica de API sin un backend activo.
- Ejecución paralela: Optimice los tiempos de ejecución de CI/CD ejecutando suites de prueba en paralelo utilizando flags nativos de la CLI.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
LinkedIn Thread Engagement
Una capa de compromiso impulsada por IA que monitorea los hilos de LinkedIn en busca de respuestas del autor y maximiza el impulso de la conversación durante la ventana de respuesta crítica.
SageOx Summary
Una skill de agente AI que sintetiza las últimas 24 horas de actividad entre equipos en resúmenes estructurados y listos para Slack.
Pruebas de Contrato PactFlow & Pact
Un asistente experto para gestionar pruebas de contrato de PactFlow y Pact open-source, asegurando despliegues seguros mediante comprobaciones de compatibilidad automatizadas.
Star Wars API MCP Skill
Una interfaz compatible con MCP para consultar datos canónicos del universo de Star Wars, incluyendo películas, personajes y naves espaciales.
LinkedIn Post Audit
Un motor heurístico de nivel profesional que audita borradores de LinkedIn para eliminar rastros de AI y maximizar el alcance algorítmico.
Doc System Generator
El Doc System Generator analiza las estructuras de proyectos de software para derivar y generar automáticamente un sistema de documentación Markdown completo y de alta calidad basado en una filosofía única de tres vías.
Presentado*
