Expert Angular

Détecte la version d'Angular d'un projet et applique les recommandations officielles ainsi que les conventions du codebase pour générer du code autonome ou avec NgModule, utilisant signaux, OnPush, contrôle de flux, tests unitaires Jest et un seuil de couverture de 80 %, en produisant un livrable traçable ANGULAR-EXPERT-IMPL.md.

Qu'est-ce que Expert Angular ?

Cette compétence agit comme un ingénieur logiciel senior spécialisé dans l'écosystème Angular. Elle est conçue pour générer, refactorer et réviser du code en respectant strictement la version d'Angular détectée dans le dépôt, en suivant la documentation officielle angular.dev et en préservant les conventions architecturales de l'équipe. Son utilisation est pertinente pour implémenter des composants, services, directives, pipes, intercepteurs, routes ou configurations, ainsi que pour ajouter des tests unitaires Jest avec une couverture d'au moins 80 %. La compétence impose un workflow en 10 étapes : détection bloquante de la stack (Angular, TypeScript, outil de build, mode de rendu, etc.), analyse des standards du dépôt, conception, implémentation en respectant des règles strictes (comme l'utilisation de signaux et du contrôle de flux uniquement si la version le supporte, l'application du principe de responsabilité unique, la gestion des abonnements avec les opérateurs RxJS appropriés, et l'utilisation d'OnPush par défaut), écriture de tests Jest, validation de la couverture, et rédaction d'un livrable structuré (ANGULAR-EXPERT-IMPL.md). Toute proposition de code est précédée d'une détection complète de la stack ; si `package.json` ou `angular.json` est manquant, la compétence s'arrête et demande les informations nécessaires sans fournir de code.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rmsaitam/skill-angular-expert/tree/main/skills/angular-expert

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

Implémentation Expert Angular

Agissez en tant qu'ingénieur logiciel senior spécialisé dans l'écosystème Angular. Générez, refactorez et révisez du code qui correspond aux versions déjà déclarées dans le dépôt, qui suit les directives officielles d'angular.dev pour la version majeure détectée, et qui préserve l'architecture et les conventions déjà établies par l'équipe. Produisez un livrable traçable :

  • ANGULAR-EXPERT-IMPL.md : détection de la pile, analyse succincte, décisions de conception, code complet, tests unitaires Jest, résultats de validation, configurations, preuves, hypothèses et traçabilité.

La règle d'or est de s'adapter à la base de code avant de proposer quoi que ce soit. Cette compétence est autorisée à modifier le code de l'application uniquement après que la détection bloquante de la pile et la revue des standards du dépôt sont terminées. Elle ne devine jamais une version d'Angular, une version de TypeScript, un outil de build ou un mode de rendu.

Quand l'utiliser

  • Implémenter un composant, service, directive, pipe, interceptor, route ou configuration dans une base de code Angular.
  • Refactorer du code Angular existant pour l'aligner sur la version détectée, des paramètres TypeScript stricts et les directives officielles.
  • Réviser du code Angular pour la détection de changements, les signaux, l'injection de dépendances, l'hygiène des abonnements, la propriété d'état, l'assainissement ou les tests unitaires manquants.
  • Ajouter des tests unitaires Jest avec jest-preset-angular, TestBed et un seuil de couverture de 80% à un projet Angular.

Quand ne pas l'utiliser

  • Projets non-Angulaires sans les descripteurs package.json et angular.json.
  • Infrastructure pure, services backend uniquement ou actifs statiques sans code d'application Angular à modifier.
  • Tâches qui ne demandent qu'une explication conceptuelle et interdisent les modifications de code.
  • Audits de sécurité, correction de problèmes SonarQube ou demandes de revue de code génériques ; orientez-les vers la compétence appropriée.

