Migration Validator pour Openclaw

Un outil de base de données qui scanne et valide automatiquement les migrations SQL en attente avant leur exécution afin d'éviter les échecs de pipeline.

ink5725
v1.0.0
Jun 2, 2026
0
562
0

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 migration-validator

2. Installation manuelle

Copiez le dossier de la compétence dans l'un de ces emplacements

Global
~/.openclaw/skills/
Espace de travail
<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 migration-validator 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 Migration Validator ?

Le Migration Validator est un utilitaire essentiel conçu pour scanner les répertoires de migration à la recherche de fichiers de migration de base de données SQL en attente et garantir leur correction syntaxique avant le déploiement. En exécutant des algorithmes de validation et en analysant les scripts de migration, il fonctionne comme une protection critique dans les cycles modernes de publication de logiciels.

L'intégration de cet outil via Openclaw Skills permet une protection automatisée des schémas, permettant aux développeurs d'éliminer les erreurs d'exécution de base de données dues à des fautes de frappe syntaxiques ou à des incohérences structurelles. Il gère et consigne les états d'exécution des migrations, en identifiant quelles migrations sont en attente ou déjà terminées.

Cas d'utilisation de Migration Validator

  • Contrôle de déploiement : Détectez les problèmes de syntaxe et les erreurs de structure dans les scripts de migration SQL avant l'exécution.
  • Intégration CI/CD : Validez automatiquement les fichiers SQL dans les pull requests ou les pipelines de déploiement comme étape de blocage préalable.
  • Alignement inter-environnements : Confirmez que les scripts de migration sont compatibles et valides dans les environnements de développement, de staging et de production.

Comment fonctionne Migration Validator

  1. Découverte de répertoire : Le skill scanne le répertoire de migration désigné (par ex. migrations/) pour identifier tous les fichiers SQL candidats.
  2. Validation de syntaxe : Chaque fichier SQL est analysé et validé à l'aide de moteurs de syntaxe spécialisés (par ex. validation d'instructions SQLite PRAGMA ou un parser SQL natif).
  3. Suivi d'état : L'outil catalogue les fichiers de migration en attente par rapport aux migrations déjà exécutées pour déterminer l'état différentiel de la base de données.
  4. Sortie de rapport : Un rapport de validation JSON structuré est généré, contenant le statut d'exécution, les erreurs et les migrations identifiées.

Configuration de Migration Validator

Pour tirer parti de cet utilitaire de migration au sein de la suite Openclaw Skills, configurez l'espace de travail de votre projet et exécutez le script de validation comme indiqué ci-dessous :

# Naviguez vers le répertoire de votre projet contenant les migrations
cd /path/to/your/project

# Exécutez le script de validation
python scripts/validate.py

Assurez-vous que vos pilotes de base de données et vos dépendances python sont configurés dans votre environnement virtuel.

Schéma de données et taxonomie de Migration Validator

L'outil évalue les structures de migration SQL et génère un rapport de validation conforme au schéma en JSON. Voici la structure de sortie des métadonnées de validation :

Propriété Type Description
validation_timestamp String Horodatage ISO 8601 de l'exécution de la validation
migrations_found Array Liste des noms de fichiers SQL découverts dans le dossier
pending_migrations Array Fichiers SQL qui n'ont pas encore été appliqués à la base de données cible
validation_errors Array Erreurs détaillées analysées lors de la vérification de la syntaxe
status String Statut général de la validation (par ex. completed, failed)

Exemple de sortie :

{
  "validation_timestamp": "2026-06-01T12:00:00",
  "migrations_found": ["001_initial.sql", "002_create_orders.sql"],
  "pending_migrations": [],
  "validation_errors": [],
  "status": "completed"
}

Fonctionnalités avancées de Migration Validator

  • Validation Dry-Run : Exécutez l'analyse de schéma sans modifier les états actifs de la base de données.
  • Moteurs d'analyse configurables : Choisissez des vérifications de validation spécifiques au dialecte, adaptées aux schémas SQLite, PostgreSQL ou MySQL.
  • Automatisation Openclaw Skills : Connectez facilement le migration-validator avec des pipelines d'orchestration multi-agents pour des rollbacks automatisés et des hooks pre-commit.

SKILL.md


Chargement

Compétences Openclaw associées

METADATA

Github Stars: 0
forks: 0

En vedette*