Compétences GitLab pour Openclaw

Gérez les projets, les issues, les merge requests et les pipelines CI/CD GitLab à partir d’un seul outil en ligne de commande Python.

weiguang1017
v0.1.1
Oct 8, 2026
0
2.6k
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 gitlab-devops-skill

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 gitlab-devops-skill 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 Compétences GitLab ?

GitLab Skills permet à un agent de programmation IA d’interagir avec GitLab via GitLab REST API v4 et l’interface de ligne de commande fournie scripts/gitlab_cli.py. Utilisez-le pour rechercher et examiner des projets, répertorier ou créer des issues et des merge requests, fusionner les MR admissibles et examiner ou déclencher des pipelines CI/CD sur GitLab.com ou des instances autohébergées compatibles.

En tant que l’un des Openclaw Skills destinés aux flux de travail des développeurs, il renvoie les résultats des commandes au format JSON pour permettre une automatisation et une création de scripts fiables. Les identifiants sont lus depuis des variables d’environnement ou un fichier de configuration local facultatif ; les opérations d’écriture nécessitent la confirmation par l’utilisateur du projet et de la branche cibles avant leur exécution.

Cas d'utilisation de Compétences GitLab

  • Recherchez des projets par terme ou examinez un projet à l’aide de son ID numérique ou du chemin group/subgroup/project.
  • Consultez les issues ouvertes ou créez une issue pour suivre un bug ou une tâche.
  • Répertoriez les merge requests, ouvrez un MR d’une branche source vers une branche cible ou fusionnez un MR prêt.
  • Vérifiez l’activité d’un pipeline pour une branche ou une ref et déterminez s’il s’est terminé avec succès.
  • Déclenchez un pipeline sur une ref lorsque le projet possède un fichier .gitlab-ci.yml.
  • Automatisez des tâches GitLab.com ou GitLab autohébergé depuis un agent IA, un flux de travail de terminal ou un script.

Comment fonctionne Compétences GitLab

  1. Lisez l’URL de l’instance GitLab et le jeton API depuis les variables d’environnement GITLAB_URL et GITLAB_TOKEN, ou depuis ~/.devops-skills/gitlab.json.
  2. Exécutez scripts/gitlab_cli.py avec une commande prise en charge et un identifiant de projet. Utilisez un ID de projet numérique ou un chemin tel que group/subgroup/project.
  3. Avant d’émettre la commande, vérifiez la version de GitLab via /api/v4/version ; les instances antérieures à GitLab 9.0 sont rejetées, sauf si la vérification de version est explicitement ignorée.
  4. Envoyez l’opération demandée à GitLab REST API v4. Les opérations de lecture récupèrent des informations sur les projets, les issues, les MR ou les pipelines ; les opérations d’écriture créent des issues ou des MR, fusionnent des MR ou déclenchent des pipelines.
  5. Renvoyez le résultat au format JSON sur stdout. En cas d’échec, quittez avec un code différent de zéro. Les opérations de fusion et de pipeline sont soumises aux exigences GitLab relatives aux projets, aux branches, aux MR et à la configuration CI.

Configuration de Compétences GitLab

  1. Créez un jeton d’accès GitLab dans Paramètres utilisateur → Jetons d’accès et accordez-lui la portée api.
  2. Configurez l’URL et le jeton GitLab comme variables d’environnement ou utilisez le fichier de configuration facultatif ~/.devops-skills/gitlab.json. Ne placez pas le jeton directement dans les arguments de la ligne de commande.
  3. Utilisez un environnement Python dans lequel la dépendance requests est installée. La documentation de la skill recommande d’appeler la CLI avec le chemin absolu du Python fourni, lorsqu’il est disponible.
  4. Exécutez une commande CLI avec un ID ou un chemin de projet. Faites confirmer le projet et la branche cibles par l’utilisateur avant toute opération d’écriture.
export GITLAB_URL="https://gitlab.com"  # Pour GitLab autohébergé, utilisez l’URL de son instance
export GITLAB_TOKEN="<access-token>"    # La portée api est requise

PY="$HOME/.workbuddy/binaries/python/envs/default/bin/python"

# Si requests est absent, installez-le dans le même environnement Python :
"$PY" -m pip install requests

"$PY" scripts/gitlab_cli.py list-projects --search app
"$PY" scripts/gitlab_cli.py get-project group/app
"$PY" scripts/gitlab_cli.py list-issues group/app --state opened
"$PY" scripts/gitlab_cli.py create-issue group/app --title "Bug" --description "..."
"$PY" scripts/gitlab_cli.py list-mrs group/app --state opened
"$PY" scripts/gitlab_cli.py create-mr group/app --source feat --target main --title "Add feature"
"$PY" scripts/gitlab_cli.py merge-mr group/app 42
"$PY" scripts/gitlab_cli.py list-pipelines group/app --ref main
"$PY" scripts/gitlab_cli.py trigger-pipeline group/app --ref main

La CLI prend en charge GitLab.com et les instances GitLab autohébergées en version 9.0+ via REST API v4. Pour en savoir plus sur la configuration, les champs et le dépannage, consultez references/USAGE.md.

Schéma de données et taxonomie de Compétences GitLab

La skill utilise les ressources de l’API GitLab et ne documente ni base de données locale ni fichiers de projet générés. Les réponses de la CLI sont écrites au format JSON sur stdout ; les échecs sont signalés par un code de sortie différent de zéro.

Ressource ou fichier Rôle
scripts/gitlab_cli.py CLI Python fournie pour les opérations sur les projets, les issues, les MR et les pipelines.
~/.devops-skills/gitlab.json Fichier de configuration local facultatif pour les paramètres de connexion GitLab.
references/USAGE.md Documentation détaillée sur la configuration, les champs et le dépannage.
Projet GitLab La cible est identifiée par un ID numérique ou un chemin group/subgroup/project encodé pour les URL.
Issues Répertoriées ou créées pour un projet ; la création accepte un titre et une description.
Merge requests Répertoriées, créées à partir de branches source et cible, ou fusionnées par numéro de MR lorsqu’elles sont admissibles.
Pipelines Répertoriés par projet et ref, ou déclenchés pour une ref lorsque le projet contient .gitlab-ci.yml.

Les métadonnées de connexion comprennent l’URL de l’instance GitLab et le jeton d’accès. Conservez le jeton dans l’environnement ou la configuration locale plutôt que de le transmettre comme argument CLI.

Fonctionnalités avancées de Compétences GitLab

  • Prend en charge GitLab.com et les instances GitLab autohébergées en version 9.0+ via REST API v4 ; les chemins des projets sont encodés par la CLI.
  • Vérifie la version de GitLab avant d’exécuter des commandes. Définissez GITLAB_SKIP_VERSION_CHECK=1 ou DEVOPS_SKILLS_SKIP_VERSION_CHECK=1 pour ignorer la vérification si nécessaire.
  • Émet du JSON sur stdout et utilise des codes de sortie différents de zéro en cas d’échec, ce qui rend les résultats adaptés à l’automatisation en aval.
  • Couvre les flux de lecture et d’écriture pour les projets, les issues, les merge requests et les pipelines CI/CD.
  • Les opérations d’écriture — création d’issues ou de MR, fusion de MR et déclenchement de pipelines — nécessitent la confirmation par l’utilisateur du projet et de la branche cibles. Un MR doit être fusionnable et le déclenchement d’un pipeline nécessite un fichier .gitlab-ci.yml.

SKILL.md


Chargement

Compétences Openclaw associées

METADATA

Github Stars: 0
forks: 0

En vedette*