| name | ci-debug |
| description | Debug GitHub Actions CI pipeline failures. Analyse les logs de workflow, identifie la cause racine et propose un fix. |
| disable-model-invocation | true |
| context | fork |
| agent | general-purpose |
| allowed-tools | Bash, Read, Grep, Glob |
| argument-hint | [PR-number ou workflow-run-url] |
CI Debug — Analyse des echecs CI
Contexte dynamique
- Checks PR en cours: !
gh pr checks 2>/dev/null | head -20
- Workflows recents: !
gh run list --limit 5 --json name,status,conclusion,headBranch --template '{{range .}}{{.name}} | {{.status}} | {{.conclusion}} | {{.headBranch}}{{"\n"}}{{end}}' 2>/dev/null
Instructions
Analyser l'echec CI pour: $ARGUMENTS
Step 1: Identifier le workflow en echec
Si c'est un numero de PR:
gh pr checks $0
gh run list --branch $(gh pr view $0 --json headRefName -q .headRefName) --limit 3
Si c'est une URL de workflow run:
gh run view $0 --log-failed
Step 2: Extraire les logs d'erreur
gh run view <run-id> --log-failed 2>&1 | head -100
Chercher les patterns:
error, Error, ERRORFAIL, FAILEDexit code 1, exit code 2denied, forbidden, unauthorized
Step 3: Diagnostiquer
Causes frequentes dans STOA CI:
| Pipeline | Erreur frequente | Cause | Fix |
|---|
| Python CI | I001 import order | isort non respecte | ruff check --fix |
| Python CI | mypy type error | Type hints manquants | Ajouter les annotations |
| Node CI | vitest fail | Mock MSW manquant | Ajouter handler MSW |
| Node CI | eslint warnings | Max warnings depassé (0 pour UI, 20 pour portal) | Fixer les warnings |
| Docker | buildx fail | Cache layer miss ou multi-arch | Verifier --platform linux/amd64,linux/arm64 |
| Helm | helm lint fail | Values manquantes, indentation | Verifier values.yaml |
| Security | dependency-review | GitHub Advanced Security non active | Connu, non-bloquant |
| K8s deploy | kubectl apply fail | Selector immutable, Kyverno block | Voir .claude/docs/k8s-deploy.md |
| K8s deploy | rollout timeout | maxSurge/maxUnavailable deadlock | maxUnavailable: 1, maxSurge: 0 |
Step 4: Proposer le fix
Pour chaque erreur identifiee:
- Fichier exact a modifier (chemin complet)
- Diff propose (old → new)
- Commande de verification locale
- Impact sur les autres workflows
Step 5: Rapport
## CI Debug: [workflow-name] — [branch]
### Echec
- **Job**: [nom du job]
- **Step**: [nom du step]
- **Erreur**: [message d'erreur exact]
### Cause racine
[Explication]
### Fix propose
[Diff exact]
### Verification locale
```bash
[commande pour reproduire/verifier]
Impact
[Autres workflows potentiellement impactes]
## Regles
- Toujours lire les logs complets avant de diagnostiquer
- Ne pas confondre: erreur intermittente vs erreur structurelle
- Si `dependency-review` echoue seul → ignorer (connu, GitHub Advanced Security)
- Si `container-scan` / `codeql` echoue seul → verifier si intermittent
- Toujours proposer une verification locale
