Compétences CI/CD
Ensemble de compétences pour résoudre les problèmes liés aux pipelines CI/CD.
Conditions de déclenchement
- « CI est tombé », « GitHub Actions a échoué »
- « Erreur de build », « Les tests ne passent pas »
- « Répare le pipeline »
Détails des fonctionnalités
| Fonctionnalité | Détail | Déclencheur |
|---|---|---|
| Analyse des échecs | Voir references/analyzing-failures.md | « Regarde les logs », « Trouve la cause » |
| Correction des tests | Voir references/fixing-tests.md | « Corrige les tests », « Propose une correction » |
Procédure d'exécution
- Jugement test vs implémentation (Étape 0)
- Classer l'intention de l'utilisateur (analyse ou correction)
- Évaluer la complexité (voir ci-dessous)
- Lire le fichier de référence approprié depuis les « Détails des fonctionnalités » ci-dessus, ou lancer le sous-agent ci-cd-fixer
- Vérifier le résultat et réexécuter si nécessaire
Étape 0 : Jugement test vs implémentation (Porte qualité)
Lors d'un échec CI, commencez par identifier la cause :
Rapport d'échec CI
↓
┌─────────────────────────────────────────┐
│ Jugement test vs implémentation │
├─────────────────────────────────────────┤
│ Analyser la cause de l'erreur : │
│ ├── Implémentation erronée → Corriger l'implémentation │
│ ├── Test obsolète → Demander confirmation à l'utilisateur │
│ └── Problème d'environnement → Corriger l'environnement │
└─────────────────────────────────────────┘
Interdictions (anti-falsification)
⚠️ Interdictions en cas d'échec CI
Les « solutions » suivantes sont interdites :
| Interdiction | Exemple | Bonne pratique |
|------|-----|-----------|
| Saut de test | `it.skip(...)` | Corriger l'implémentation |
| Suppression d'assertion | Supprimer `expect()` | Vérifier les valeurs attendues |
| Contournement CI | `continue-on-error` | Corriger la cause racine |
| Assouplissement des règles lint | `eslint-disable` | Corriger le code |
Flux de décision
🔴 Le CI a échoué
**Décision nécessaire** :
1. **L'implémentation est erronée** → Corriger l'implémentation ✅
2. **Les valeurs attendues du test sont obsolètes** → Demander confirmation à l'utilisateur
3. **Problème d'environnement** → Corriger la configuration de l'environnement
⚠️ La falsification des tests (saut, suppression d'assertion) est interdite
À quelle catégorie appartenez-vous ?
Cas nécessitant une approbation
Si la modification de test/configuration est inévitable :
## 🚨 Demande d'approbation de modification test/configuration
### Raison
[Pourquoi cette modification est nécessaire]
### Contenu de la modification
[Diff]
### Examen des alternatives
- [ ] A vérifié que la modification de l'implémentation ne peut pas résoudre le problème
Attendre l'approbation explicite de l'utilisateur
Utilisation des drapeaux étendus de git log (CC 2.1.49+)
Utilisez les logs structurés pour identifier le commit responsable de l'échec CI.
Identification du commit responsable
# Analyse des commits au format structuré
git log --format="%h|%s|%an|%ad" --date=short -10
# Analyse chronologique avec ordre topologique
git log --topo-order --oneline -20
# Association des fichiers modifiés et des causes
git log --raw --oneline -5
Principaux cas d'usage
| Usage | Drapeau | Effet |
|---|---|---|
| Identification de la cause | `--format="%h | %s"` |
| Suivi chronologique | --topo-order | Suivi en tenant compte de l'ordre de fusion |
| Compréhension de l'impact des modifications | --raw | Affichage détaillé des modifications de fichiers |
| Analyse hors fusion | --cherry-pick --no-merges | Extraction des seuls commits réels |
Exemple de sortie
🔍 Analyse de la cause de l'échec CI
Commits récents (structurés) :
| Hash | Sujet | Auteur | Date |
|------|---------|--------|------|
| a1b2c3d | feat: update API | Alice | 2026-02-04 |
| e4f5g6h | test: add tests | Bob | 2026-02-03 |
Fichiers modifiés (--raw) :
├── src/api/endpoint.ts (Modifié) ← Erreur de type survenue
├── tests/api.test.ts (Modifié)
└── package.json (Modifié)
→ Le commit a1b2c3d est probablement responsable
Erreur de type : src/api/endpoint.ts:42
Collaboration avec sous-agent
Lorsque les conditions suivantes sont remplies, lancez ci-cd-fixer avec l'outil Task :
- Correction → Réexécution → Échec en boucle 2 fois ou plus
- Ou, cas complexe impliquant plusieurs fichiers
Schéma de lancement :
Task tool :
subagent_type="ci-cd-fixer"
prompt="Diagnostiquez et corrigez l'échec CI. Log d'erreur : {error_log}"
ci-cd-fixer fonctionne en mode sécurisé (mode dry-run par défaut).
Voir agents/ci-cd-fixer.md pour plus de détails.
Pour VibeCoder
🔧 Comment parler quand le CI est cassé
1. **« Le CI est tombé », « Il est devenu rouge »**
- L'état où les tests automatisés échouent
2. **« Pourquoi ça échoue ? »**
- Demander de trouver la cause
3. **« Répare-le »**
- Essayer une correction automatique
💡 Important : les corrections qui « trichent » sur les tests sont interdites
- ❌ Supprimer ou sauter des tests
- ⭕ Corriger correctement le code
Si vous pensez que « le test a l'air faux »,
demandez confirmation avant de décider de l'action