CodeQuality

Boucle de qualité de code pour n’importe quel dépôt, vue à travers deux objectifs : un objectif outil (linters, vérificateurs de types, sécurité, scanners de code mort et de duplication ; correction par priorité P0 sécurité → P1 exactitude → P2 maintenabilité) et un objectif principe (SOLID + Clean Code ; un principe à la fois, proposer → confirmer → appliquer derrière des tests de caractérisation). Un manifeste d’outils locaux gratuits, un scan, une boucle de correction, un rapport d’amélioration de la qualité obligatoire. À utiliser pour améliorer la qualité du code, analyser le code, corriger le linting, réduire la duplication, ajouter des types, scanner la sécurité, la couverture de tests, refactoriser, améliorer la conception du code, appliquer SOLID, refactoriser le Clean Code, réduire la complexité, éliminer les odeurs de code, rendre le code maintenable, refactoriser du code legacy, responsabilité unique, inversion de dépendances, sprint de remédiation, installer des outils de qualité, baseline de qualité, rapport d’odeurs, feuille de route de refactorisation, par où commencer. PAS POUR le cycle de vie des issues, les branches, les PR ou les fusions (utiliser IssueFlow ; son workflow de remédiation appelle cette compétence pour choisir et cadrer le travail).

Qu'est-ce que CodeQuality ?

CodeQuality est une compétence d’agent IA spécialisée dans l’amélioration de la qualité du code, offrant une boucle unique structurée détection → sélection → correction → vérification → répétition avec deux perspectives complémentaires. La première perspective, « outil », s’appuie sur des scanners automatisés (linters, vérificateurs de types, sécurité, code mort, duplication) pour corriger les problèmes par ordre de priorité : P0 sécurité → P1 exactitude → P2 maintenabilité, en conservant les tests existants verts. La seconde perspective, « principe », applique un principe SOLID ou Clean Code à la fois sur les zones à forte odeur de conception (classes god, duplication, noyaux non testables), en suivant un processus obligatoire de proposition → confirmation → application, avec rédaction préalable de tests de caractérisation si le code cible n’est pas testé. La compétence utilise un manifeste unique d’outils libres et locaux (Tools/tools.tsv) pour l’installation, l’exécution et la génération de rapports, et produit à chaque session un Rapport d’Amélioration de la Qualité obligatoire avec tableau récapitulatif, code supprimé/ajouté/modifié, bogues corrigés, delta de complexité et éléments différés. Le mode de la boucle est automatique : outil si aucune feuille de route n’existe, principe si une feuille de route est présente, avec possibilité de forcer l’un ou l’autre. Destinée aux développeurs et agents IA travaillant sur des dépôts de code JavaScript, Python ou YAML, elle s’intègre également au workflow de remédiation d’IssueFlow pour les cycles complets de sprint de remédiation.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juanmherrerav/agent-workday-skills/tree/main/skills/CodeQuality

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · 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

Personnalisation

