Workflow de modifications d'infrastructure

VérifiéSûr

Workflow sécurisé pour modifier l'infra : vérifications préalables, création d'une branche, commits groupés par logique et push.

Spar Skills Guide Bot
DevOpsIntermédiaire
21/09/2026
Claude Code
#git-workflow#infrastructure#ci-cd#branching#commits

Recommandé pour

Synthèse automatique

Encadre les modifications d’infrastructure en imposant une branche main propre, la création d’une branche infra/, des commits regroupés par logique et le push de la branche.

Points forts

  • Effectue des vérifications préalables avant toute modification : arbre de travail propre, présence sur main et pull de origin/main.
  • Crée automatiquement une branche descriptive préfixée infra/ à partir de la demande.
  • Organise les changements en commits distincts par domaine : CI/CD, Dockerfiles, compose/Traefik ou couches dépendantes.
  • Termine par le push de la branche et un rapport incluant le nom de branche et les SHA des commits.

Limites

  • Suppose que la branche principale s’appelle main et que origin/main est disponible.
  • S’arrête si l’arbre de travail contient des modifications non commitées ou si la branche courante n’est pas main.
  • Ne couvre ni les tests, ni le rollback, ni la résolution de conflits, et délègue l’ouverture de la pull request à /pr.
Quand l'utiliser

Utilisez cette compétence pour préparer proprement une modification d’infrastructure versionnée, comme un workflow CI/CD, un Dockerfile, un fichier compose ou une configuration Traefik.

Quand l'éviter

Évitez-la lorsque vous devez travailler directement sur une branche non main ou lorsque l’arbre de travail ne peut pas être nettoyé, car la compétence s’arrêtera avant d’appliquer les changements.

Analyse de sécurité

Sûr
Score qualité90/100

The skill instructs standard, legitimate git workflow commands (status, branch, checkout, add, commit, push) and explicitly includes pre-flight checks to avoid overwriting or mixing changes. No destructive, exfiltration, or obfuscated actions are present.

Aucun point d'attention détecté

Comment cette analyse est faite

Exemples

Split CI deploy workflow
/infra split the GitHub Actions deploy workflow into separate build and deploy jobs
Enable Traefik TLS
/infra update the Traefik configuration to enable TLS and adjust the docker-compose labels
Add migration Dockerfile stage
/infra add a production Dockerfile stage for migrations and wire it into docker-compose

name: infra description: "Make infrastructure changes safely: create a branch first, apply changes in logically grouped commits, and push. Use when modifying docker-compose files, CI/CD workflows, Traefik config, Dockerfiles, or any file under infra/ or .github/workflows/." argument-hint: "<change description> — describe the infrastructure change to make"

Infra Changes Workflow

Before touching any files, set up a branch. Then apply changes in logical batches, each with its own commit. Finally push.

Change requested: $ARGUMENTS

Step 0 — Pre-flight checks

Run the following checks before doing anything else. If any check fails, stop and inform the user — do not proceed.

  1. Check for uncommitted or unstaged changes:

    git status --porcelain
    

    If the output is non-empty, cancel with:

    "There are uncommitted or unstaged changes in the working tree. Please commit, stash, or discard them before proceeding with infra changes."

  2. Ensure you are on main:

    git branch --show-current
    

    If the current branch is not main, cancel with:

    "You are currently on branch <branch>, not main. Please switch to main before starting infra changes."

  3. Pull the latest main:

    git pull origin main
    

    Confirm the pull succeeded before continuing.

Step 1 — Create a branch

Derive a short, descriptive branch name from the user's request using the prefix infra/ (e.g. infra/split-deploy-jobs, infra/traefik-ssl-config).

Run:

git checkout -b <branch-name>

Confirm the branch was created before proceeding.

Step 2 — Apply changes in logical batches

Group the planned changes by concern. Each group becomes one commit. Typical groupings for this repo:

  • CI/CD — files under .github/workflows/
  • Container config — Dockerfile, Dockerfile.prod, Dockerfile.migrate
  • Compose / infra — files under infra/ (docker-compose files, traefik config)
  • Mixed — if a change spans groups, split by layer (e.g. compose changes first, then workflow changes that depend on them)

For each batch:

  1. Make the file edits.
  2. Stage only the files for that batch: git add <files>
  3. Commit with a concise imperative message: git commit -m "<what and why>"

Do not mix unrelated files in a single commit.

Step 3 — Push the branch

git push -u origin <branch-name>

Step 4 — Done

Report to the user:

  • Branch name
  • Commit SHA(s) (from git log --oneline origin/main..HEAD)

Run /pr to open the pull request when ready.

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/infrastructure-change-workflow-muar2zxq/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/infrastructure-change-workflow-muar2zxq' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/infrastructure-change-workflow-muar2zxq/download' --output '.skill-downloads/infrastructure-change-workflow-muar2zxq/SKILL.md.part' && mv '.skill-downloads/infrastructure-change-workflow-muar2zxq/SKILL.md.part' '.skill-downloads/infrastructure-change-workflow-muar2zxq/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/infrastructure-change-workflow-muar2zxq/SKILL.md' && test -s '.skill-downloads/infrastructure-change-workflow-muar2zxq/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/infra' && cp -R '.skill-downloads/infrastructure-change-workflow-muar2zxq' '.claude/skills/infra'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/infrastructure-change-workflow-muar2zxq'

openskills read 'infrastructure-change-workflow-muar2zxq'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/infrastructure-change-workflow-muar2zxq/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires