Procédure QA Unifiée

VérifiéSûr

Exécute des vérifications qualité unifiées via les scripts qa-* selon le niveau (dev/pass/full). À utiliser lors de demandes QA ou avant livraison.

Spar Skills Guide Bot
TestingIntermédiaire
23/07/2026
Claude Code
#qa#test-runner#typescript#quality-gate#pre-ship

Recommandé pour

Synthèse automatique

Point d'entrée unique qui sélectionne et exécute le script qa-* approprié (dev, pass ou full) puis vérifie TypeScript, tests et build avant de rapporter les résultats.

Points forts

  • Choisit automatiquement le niveau de QA selon le contexte (développement, fin de fonctionnalité, avant livraison)
  • Impose une vérification TypeScript préalable qui bloque immédiatement en cas d'erreur de type
  • Format de rapport standardisé avec décompte des tests et résumé des échecs
  • Règles explicites sur quand corriger, quand signaler sans bloquer et quand chercher une cause systémique

Limites

  • Suppose l'existence préalable des scripts scripts/qa-dev.mjs, qa-pass.mjs et qa-full.mjs ainsi qu'un serveur de dev sur le port 3100
  • Ne décrit pas le contenu réel des scripts ni les types de tests couverts
  • L'arbre de décision reste heuristique (seuils de 3 et 5 échecs) et peut ne pas convenir à tous les projets
Quand l'utiliser

À utiliser lorsqu'on veut lancer une passe de qualité complète et cohérente avant de livrer ou après avoir terminé une fonctionnalité.

Quand l'éviter

À éviter sur un projet qui n'a pas les scripts qa-* ni la stack Node/TypeScript décrite, ou pour des tests ciblés sur un seul fichier.

Analyse de sécurité

Sûr
Score qualité82/100

The skill is a thin orchestration layer: it selects a QA level, runs `npx tsc --noEmit` and an existing `scripts/qa-[level].mjs`, then reports results. All execution is local and non-destructive, and it explicitly tells the agent not to fake results or skip the type check. The only meaningful risk is that it invokes repository scripts the reader can't see, which is normal for an in-repo tooling skill.

Points d'attention
  • •Runs repo-local scripts (scripts/qa-*.mjs via `node`) and `npx tsc` without inspecting their contents — risk is inherited from the host repository, not introduced by this skill
  • •Assumes a dev server at http://localhost:3100; no credentials or data are sent anywhere
  • •No network exfiltration, no destructive filesystem commands, no obfuscated payloads, no safety-disable instructions
Comment cette analyse est faite

Exemples

Standard QA pass
/qa — run a quality check on the auth refactor I just finished.
Quick sanity check
Run a quick QA check, I just want to know if anything is obviously broken.
Pre-ship full QA
Run everything — full QA before I ship this session.

name: qa description: Unified QA pass using existing qa-* scripts. Runs appropriate quality checks based on scope (dev/pass/full). Use when user says /qa, "run tests", "quality check", "is it broken", or before shipping work.

QA (Unified Quality Assurance Pass)

Purpose

Single entry point for all QA scripts. Pick the right level based on context.

Levels

| Level | Script | When | Duration | | ------ | --------------------- | -------------------------------- | -------- | | dev | scripts/qa-dev.mjs | Quick sanity during development | ~30s | | pass | scripts/qa-pass.mjs | After completing a feature | ~2min | | full | scripts/qa-full.mjs | Before shipping / end of session | ~5min |

Procedure

Phase 1: Select Level

  • Default: pass (covers most cases)
  • If user says "quick": use dev
  • If user says "full" or "everything": use full
  • If about to /ship or /close-session: use full

Phase 2: Pre-Flight

  1. Confirm dev server at http://localhost:3100
  2. Run npx tsc --noEmit --skipLibCheck first (type errors = instant fail)
  3. If tsc fails: fix type errors, then continue

Phase 3: Execute

node scripts/qa-[level].mjs

Capture output. Parse results.

Phase 4: Report

## QA [level] Results [date]

TypeScript: PASS/FAIL
Tests: X passed, Y failed, Z skipped
Build: PASS/FAIL (if full level)

### Failures (if any)
- [test name]: [error summary]

Phase 5: Fix or Flag

  • If < 3 failures and they're in code you touched: fix them
  • If failures are in unrelated code: flag but don't block
  • If > 5 failures: something systemic, investigate root cause

Constraints

  • Never skip tsc check
  • Never report "all good" without actually running the script
  • If script doesn't exist or errors on startup, report that (don't fake results)

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/unified-qa-procedure-mrx3xwl4/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/unified-qa-procedure-mrx3xwl4' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/unified-qa-procedure-mrx3xwl4/download' --output '.skill-downloads/unified-qa-procedure-mrx3xwl4/SKILL.md.part' && mv '.skill-downloads/unified-qa-procedure-mrx3xwl4/SKILL.md.part' '.skill-downloads/unified-qa-procedure-mrx3xwl4/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/unified-qa-procedure-mrx3xwl4/SKILL.md' && test -s '.skill-downloads/unified-qa-procedure-mrx3xwl4/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/qa' && cp -R '.skill-downloads/unified-qa-procedure-mrx3xwl4' '.claude/skills/qa'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/unified-qa-procedure-mrx3xwl4'

openskills read 'unified-qa-procedure-mrx3xwl4'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/unified-qa-procedure-mrx3xwl4/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires