Communitygithub.com

AdarGit008/baseline-skill

La compétence /baseline pour Claude Code — un vérificateur de préparation de projet sans dépendance (69 règles). Installez-la dans ~/.claude/skills/baseline.

Qu'est-ce que baseline-skill ?

Cette compétence pour Claude Code met en œuvre un standard de vérification de projet reproductible : 69 règles, chacune soutenue par une vérification exécutée par un script Node sans dépendance sur un dépôt *au repos*. Les blocages font échouer l'intégration continue (sortie 1) ; les décisions qu'un script ne peut pas prendre sont résolues via un registre de validation daté. L'objectif principal est de remplacer les promesses écrites par des vérifications automatisées. La compétence fournit un exécuteur, un fichier de règles, un exemple de configuration et des modèles pour initier un projet, corriger les échecs ou expliquer les règles. Elle prend en charge plusieurs modes : score (par défaut), init, fix et explain. Elle est conçue pour fonctionner avec Claude Code, mais son adaptabilité permet de l'utiliser sur n'importe quel dépôt Git local avec Node ≥ 18. Le runner est résilient aux crashs et ne nécessite aucune dépendance externe. L'utilisateur peut invoquer la compétence via des commandes comme « run baseline », « /baseline » ou « check this repo ». La compétence détermine l'intention, cible le bon dépôt, exécute les vérifications appropriées et présente les résultats de manière claire, en regroupant les blocages et les avertissements par catégorie.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add AdarGit008/baseline-skill

Demander à votre IA préférée

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

Documentation

project-baseline

Un standard de vérification reproductible : 69 règles, chacune appuyée par une vérification qu'un exécuteur Node sans dépendance exécute sur un dépôt au repos. Les blocages font échouer l'intégration continue (sortie 1) ; les décisions qu'un script ne peut pas prendre sont résolues via un registre de validation daté. L'objectif principal : ne faites pas confiance à une promesse écrite — faites en sorte que quelque chose la vérifie.

La boîte à outils se trouve à côté de ce fichier : check.mjs (exécuteur), rules.json (les 69 règles), config.example.json, templates/, README.md (guide de démarrage), REFERENCE.md (référence complète : tableau des règles, catégories, schémas d'architecture, câblage CI) et GLOSSARY.md (définitions en langage clair des termes DevOps/chaîne d'approvisionnement).

Résolvez d'abord le répertoire de la compétence. $SKILL_DIR ci-dessous signifie le chemin absolu du répertoire qui contient ce SKILL.md — résolvez-le en un chemin concret avant d'exécuter une commande (ne passez pas la chaîne littérale $SKILL_DIR au shell). Il s'agit généralement de ~/.claude/skills/baseline. check.mjs charge rules.json depuis son propre répertoire, donc les deux doivent rester colocalisés ; invoquez toujours l'exécuteur par son chemin absolu (node "<abs>/check.mjs" …) plutôt que de le copier ailleurs. L'exécuteur a seulement besoin de Node ≥ 18 et git ; si node est manquant, dites-le à l'utilisateur plutôt que de deviner.

Quand elle est invoquée

Déterminez l'intention à partir des mots de l'utilisateur et choisissez un mode. Par défaut, utilisez score si non spécifié.

Mode : score (par défaut) — « exécuter baseline », « /baseline », « vérifier ce dépôt »

  1. Choisissez le dépôt cible : un chemin explicite dans la demande, sinon le répertoire de travail actuel. Confirmez qu'il ressemble à un dépôt (a un manifeste ou .git).
  2. Exécutez l'exécuteur (lisible par l'humain) :
    node "$SKILL_DIR/check.mjs" --repo <cible>
    
    • Ajoutez --no-exec si vous ne devez PAS exécuter la commande d'amorçage/test du dépôt (BUILD-05) — par exemple dépôt non fiable, pas le temps d'exécuter les tests, ou la commande n'est pas configurée. Privilégiez son exécution lorsque c'est sûr, car BUILD-05 est la vérification reine.
    • Ajoutez --profile advanced si l'utilisateur souhaite les règles expertes (SBOM, analyse de code, tests de mutation, intégrité des symboles, analyse des vulnérabilités des dépendances, seuil de couverture). Le profil service s'active automatiquement pour project_type=service.
    • Ajoutez --json lorsque vous souhaitez analyser les résultats par programme plutôt que d'afficher le tableau de bord.
  3. Présentez le résultat à l'utilisateur, en commençant par les blocages (ceux-ci font échouer l'IC), puis les avertissements méritant d'être corrigés. Regroupez par catégorie. Ne déversez pas les 69 lignes — résumez : % de préparation, nombre de blocages, et les ÉCHECs/avertissements notables spécifiques avec leur détail d'une ligne. Proposez de corriger ou d'échafauder.