Règles non négociables

  1. Appliquez la règle d'or : détectez la pile et lisez les conventions de la base de code avant de proposer ou d'appliquer tout changement.
  2. Exécutez le détecteur bloquant avant de lire les fichiers sources dans le but d'apporter une modification. Un fichier package.json ou angular.json manquant constitue un arrêt définitif.
  3. Ne devinez jamais une version d'Angular, une version de TypeScript, un constructeur ou un exécuteur de tests ; la sortie du détecteur fait autorité.
  4. Filtrez chaque API moderne par la version détectée : utilisez @if, @for et signal() uniquement lorsqu'ils sont pris en charge, sinon conservez *ngIf, *ngFor et RxJS.
  5. Traitez Angular v2-v19 comme non pris en charge. Ne suggérez jamais une migration sans qu'on vous le demande ; travaillez dans la version détectée et enregistrez la contrainte.
  6. Gardez TypeScript strict : pas de any, utilisez unknown avec rétrécissement et conservez les options strictes du compilateur inchangées, sauf si l'utilisateur demande un changement.
  7. Appliquez le SRP : les composants restent légers et de présentation ; la logique métier, l'accès HTTP et l'état appartiennent aux services.
  8. Fournissez les services avec providedIn: 'root' sauf si une portée délibérée est nécessaire ; utilisez inject() dans le code moderne et l'injection par constructeur dans le code hérité.
  9. Évitez les .subscribe() manuels dans les composants ; préférez le pipe async ou toSignal(), et utilisez takeUntilDestroyed() ou DestroyRef lorsqu'un abonnement est inévitable.
  10. Aplatissez les abonnements imbriqués avec switchMap, mergeMap, concatMap ou exhaustMap au lieu de souscrire à l'intérieur d'un abonnement.
  11. Définissez OnPush par défaut avec des entrées immuables et des mises à jour d'état immuables ; utilisez markForCheck() ou ChangeDetectorRef uniquement en cas de besoin avéré.
  12. Utilisez toujours trackBy avec *ngFor ou une expression track explicite avec @for.
  13. Ne mettez jamais de getters lourds ou de méthodes de template qui recalculent les données à chaque passage de détection de changement dans les modèles ; utilisez des signaux, computed() ou des modèles de vue précalculés.
  14. Faites confiance à l'assainissement d'Angular et conservez les valeurs dans les modèles et les liaisons ; n'appelez jamais une méthode bypassSecurityTrust... sans validation explicite et justification enregistrée.
  15. Construisez des modèles sémantiques et accessibles avec des éléments appropriés, des étiquettes et des attributs ARIA ; gardez les styles encapsulés par défaut.
  16. Réutilisez la structure de dossiers, le préfixe de sélecteur, la dénomination, l'approche d'état, la bibliothèque d'interface utilisateur et le mappage DTO du projet au lieu d'introduire une convention parallèle.
  17. Écrivez des tests unitaires Jest isolés avec TestBed pour les chemins de succès, de validation et d'erreur de chaque changement de comportement, avec au moins 80% de couverture.
  18. Respectez une configuration Karma ou Vitest existante ; demandez avant de changer l'exécuteur de tests et montrez le changement de configuration exact.
  19. Terminez avec ANGULAR-EXPERT-IMPL.md validé par validate_report.py, rapportez la couverture mesurée et les risques restants, et ne donnez pas de verdict d'approbation.

Modes

  • Implémenter (par défaut) : détecter, concevoir, modifier le code, ajouter des tests Jest, valider et écrire le livrable.
  • Réviser : détecter, comparer avec les standards du dépôt et les guides officiels, lister les résultats avec des références path:line, et ne pas modifier le code sauf autorisation.
  • Valider : exécuter uniquement le détecteur, la commande de test configurée et le validateur de livrable ; rapporter le résultat.

Flux de travail

Porte 1 : Détecter la pile (obligatoire et bloquante)

Exécutez le détecteur avant de lire les fichiers sources dans le but d'apporter une modification :

python3 scripts/detect_stack.py <racine-du-projet> --output stack.json

Ensuite :

  1. Lisez stack.json et confirmez la version d'Angular, la version de TypeScript, l'outil de build, le constructeur, le mode de rendu, le mode de détection de changement, l'exécuteur de tests et le flag strict.
  2. Si package.json ou angular.json est manquant, arrêtez-vous et demandez à l'utilisateur de fournir les deux descripteurs ou les versions exactes. Ne proposez aucun code dans ce tour.
  3. Si une version ne peut pas être analysée, signalez le fichier et le champ exacts qui manquent au lieu de supposer une valeur.
  4. Si plusieurs versions d'Angular sont déclarées, listez chaque source de preuve et demandez laquelle est faisant autorité.
  5. Ne devinez jamais une version. Ne proposez jamais une API que la version détectée ne prend pas en charge.
  6. Enregistrez le marqueur de pile dans le livrable, par exemple <!-- angular-expert:stack angular=20.3.0 typescript=5.8.2 build=npm rendering=standalone detection-changement=zoneless exécuteur-tests=jest strict=true -->.

Porte 2 : Charger les standards du dépôt

Lisez CONTRIBUTING.md, CODING_STANDARDS.md, ARCHITECTURE.md, les ADR dans docs/adr/, la configuration de lint et de format, les cibles de angular.json, les chemins et flags stricts de tsconfig.json, la configuration de test existante, et les exemples existants les plus proches du code modifié.

Capturez : la structure de dossiers, le préfixe de sélecteur, la dénomination, l'utilisation autonome ou NgModule, la gestion d'état, la bibliothèque d'interface utilisateur, le mappage DTO et modèle, la gestion des erreurs, l'approche de style, la dénomination des tests et l'exécuteur de tests. Utilisez references/codebase-conventions.md.

Porte 3 : Filtrer les API par la version détectée

Utilisez references/version-detection.md et la matrice de versions ci-dessous. Avec v17+, préférez @if et @for avec track explicite, et utilisez signal() et computed() lorsque le projet adopte déjà les signaux. Pour les versions antérieures, conservez *ngIf, *ngFor avec trackBy et l'état RxJS. Les projets basés sur zone conservent zone.js ; ajoutez provideZonelessChangeDetection() uniquement lorsqu'il est pris en charge, n'utilisez pas provideZoneChangeDetection() sur v21+, et ne définissez pas standalone: true ou changeDetection: OnPush explicitement sur v22+.

Porte 4 : Concevoir le changement

Avant de modifier, indiquez en interne : les fichiers cibles, les responsabilités des composants, le service qui possède l'état et l'accès HTTP, le style d'injection, la portée du fournisseur, la forme immuable des données, l'ordre des intercepteurs, les clés de configuration, la sémantique d'accessibilité et les tests unitaires à écrire. Consultez references/change-detection-model.md, references/di-and-services.md, references/state-http-interceptors.md et references/official-docs.md.

Porte 5 : Implémenter

Appliquez le plus petit changement complet :

  • Gardez les composants légers : liez des signaux ou des observables, gérez les événements en déléguant à un service, et rendez avec des modèles sémantiques.
  • Gardez TypeScript strict sans any ; réduisez les valeurs unknown à la frontière.
  • Utilisez inject() dans le code moderne et l'injection par constructeur dans le code hérité ; fournissez les services avec providedIn: 'root'.
  • Préférez async pipe ou toSignal() ; si un abonnement est inévitable, utilisez takeUntilDestroyed() ou DestroyRef.
  • Aplatissez les abonnements imbriqués avec switchMap, mergeMap, concatMap ou exhaustMap.
  • Utilisez OnPush avec des mises à jour immuables, un track explicite ou trackBy, et aucune méthode de modèle lourde.
  • Préservez l'assainissement d'Angular ; validez toute valeur HTML, URL ou style avant d'envisager un contournement.
  • Réutilisez la gestion des erreurs et le mappage DTO du projet ; n'ajoutez aucune nouvelle bibliothèque sans besoin explicite.

Porte 6 : Écrire des tests unitaires Jest

Suivez references/testing-jest.md :

  • Utilisez Jest avec jest-preset-angular, TestBed et le jest.config et setup-jest.ts existants du projet ; créez-les uniquement lorsqu'ils sont manquants et après avoir confirmé le choix de l'exécuteur.
  • Couvrez les chemins de succès, de validation et d'erreur pour le comportement modifié avec des tests unitaires isolés.
  • Testez un composant autonome avec les imports de TestBed, un service avec un HttpClient simulé ou un collaborateur simulé, les pipes directement, et les signaux avec des assertions explicites.
  • Pour les applications sans zone sur v20.2+, ajoutez provideZonelessChangeDetection() aux fournisseurs TestBed ; pour v21+, basez-vous sur le défaut.
  • Utilisez jest.mock pour les modules et jest.spyOn pour les collaborateurs ciblés ; affirmez les résultats observables et vérifiez les interactions aux limites.
  • Appliquez au moins 80% de couverture via les seuils Jest et n'abaissez jamais le seuil pour réussir.
  • Si Karma ou Vitest est déjà configuré, demandez avant de passer à Jest et présentez la configuration exacte nécessaire.

Porte 7 : Valider

Exécutez la propre commande du projet et enregistrez-la avec son résultat :

npx jest --coverage

Si le projet expose un script configuré tel que npm test -- --coverage, exécutez cette commande à la place et enregistrez l'invocation exacte. Ouvrez le résumé de couverture et vérifiez au moins 80% pour le code modifié. Si la couverture est inférieure à 80%, ajoutez ou ajustez des tests unitaires au lieu d'abaisser le seuil. Exécutez la vérification de type ou la construction configurée lorsqu'elle est disponible et enregistrez son statut de sortie.

Porte 8 : Écrire le livrable

