Un outil de vérification d'API puissant qui détecte la dérive de spécification et prend en charge les tests de contrat bidirectionnels (Bi-Directional Contract Testing) en utilisant les spécifications OpenAPI.
Installer & Télécharger
1. ClawHub CLI
Le moyen le plus rapide d'installer une compétence directement depuis le registre.
npx clawhub@latest install drift-testing
2. Installation manuelle
Copiez le dossier de la compétence dans l'un de ces emplacements
~/.openclaw/skills/ <project>/skills/ Priorité : Espace de travail > Local > Intégré
3. Installation du prompt
Copiez ce prompt dans OpenClaw pour l'installer automatiquement.
Aide-moi à installer drift-testing via Clawhub. Si Clawhub n'est pas installé, installe-le d'abord (npm i -g clawhub).
Vous préférez télécharger ?
Obtenez les fichiers bruts de la compétence dans une archive ZIP.
Qu'est-ce que Drift Testing ?
La skill drift-testing est un ensemble d'outils complet pour Openclaw Skills conçu pour synchroniser les implémentations d'API avec leurs spécifications OpenAPI. Elle tire parti de la Drift CLI pour effectuer des tests de contrat bidirectionnels (BDCT), garantissant que l'implémentation de votre fournisseur reflète fidèlement le contrat documenté. Cette skill est essentielle pour les développeurs qui doivent maintenir la conformité de l'API, empêcher les changements destructeurs et automatiser la vérification des fournisseurs au sein des pipelines CI/CD.
Au-delà d'une simple validation, cette skill fournit un cycle de vie complet pour les tests d'API, y compris l'analyse de couverture, les boucles de rétroaction automatisées et le scripting basé sur Lua pour une gestion d'état complexe. Que vous testiez sur un environnement de production réel ou sur un serveur Prism mock local, cet utilitaire Openclaw Skills garantit que vos endpoints sont entièrement couverts et conformes aux normes que vous avez définies.
Cas d'utilisation de Drift Testing
- Vérifier qu'une implémentation d'API correspond à sa spécification OpenAPI pour éviter la dérive de spécification.
- Implémenter des tests de contrat bidirectionnels (BDCT) au sein d'un écosystème PactFlow.
- Générer automatiquement des squelettes et des scaffolds de test à partir d'un document OpenAPI existant.
- Assurer une couverture complète des endpoints en identifiant les cas de test manquants pour des codes de réponse spécifiques.
- Déboguer les échecs d'API à l'aide d'une boucle de réessai automatique qui s'exécute jusqu'à ce que tous les tests passent.
Comment fonctionne Drift Testing
- La skill analyse la spécification OpenAPI fournie pour identifier toutes les opérations, méthodes et codes de réponse disponibles.
- Les utilisateurs initialisent l'environnement en utilisant la commande drift init pour créer la structure de configuration, les jeux de données et les fichiers de hook.
- Les cas de test sont rédigés en YAML, mappant des opérations spécifiques à des codes d'état et des paramètres attendus.
- La Drift CLI exécute les tests par rapport à une URL de serveur cible ou un serveur mock local.
- Les scripts de couverture comparent les tests exécutés avec la spécification pour signaler les lacunes dans la vérification des endpoints ou des codes de réponse.
- Une boucle de rétroaction (run_loop.sh) peut être utilisée pour itérer sur les tests échoués et la couverture manquante jusqu'à ce que l'API soit entièrement vérifiée.
Configuration de Drift Testing
Vous pouvez utiliser la Drift CLI via npx ou l'installer localement pour votre projet.
# Utilisation via npx sans installation
npx @pactflow/drift --help
# Installation locale pour les équipes de développement
npm install --save-dev @pactflow/drift
# Initialiser un nouveau projet Drift
drift init
Schéma de données et taxonomie de Drift Testing
La skill organise sa configuration et ses données de test dans une structure de répertoire spécifique pour les utilisateurs d'Openclaw Skills :
| Fichier | Objet |
|---|---|
drift.yaml |
Fichier de configuration principal définissant les sources, les plugins et les paramètres d'authentification globaux. |
drift.lua |
Script Lua contenant des hooks de cycle de vie (ex : operation:started) et des fonctions auxiliaires. |
*.dataset.yaml |
Données de test externalisées et variables utilisées dans les expressions de test. |
*.tests.yaml |
La suite de tests principale contenant les cibles d'opération et les réponses attendues. |
Fonctionnalités avancées de Drift Testing
- Hooks de cycle de vie Lua : Programmez des comportements complexes pour
http:request,operation:startedetoperation:finishedafin de gérer l'état ou d'alimenter les données. - Tests de contrat bidirectionnels : Publiez les résultats sur PactFlow pour maintenir l'intégrité du contrat dans les systèmes distribués.
- Analyse de couverture automatisée : Utilisez des scripts Python intégrés pour comparer votre suite de tests avec la spécification OpenAPI pour une vérification à 100 %.
- Intégration avec Mock Server : Prise en charge intégrée des serveurs Prism mock pour tester la logique d'API sans backend actif.
- Exécution parallèle : Optimisez les temps d'exécution CI/CD en exécutant les suites de tests en parallèle à l'aide des flags natifs de la CLI.
SKILL.md
Chargement
Compétences Openclaw associées
LinkedIn Thread Engagement
Une couche d'engagement pilotée par IA qui surveille les fils de discussion LinkedIn pour détecter les réponses des auteurs et maximise l'élan de la conversation pendant la fenêtre de réponse critique.
SageOx Summary
Un skill d'agent AI qui synthétise les dernières 24 heures d'activité inter-équipes en résumés structurés, prêts pour Slack.
Tests de contrat PactFlow & Pact
Un assistant expert pour la gestion des tests de contrat PactFlow et Pact open-source, garantissant des déploiements sûrs grâce à des vérifications de compatibilité automatisées.
Star Wars API MCP Skill
Une interface compatible MCP pour interroger des données canoniques de l'univers Star Wars, incluant les films, personnages et vaisseaux spatiaux.
LinkedIn Post Audit
Un moteur heuristique de qualité professionnelle qui audite les brouillons LinkedIn pour éliminer les traces d'AI et maximiser la portée algorithmique.
Doc System Generator
Le Doc System Generator analyse les structures de projets logiciels pour dériver et générer automatiquement un système de documentation Markdown complet et de haute qualité basé sur une philosophie unique à trois voies.
En vedette*