Mode : init — « configurer baseline ici », « adopter le standard », « échafauder baseline »

  1. Copiez la boîte à outils dans le dépôt (suggérez tools/baseline/), ou référencez-la sur place.
  2. Échafaudez les artefacts, seulement s'ils sont manquants (ne jamais écraser sans demander) :
    cp "$SKILL_DIR/config.example.json" <dépôt>/baseline.config.json
    cp "$SKILL_DIR/templates/CLAIMS.json"   <dépôt>/docs/CLAIMS.json      # seulement si le dépôt fait des revendications externes
    cp "$SKILL_DIR/templates/start-here.md" <dépôt>/docs/start-here.md    # si aucun document d'état n'existe
    mkdir -p <dépôt>/.project-baseline && cp "$SKILL_DIR/templates/signoff.json" <dépôt>/.project-baseline/signoff.json
    
  3. Modifiez baseline.config.json en fonction de la réalité du dépôt : définissez project_type, bootstrap_command (la commande d'installation+test sur checkout propre pour BUILD-05), et makes_external_claims (false ignore les règles CLAIM-*). Les clés opt-in *_globs (fraîcheur/généré/fondation) restent vides jusqu'à ce que le dépôt adopte ces conventions.
  4. Montrez-lui le câblage CI depuis README.md et faites du job baseline une vérification obligatoire (c'est la règle BUILD-06).
  5. Exécutez un premier score.

Mode : fix — « corriger les échecs de baseline », « passer au vert »

  1. Notez d'abord. Pour chaque blocage/avertissement que l'utilisateur souhaite traiter, appliquez le champ fix de la règle (lisez-le dans rules.json) sous forme de modifications concrètes au dépôt — ajoutez la licence manquante, épinglez l'action à un SHA, ajoutez le .env à .gitignore et faites pivoter le secret, ajoutez le test négatif, etc.
  2. Pour les règles manual (validation), ne simulez pas une vérification — aidez l'utilisateur à faire le jugement (rayon d'explosion, passe d'art antérieur, coin/fossé) et enregistrez une entrée datée dans .project-baseline/signoff.json.
  3. Re-notez pour confirmer.

Mode : explain — « que vérifie SEC-03 », « pourquoi CTX-05 a échoué »

Lisez la règle dans rules.json (chacune a title, rationale, fix, source et la check) et expliquez-la clairement, ainsi que ce que l'exécuteur a réellement cherché. Pour un jargon peu familier (SBOM, SLSA, provenance, registre de validation, …), GLOSSARY.md dans ce répertoire contient des définitions en langage clair.

Comment l'exécuteur décide (afin que vous puissiez interpréter les lignes de détail)

  • RÉUSSI / ÉCHEC / AVERTISSEMENT / VALIDATION / IGNORÉ par règle. Seuls les ÉCHECs blocker définissent le code de sortie 1.
  • IGNORÉ signifie que la règle ne s'appliquait pas : mauvais project_type (n/a pour <type>), un profil désactivé (profil 'advanced' désactivé), une fonctionnalité opt-in non adoptée, ou rien à vérifier. Un ignoré ne compte jamais contre la préparation.
  • Profils : core s'exécute toujours ; service s'exécute automatiquement lorsque project_type=service ; advanced s'exécute uniquement avec --profile advanced ou profiles:["advanced"] dans la configuration.
  • Les revendications sont opt-in : CLAIM-* ne s'exécutent que si un registre de revendications existe ou si makes_external_claims:true est défini explicitement. Un dépôt sans registre de revendications n'est pas pénalisé.
  • La configuration se détecte automatiquement de manière sensée ; baseline.config.json à la racine du dépôt remplace les valeurs. Les clés sont documentées dans config.example.json.
  • L'exécuteur est sans dépendance (Node ≥ 18 + git) et résistant aux crashs : une règle dont la vérification ne peut pas être évaluée passe en IGNORÉ, sans jamais faire échouer l'exécution.

Notes

  • Ne présentez jamais un avertissement comme un blocage ou vice-versa — la sévérité est dans rules.json et la sortie de l'exécuteur.
  • Privilégiez l'exécution réelle de BUILD-05 (omettez --no-exec) lorsque le dépôt est fiable et que la commande d'amorçage est définie — une vérification reine verte est le signal le plus fort.
  • La justification complète, le tableau des règles, les descriptions des catégories, les schémas d'architecture et l'extrait CI se trouvent dans REFERENCE.md de ce répertoire — lisez-le si l'utilisateur souhaite plus de profondeur.

Skills associés