CommunityRédaction et éditiongithub.com

Paldom/node-skills

Compétences pour agents permettant de maintenir des applications et packages open-source Node.js, TypeScript, Next.js et React de haute qualité : linting, sécurité des types, tests, empaquetage, publication et contrôles de qualité CI.

Qu'est-ce que node-skills ?

Ce skill est conçu pour les agents d'IA (comme Claude Code, Cursor ou Codex) afin de gérer et maintenir des projets Node.js, TypeScript, Next.js et React de haute qualité. Il automatise la configuration des workflows CI, le linting, la sécurité des types, les tests, l'empaquetage et les procédures de publication, en s'assurant que les pipelines sont robustes, sécurisés et conformes aux bonnes pratiques. Il repose sur une approche "derive, don't hardcode" pour extraire les versions de Node à partir du fichier `package.json#engines`, utilise le gestionnaire de paquets détecté dans le lockfile, et met en place un agrégateur "fail-closed" obligatoire pour éviter les validations silencieuses. Le skill vérifie également que les workflows respectent les règles de sécurité (permissions minimales, actions SHA-pinnées) et qu'ils supportent les files d'attente de fusion (merge queues). Il inclut un script de vérification statique `check_workflows.py` et un playbook de référence `ci-playbook.md` pour garantir la conformité.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add Paldom/node-skills

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

  1. Dériver, ne pas câbler en dur : matrice issue de package.json#engines intersectée avec les lignes Node maintenues (vérifier LTS/EOL actuel par rapport au calendrier de publication nodejs.org — table versionnée dans references/ci-playbook.md). Ligne facultative Next-Current en tant qu'échec autorisé.
  2. 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).
  3. 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'annulation et de saut (YAML exact dans le playbook — une chaîne naïve needs passe en cas de saut).
  4. Files d'attente de fusion : chaque workflow soutenant un contrôle requis déclare merge_group aux côtés de pull_request, sinon la file d'attente reste bloquée silencieusement.
  5. Hygiène par construction : permissions: contents: read au niveau supérieur, élévation par job uniquement ; actions tierces épinglées par SHA avec commentaire de version (officielles actions/* par tag majeur + Dependabot) ; concurrency avec annulation des en-cours ; timeout-minutes partout.
  6. 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.
  7. Vérifier :
    python3 "${CLAUDE_SKILL_DIR}/scripts/check_workflows.py"
    
    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).

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: true sur les pushes vers main peut 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.

Skills associés