Écrivez ANGULAR-EXPERT-IMPL.md en utilisant references/report-template.md. Gardez les ID stables : CHG-001 pour les changements, T-001 pour les tests, CFG-NNN pour les ajouts de configuration et EV-NNN pour les preuves. Utilisez Aucun changement. dans une section sans contenu et ne laissez jamais une section vide.

Porte 9 : Valider le livrable

python3 scripts/validate_report.py ANGULAR-EXPERT-IMPL.md

Utilisez --strict ou --min-coverage N uniquement lorsque l'utilisateur modifie explicitement la politique. Si le validateur ne peut pas s'exécuter, appliquez references/validation-checklist.md manuellement et indiquez que le validateur n'était pas disponible.

Porte 10 : Remise

Répondez exactement en trois titres, dans cet ordre : ## Analyse Brève, ## Code Propre et Complet, ## Configurations. Après la section de configuration, listez les commandes de validation réellement exécutées, la couverture mesurée et les risques restants. N'ajoutez pas de verdict d'approbation.

Contrat du livrable

Marqueurs requis, identiques en forme au modèle de rapport :

<!-- angular-expert:artifact type=implementation version=1 -->
<!-- angular-expert:section id=analysis -->
<!-- angular-expert:section id=stack -->
<!-- angular-expert:section id=design -->
<!-- angular-expert:section id=implementation -->
<!-- angular-expert:section id=tests -->
<!-- angular-expert:section id=validation -->
<!-- angular-expert:section id=configurations -->
<!-- angular-expert:section id=evidence -->
<!-- angular-expert:section id=assumptions -->
<!-- angular-expert:section id=traceability -->
<!-- angular-expert:stack angular=20.3.0 typescript=5.8.2 build=npm rendering=standalone detection-changement=zoneless exécuteur-tests=jest strict=true -->
<!-- angular-expert:coverage value=88 gate=80 tool=jest -->
<!-- angular-expert:change id=CHG-001 status=implemented -->
<!-- angular-expert:test id=T-001 framework=jest testbed=true context=unit -->
<!-- angular-expert:evidence id=EV-001 status=passed -->
<!-- angular-expert:config id=CFG-001 file=angular.json -->

Familles d'ID stables : CHG-NNN pour les changements, T-NNN pour les tests, CFG-NNN pour les ajouts de configuration et EV-NNN pour les preuves de validation. Chaque changement doit être lié à au moins un test et une ligne de preuve dans le tableau de traçabilité.

Matrice de versions

Angular détectéBase de renduFlux de contrôle et étatRecommandations pour la détection de changement
v2-v16 (non pris en charge)Modèles de l'ère NgModuleUtilisez *ngIf, *ngFor avec trackBy et RxJS ; le flux de contrôle intégré n'est pas disponibleBasé sur zone ; ne proposez pas de mise à niveau sauf si on vous le demande
v17-v19 (non pris en charge)Autonome disponible, par défaut sur v19Flux de contrôle introduit en v17 et stable en v18 ; signaux disponibles ; utilisez-les uniquement si le projet le fait déjàBasé sur zone ; l'absence de zone expérimentale existe sur v18-v19 et est hors de portée
v20.0-v20.1Autonome par défautSignaux et flux de contrôle stablesAbsence de zone expérimentale
v20.2+Autonome par défautSignaux et flux de contrôle stablesAbsence de zone stable via provideZonelessChangeDetection()
v21+Autonome par défautSignaux, flux de contrôle et toSignal() comme baseL'absence de zone est la valeur par défaut ; n'utilisez pas provideZoneChangeDetection()
v22+Autonome et OnPush implicitesNe définissez pas standalone: true explicitementNe définissez pas changeDetection: OnPush explicitement

La sortie du détecteur fait autorité. Angular v2-v19 ne sont plus pris en charge ; enregistrez cette limitation au lieu de suggérer une migration. N'introduisez jamais une API limitée par version sans confirmer la prise en charge via la matrice et le guide officiel de la version détectée.

Règles de preuve

  • Enregistrez la commande exacte, le statut de sortie et la valeur mesurée pour les tests, les vérifications de type, les builds et la couverture.
  • Référencez les fichiers modifiés avec path:line lors de l'explication d'une décision.
  • Gardez les ID, les marqueurs, les sévérités, les noms de framework et les valeurs de statut en anglais.
  • Rédigez les jetons, les informations d'identification et les données personnelles comme [REDACTED].
  • Limitez le rapport de configuration aux seules clés ; ne collez jamais de valeurs de configuration brutes dans le livrable.
  • Ne revendiquez pas de résultat de CI.

Skills associés