node-ci
CI d'auteur dérivée du dépôt, qui échoue en cas de problème et est exempte de vulnérabilités de chaîne d'approvisionnement par construction. Les défauts que ce skill corrige : les modèles câblent en dur des versions Node qui dérivent de engines (ou sont en fin de vie), écrivent des contrôles agrégateurs qui passent lorsque des tâches sont sautées, utilisent corepack enable sur des exécuteurs où corepack n'est plus livré, et émettent des workflows avec des actions non épinglées et des permissions par défaut trop larges.
Quand NE PAS utiliser
- Workflows de publication/mise en production →
node-release. - Ce que les contrôles exécutent (règles de lint, configuration de test) →
node-lint/node-testing/node-typescript; ce skill les connecte. - Politique de dépendances/Dependabot →
node-supply-chain(mais chaque workflow émis par ce skill respecte ses règles d'épinglage et de permissions).
Workflow
- Dériver, ne pas câbler en dur : matrice issue de
package.json#enginesintersectée avec les lignes Node maintenues (vérifier LTS/EOL actuel par rapport au calendrier de publication nodejs.org — table versionnée dansreferences/ci-playbook.md). Ligne facultative Next-Current en tant qu'échec autorisé. - Gestionnaire de paquets depuis le lockfile : cache setup-node associé au bon lockfile ; pnpm via son action de configuration — ne pas compter sur corepack sur les exécuteurs actuels (non intégré aux nouvelles lignes Node ; vérifié dans le playbook).
- Structure : jobs lint / typecheck / test → un agrégateur fail-closed comme seul contrôle requis :
if: always()avec un test de résultat explicite qui échoue en cas d'echec, d'annulationet desaut(YAML exact dans le playbook — une chaîne naïveneedspasse en cas de saut). - Files d'attente de fusion : chaque workflow soutenant un contrôle requis déclare
merge_groupaux côtés depull_request, sinon la file d'attente reste bloquée silencieusement. - Hygiène par construction :
permissions: contents: readau niveau supérieur, élévation par job uniquement ; actions tierces épinglées par SHA avec commentaire de version (officiellesactions/*par tag majeur + Dependabot) ;concurrencyavec annulation des en-cours ;timeout-minutespartout. - La rapidité se mesure : lire d'abord les durées d'exécution ; puis mise en cache associée au lockfile, élagage de la matrice, fractionnement des suites — ne jamais supprimer les portes pour gagner en rapidité silencieusement.
- Vérifier :
puis pousser et confirmer que l'agrégateur devient rouge sur une tâche délibérément en échec (prouver le fail-closed une fois).python3 "${CLAUDE_SKILL_DIR}/scripts/check_workflows.py"
Spécifications de sortie
Workflows qui passent la validation de schéma et le script de vérification ; matrice documentée par rapport à engines ; un seul contrôle requis agrégateur prouvé comme échouant en cas de tâches en échec/annulées/sautées ; merge_group présent lorsque les files d'attente sont actives ; aucune action tierce non épinglée ; pas de permissions trop larges par défaut.
Pièges
- Les noms des contrôles requis doivent correspondre au contrôle rapporté (job
name:), pas aux noms de fichiers — les renommages rendent orphelines les règles de branche silencieusement. - Une tâche de matrice sautée par des filtres de chemin satisfait toujours les agrégateurs naïfs — le test de résultat du playbook est la solution.
cancel-in-progress: truesur les pushes versmainpeut annuler des exécutions proches du déploiement — limiter les groupes de concurrence aux réf délibérément.- Verrouiller par version la table LTS et les majeurs des actions de configuration ; revérifier au moment de la rédaction.
Fichiers
references/ci-playbook.md— matrices dérivées de engines, configuration cache/pnpm, YAML de l'agrégateur fail-closed, merge_group, filtrage monorepo, cache distant.scripts/check_workflows.py— audit statique des workflows (actions tierces non épinglées, permissions manquantes, versions Node en fin de vie, présence de l'agrégateur/merge_group) ; sortie non nulle en cas de violation.