Préférences personnelles (optionnelles) : ${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/CodeQuality/PREFERENCES.md.

Si ce fichier existe, lisez-le et appliquez-le ; sinon, utilisez les valeurs par défaut de la compétence. Préférences personnelles uniquement : tout ce qui est un fait concernant un dépôt ou un produit appartient à ce dépôt (son .claude/workflow-profile.sh ou ses configurations d'outils), jamais ici.

Que fait CodeQuality ?

Une boucle, deux perspectives. La boucle est toujours : détecter → choisir un élément → corriger derrière des tests → vérifier → répéter. La perspective outil corrige ce que les scanners signalent, par ordre de priorité, avec les tests existants comme filet de sécurité. La perspective principe corrige ce qui rend le code difficile à modifier (classes god, duplication, cœurs non testables), un principe SOLID / Clean Code à la fois, et n'applique jamais un changement de conception sans le montrer d'abord. Les deux perspectives lisent le même manifeste d'outils, écrivent dans le même répertoire de rapports et se terminent par le même Rapport d'Amélioration de la Qualité.

Deux perspectives

Perspective outilPerspective principe
Pilotesortie du scanner (summary.md)odeurs de conception mappées vers Principles.md (smell-inventory.md, roadmap.md)
Unité de travailun constat : une règle à un fichier:ligneun principe sur un hotspot délimité : une extraction, une scission de classe, une inversion de dépendance
OrdreP0 sécurité → P1 exactitude → P2 maintenabilitééchelle de levier (ci-dessous), ajustée par dépôt
Autonomiecorriger, puis montrer le diffproposer → confirmer → appliquer ; rien n'est modifié avant approbation
Filet de sécuritéles tests existants restent vertsles tests de caractérisation sont écrits d'abord lorsque la cible n'est pas testée
Métriquemoins de constats, outil relancé propre% de duplication, complexité cyclomatique, longueur de fonction, fan-in/out, « maintenant testable unitairement »
À choisir quanddette de lint/type/sécurité, CI rouge, « rendre les scanners heureux »code qui résiste au changement ; le volet structurel d'un sprint de remédiation

La boucle

SCANNER → SÉLECTIONNER → FILET DE SÉCURITÉ → [PROPOSER → CONFIRMER] → CORRIGER → VÉRIFIER → RAPPORTER → RÉPÉTER
                                               └─ obligatoire en mode principe, ignoré en mode outil ─┘

Routage des workflows

DéclencheurWorkflowProduit
« installer les outils de qualité », « configurer la qualité du code »Workflows/Install.mdoutils du manifeste installés et vérifiés
« scanner », « baseline », « analyser la qualité du code », « rapport d'odeurs », « par où commencer », « feuille de route de refactorisation »Workflows/Scan.mdsummary.md (A), smell-inventory.md (B), roadmap.md (C)
« améliorer la qualité du code », « corriger le lint », « boucle qualité », « corriger [constat] »Workflows/Loop.md en mode outilcorrections, session-log.md, rapport
« refactoriser », « appliquer SOLID », « nettoyer ceci », « démarrer la boucle »Workflows/Loop.md en mode principecorrections, session-log.md, rapport
« nettoyer ce dépôt » sans qualificatifScan A + B + C, puis Loop en mode principetout ce qui précède
« sprint de remédiation », « cycle de remédiation »IssueFlow Remediation gère la branche, la PR et la fusion ; Scan cadre le cycle, Loop l'exécuteune PR par cycle

La boucle choisit son mode automatiquement quand aucun n'est donné : outil quand aucun roadmap.md n'existe pour le dépôt, principe quand il en existe un. L'utilisateur peut forcer l'un ou l'autre.

Le manifeste

Tools/tools.tsv est la seule liste d'outils de cette compétence. Séparé par des tabulations, une ligne par outil et langage : langage catégorie priorité outil install exécuter notes, avec langage en js | python | yaml, catégorie en lint | format | types | security | deadcode | duplication | complexity | deps | coverage, priorité en P0 | P1 | P2. Les deux scripts le lisent ; les workflows ne listent jamais d'outils en dur. Pour ajouter ou supprimer un outil, modifiez une ligne.

ScriptLit depuis le manifesteFait
Tools/install-quality-tools.sh [--dry-run] [lang ...]cellules install des langages choisisdétecte les langages (package.json → js ; pyproject.toml, requirements.txt ou *.py → python ; *.yaml/*.yml → yaml) ; installe les outils js comme devDependencies avec le gestionnaire de paquets du dépôt (lockfile → npm/pnpm/bun), les outils python et yaml avec uv pip install ou pip ; les préfixes npm:/pip: surchargent le canal, - n'installe rien
Tools/run-quality-baseline.sh [--dry-run] [lang ...]cellules runexécute chaque outil dans reports/codequality/<YYYY-MM-DD>-<HHMMSS>/, en substituant $OUT (répertoire de rapport), $SRC (QUALITY_SRC_DIRS, par défaut src si existe sinon .), $PM et $NPX ; un outil non installé est MANQUANT, un outil qui plante est EN ÉCHEC, aucun n'arrête l'exécution ; écrit summary.md avec le statut par outil, le nombre de problèmes analysés et les totaux P0/P1/P2 ; affiche le chemin du rapport

Les lignes dont run est - (outils de couverture) sont installées mais pas exécutées par la baseline : la couverture est mesurée dans la Loop, limitée à la cible. Chaque outil est gratuit et s'exécute localement ; npm audit, pip-audit et checkov accèdent au réseau uniquement pour leurs bases de données de vulnérabilités.

Échelle de levier (ordre par défaut de la perspective principe)

  1. Noms — un code que vous ne pouvez pas lire, vous ne pouvez pas le modifier en toute sécurité. Peu coûteux, débloque tout.
  2. DRY / duplication — supprime le plus de code au risque le plus faible ; expose les abstractions cachées.
  3. Petites fonctions — Longue Méthode → Extraire ; un niveau d'abstraction par fonction.
  4. SRP — scinder les classes et modules qui changent pour plus d'une raison.
  5. OCP / DIP — inverser les dépendances, ajouter des points de couture ; impact élevé, risque plus élevé, filet de sécurité d'abord.
  6. ISP / LSP — interfaces grosses et substitutivité brisée ; nécessite les points de couture de l'étape 5.

La partie C du Scan ajuste cet ordre à l'inventaire réel (levier = impact ÷ risque ; voir Principles.md Partie 3).

Non-négociables

  • Un élément par itération. Un constat, ou un principe sur une cible délimitée. Diffs petits et révisables.
  • Conservation du comportement. La structure change, le comportement non. Si le comportement doit changer, arrêtez-vous et signalez-le : c'est une fonctionnalité, pas une correction.
  • Du vert au vert. Les tests passent avant et après. Rouge après un changement signifie annuler, jamais corriger en avant.
  • Tests de caractérisation d'abord lorsque les lignes à toucher ne sont pas testées. Pas de filet, pas de refactorisation.
  • Proposer avant d'appliquer tout changement de conception (mode principe). Le mode outil peut corriger directement, puis montre le diff.
  • P0 → P1 → P2 pour les constats d'outil, tous langages confondus, jamais par langage.
  • Ne jamais affaiblir un test ou une règle de lint pour obtenir du vert. Les tests obsolètes évoluent vers le nouveau comportement correct ; les règles sont satisfaites dans le code.
  • Boy Scout, limité. Laissez les fichiers touchés plus propres, mais n'élargissez pas le périmètre au-delà de l'élément en cours.
  • Preuve, pas opinion. Nommez la règle ou le principe, et une métrique lorsqu'elle existe.

Artefacts produits

Tous sous reports/codequality/ (ignoré par git) :

FichierÉcrit par
<YYYY-MM-DD>-<HHMMSS>/summary.md + sortie brute des outilsrun-quality-baseline.sh (Scan A)
<YYYY-MM-DD>/smell-inventory.mdScan B
<YYYY-MM-DD>/roadmap.mdScan C
<YYYY-MM-DD>/session-log.mdLoop, une entrée par itération
<YYYY-MM-DD>/quality-report.mdLoop, à la fin de la session (ci-dessous)

Rapport d'Amélioration de la Qualité (obligatoire)

Chaque session Loop se termine par ce rapport, quel que soit le mode. Il est le livrable accompagnant la modification du code, et le corps de la PR ou du commentaire de suivi lorsque le travail est livré via IssueFlow.

SectionContenu
Tableau récapitulatiflignes ajoutées / supprimées / net ; problèmes avant → après par priorité ; hotspots de code mort supprimés ; tests avant → après (nombre, tous verts)
Code suppriméfichier, quoi, lignes, risque
Code ajouté ou modifiéfichier, quoi, lignes, objectif
Bogues corrigéssévérité, description, cause racine (uniquement si des bogues sont apparus)
Delta de complexitécomplexité cyclomatique max et moyenne avant → après, avec une barre ASCII par hotspot
Différééléments vus mais hors périmètre, et pourquoi

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

BattlePlan

Daily execution plan from a task tracker (local CSV, Excel workbook, or Google Sheet). Groups open tasks by context and sub-context, estimates time, finds parallel threads, and writes ready-to-paste starting prompts per thread. Starts from yesterday instead of from zero — recaps the previous day's agent sessions and git commits, pre-fills the audit, and offers resume commands. Includes an end-of-day handoff (--close), an unattended morning draft (--draft), and task management (add, done, cancel, restore, sweep, batch import). USE WHEN plan my day, daily plan, battle plan, what should I work on, close the day, end of day handoff, morning draft, task overview, standup prep, prioritize tasks, add a task, mark task done, set up battleplan, configure task tracker.

MeetingAnalysis

Turn meetings into structured summaries and tracked action items. Transcribes recordings locally (faster-whisper on CUDA, Apple Silicon or CPU), imports Google Meet / Gemini notes through connectors, or takes pasted notetaker transcripts; writes a summary with decisions and an action table; pushes only your own items to the BattlePlan tracker. Includes an unattended inbox ingest (drop a recording, get a summary) and a hard rule that recordings never land in a git repo. USE WHEN analyze meeting, meeting summary, transcribe meeting, transcribe recording, summarize this call, what happened in the meeting, import meeting notes, Gemini notes, Google Meet notes, import meetings to tracker, auto ingest meetings, meeting inbox, process recordings folder, set up meeting analysis.

Skills associés