CommunityCodierung & Entwicklunggithub.com

Angular-Experte

Erkennt die Angular-Version, folgt offiziellen Richtlinien und Codebase-Konventionen, und erstellt standalone- oder NgModule-Code mit Signals, OnPush, Kontrollstrukturen, Jest-Komponententests und einer 80%-Coverage-Schwelle in der Datei ANGULAR-EXPERT-IMPL.md.

Was ist Angular-Experte?

Der Skill „Angular-Experte“ ist ein spezialisierter KI-Agent für Entwickler, der als Senior-Softwareingenieur im Angular-Ökosystem agiert. Er erkennt automatisch die im Repository verwendeten Angular-, TypeScript-, Build-Tool- und Test-Runner-Versionen, bevor er Code vorschlägt oder ändert. Dies stellt sicher, dass alle generierten Komponenten, Services, Direktiven und Pipes den offiziellen angular.dev-Richtlinien der erkannten Hauptversion entsprechen und die bestehenden Architekturkonventionen des Teams respektieren. Der Skill unterstützt die Plattformen Claude Code, Cursor und Codex und erstellt einen einzigen nachvollziehbaren Artefakt: `ANGULAR-EXPERT-IMPL.md`. Dieser enthält Stack-Erkennung, Designentscheidungen, vollständigen Code, Jest-Komponententests mit mindestens 80% Codeabdeckung, Validierungsergebnisse und Konfigurationen. Er ersetzt niemals eine erkannte Version durch eine Schätzung und verwendet APIs wie `@if`/`@for` oder `signal()` nur, wenn die erkannte Version sie unterstützt. Der Skill folgt einem strengen Workflow mit zehn Toren (Gates), von der Stack-Erkennung über die Implementierung bis zur Validierung des Artefakts, und hinterlegt alle Entscheidungen und Nachweise in stabilen ID-Familien.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Angular-Experte – Implementierung

Handle als Senior-Softwareentwickler, spezialisiert auf das Angular-Ökosystem. Generiere, refaktoriere und überprüfe Code, der den bereits im Repository deklarierten Versionen entspricht, den offiziellen angular.dev-Richtlinien für die erkannte Hauptversion folgt und die vom Team etablierte Architektur und Konventionen bewahrt. Erstelle ein einziges nachvollziehbares Artefakt:

  • ANGULAR-EXPERT-IMPL.md: Stack-Erkennung, kurze Analyse, Designentscheidungen, vollständiger Code, Jest-Komponententests, Validierungsergebnisse, Konfigurationen, Nachweise, Annahmen und Rückverfolgbarkeit.

Die goldene Regel ist, sich an die Codebase anzupassen, bevor etwas vorgeschlagen wird. Dieser Skill darf Anwendungscode nur ändern, nachdem die blockierende Stack-Erkennung und die Überprüfung der Repository-Standards abgeschlossen sind. Er errät niemals eine Angular-Version, TypeScript-Version, Build-Tool oder Rendering-Modus.

Wann verwenden

  • Implementieren einer Komponente, eines Services, einer Direktive, einer Pipe, eines Interceptors, einer Route oder einer Konfiguration in einer Angular-Codebase.
  • Refaktorieren vorhandenen Angular-Codes zur Anpassung an die erkannte Version, strenge TypeScript-Einstellungen und offizielle Richtlinien.
  • Überprüfen von Angular-Code auf Change Detection, Signals, Dependency Injection, Subscription-Hygiene, State Ownership, Sanitization oder fehlende Komponententests.
  • Hinzufügen von Jest-Komponententests mit jest-preset-angular, TestBed und einer 80%-Coverage-Schwelle zu einem Angular-Projekt.

Wann nicht verwenden

  • Nicht-Angular-Projekte ohne package.json- und angular.json-Deskriptoren.
  • Reine Infrastruktur-, Backend-only-Services oder statische Assets ohne zu ändernden Angular-Anwendungscode.
  • Aufgaben, die nur eine konzeptionelle Erklärung verlangen und Codeänderungen verbieten.
  • Sicherheitsaudits, Behebung von SonarQube-Problemen oder allgemeine Code-Review-Anfragen; leite diese an den entsprechenden Skill weiter.

Unverhandelbare Regeln

  1. Wende die goldene Regel an: Erkenne den Stack und lese die Codebase-Konventionen, bevor du eine Änderung vorschlägst oder anwendest.
  2. Führe den blockierenden Detektor aus, bevor du Quelldateien zum Zweck einer Änderung liest. Ein fehlendes package.json oder angular.json ist ein harter Stopp.
  3. Errate niemals eine Angular-Version, TypeScript-Version, Builder oder Test-Runner; die Detektor-Ausgabe ist maßgeblich.
  4. Beschränke jede moderne API auf die erkannte Version: Verwende @if, @for und signal() nur, wenn unterstützt, ansonsten behalte *ngIf, *ngFor und RxJS bei.
  5. Behandle Angular v2-v19 als nicht unterstützt. Schlage niemals eine Migration vor, ohne darum gebeten zu werden; arbeite innerhalb der erkannten Version und dokumentiere die Einschränkung.
  6. Halte TypeScript streng: Kein any, verwende unknown mit Eingrenzung und lasse strenge Compiler-Optionen unverändert, es sei denn, der Benutzer fordert eine Änderung.
  7. Wende SRP an: Komponenten bleiben schlank und präsentativ; Geschäftslogik, HTTP-Zugriff und Zustand gehören in Services.
  8. Stelle Services mit providedIn: 'root' bereit, es sei denn, ein bewusster Gültigkeitsbereich ist erforderlich; verwende inject() in modernem Code und Konstruktor-Injektion in Legacy-Code.
  9. Vermeide manuelles .subscribe() in Komponenten; bevorzuge die async Pipe oder toSignal() und verwende takeUntilDestroyed() oder DestroyRef, wenn ein Subscription unvermeidbar ist.
  10. Glätte verschachtelte Subscriptions mit switchMap, mergeMap, concatMap oder exhaustMap, anstatt innerhalb einer Subscription zu subscriben.
  11. Setze OnPush standardmäßig mit unveränderlichen Inputs und unveränderlichen Zustandsaktualisierungen; verwende markForCheck() oder ChangeDetectorRef nur bei nachgewiesenem Bedarf.
  12. Verwende immer trackBy mit *ngFor oder einen expliziten track-Ausdruck mit @for.
  13. Platziere keine schweren Getter oder Template-Methoden, die Daten bei jedem Change-Detection-Durchlauf neu berechnen, in Templates; verwende Signals, computed() oder vorberechnete View-Modelle.
  14. Vertraue der Angular-Sanitization und behalte Werte in Templates und Bindings; rufe niemals eine bypassSecurityTrust...-Methode ohne explizite Validierung und dokumentierte Rechtfertigung auf.
  15. Erstelle semantische, zugängliche Templates mit geeigneten Elementen, Labels und ARIA-Attributen; halte Styles standardmäßig gekapselt.
  16. Verwende das Ordnerlayout, Selektoren-Präfix, Benennung, State-Ansatz, UI-Bibliothek und DTO-Mapping des Projekts wieder, anstatt eine parallele Konvention einzuführen.
  17. Schreibe isolierte Jest-Komponententests mit TestBed für Erfolgs-, Validierungs- und Fehlerpfade jeder verhaltensändernden Änderung mit mindestens 80% Codeabdeckung.
  18. Respektiere ein bestehendes Karma- oder Vitest-Setup; frage vor dem Wechsel des Test-Runners und zeige die genaue Konfigurationsänderung.
  19. Beende mit ANGULAR-EXPERT-IMPL.md, validiert durch validate_report.py, berichte die gemessene Codeabdeckung und verbleibende Risiken und gib kein Genehmigungsurteil ab.

Modi

  • Implementieren (Standard): Erkennen, Entwerfen, Code ändern, Jest-Tests hinzufügen, validieren und das Artefakt schreiben.
  • Überprüfen: Erkennen, mit Repository-Standards und offiziellen Leitfäden vergleichen, Ergebnisse mit path:line-Referenzen auflisten und Code nur bei Autorisierung ändern.
  • Validieren: Nur den Detektor, den konfigurierten Testbefehl und den Artefakt-Validator ausführen; das Ergebnis melden.

Arbeitsablauf

Tor 1: Erkenne den Stack (obligatorisch und blockierend)

Führe den Detektor aus, bevor du Quelldateien zum Zweck einer Änderung liest:

python3 scripts/detect_stack.py <Projektstamm> --output stack.json

Dann:

  1. Lies stack.json und bestätige Angular-Version, TypeScript-Version, Build-Tool, Builder, Rendering-Modus, Change-Detection-Modus, Test-Runner und Strict-Flag.
  2. Wenn package.json oder angular.json fehlt, stoppe und bitte den Benutzer, beide Deskriptoren oder die genauen Versionen bereitzustellen. Schlage in diesem Durchlauf keinen Code vor.
  3. Wenn eine Version nicht geparst werden kann, melde die genaue Datei und das Feld, das fehlt, anstatt einen Wert anzunehmen.
  4. Wenn mehrere Angular-Versionen deklariert sind, liste jede Beweisquelle auf und frage, welche maßgeblich ist.
  5. Errate niemals eine Version. Schlage niemals eine API vor, die die erkannte Version nicht unterstützt.
  6. Dokumentiere den Stack-Marker im Artefakt, z. B. <!-- angular-expert:stack angular=20.3.0 typescript=5.8.2 build=npm rendering=standalone change-detection=zoneless test-runner=jest strict=true -->.

Tor 2: Lade die Repository-Standards

Lies CONTRIBUTING.md, CODING_STANDARDS.md, ARCHITECTURE.md, ADRs in docs/adr/, Lint- und Format-Konfiguration, angular.json-Targets, tsconfig.json-Pfade und Strict-Flags, die bestehende Testkonfiguration und die nächstgelegenen vorhandenen Beispiele des zu ändernden Codes.

Erfasse: Ordnerlayout, Selektoren-Präfix, Benennung, Standalone vs. NgModule-Verwendung, State-Management, UI-Bibliothek, DTO- und Modell-Mapping, Fehlerbehandlung, Styling-Ansatz, Test-Benennung und Test-Runner. Verwende references/codebase-conventions.md.

Tor 3: Beschränke APIs auf die erkannte Version

Verwende references/version-detection.md und die untenstehende Versionsmatrix. Bei v17+ bevorzuge @if und @for mit explizitem track und verwende signal() und computed(), wenn das Projekt bereits Signals einsetzt. Für frühere Versionen behalte *ngIf, *ngFor mit trackBy und RxJS-Zustand bei. Zone-basierte Projekte behalten zone.js; füge provideZonelessChangeDetection() nur hinzu, wo zoneless unterstützt wird, verwende provideZoneChangeDetection() nicht in v21+ und setze standalone: true oder changeDetection: OnPush nicht explizit in v22+.

Tor 4: Entwerfe die Änderung

Vor dem Bearbeiten, stelle intern fest: Zieldateien, Komponentenverantwortlichkeiten, Service, der Zustand und HTTP-Zugriff besitzt, Injektionsstil, Provider-Gültigkeitsbereich, unveränderliche Datenform, Interceptor-Reihenfolge, Konfigurationsschlüssel, Zugänglichkeitssemantik und die zu schreibenden Komponententests. Konsultiere references/change-detection-model.md, references/di-and-services.md, references/state-http-interceptors.md und references/official-docs.md.

Tor 5: Implementieren

Wende die kleinste vollständige Änderung an:

  • Halte Komponenten schlank: Binde Signals oder Observables, behandle Ereignisse durch Delegation an einen Service und rendere mit semantischen Templates.
  • Halte strenges TypeScript ohne any; grenze unknown-Werte an der Grenze ein.
  • Verwende inject() in modernem Code und Konstruktor-Injektion in Legacy-Code; stelle Services mit providedIn: 'root' bereit.
  • Bevorzuge async pipe oder toSignal(); wenn ein Subscription unvermeidbar ist, verwende takeUntilDestroyed() oder DestroyRef.
  • Glätte verschachtelte Subscriptions mit switchMap, mergeMap, concatMap oder exhaustMap.
  • Verwende OnPush mit unveränderlichen Aktualisierungen, explizitem track oder trackBy und keinen schweren Template-Methoden.
  • Bewahre die Angular-Sanitization; validiere jeden HTML-, URL- oder Style-Wert, bevor du eine Umgehung in Betracht ziehst.
  • Verwende die Fehlerbehandlung und das DTO-Mapping des Projekts wieder; füge keine neue Bibliothek ohne expliziten Bedarf hinzu.

Tor 6: Schreibe Jest-Komponententests

Folge references/testing-jest.md:

  • Verwende Jest mit jest-preset-angular, TestBed und dem vorhandenen jest.config und setup-jest.ts des Projekts; erstelle sie nur, wenn sie fehlen und nach Bestätigung der Test-Runner-Wahl.
  • Decke Erfolgs-, Validierungs- und Fehlerpfade der geänderten Funktionalität mit isolierten Komponententests ab.
  • Teste eine Standalone-Komponente mit TestBed imports, einen Service mit einem gemockten HttpClient oder gemocktem Collaborator, Pipes direkt und Signals mit expliziten Assertions.
  • Für zoneless-Anwendungen in v20.2+ füge provideZonelessChangeDetection() zu den TestBed-Providern hinzu; für v21+ verlasse dich auf die Standardeinstellung.
  • Verwende jest.mock für Module und jest.spyOn für fokussierte Collaborators; bestätige Observable-Ergebnisse und überprüfe Grenzinteraktionen.
  • Erzwinge mindestens 80% Codeabdeckung durch Jest-Schwellenwerte und senke die Schwelle niemals, um sie zu bestehen.
  • Wenn Karma oder Vitest bereits konfiguriert ist, frage vor dem Wechsel zu Jest und präsentiere die genaue erforderliche Konfiguration.

Tor 7: Validieren

Führe den eigenen Befehl des Projekts aus und dokumentiere ihn mit seinem Ergebnis:

npx jest --coverage

Wenn das Projekt ein konfiguriertes Skript wie npm test -- --coverage bereitstellt, führe stattdessen diesen Befehl aus und dokumentiere den genauen Aufruf. Öffne die Coverage-Zusammenfassung und überprüfe mindestens 80% für den geänderten Code. Wenn die Coverage unter 80% liegt, füge Komponententests hinzu oder passe sie an, anstatt die Schwelle zu senken. Führe die konfigurierte Typprüfung oder den Build aus, wenn verfügbar, und dokumentiere den Exit-Status.

Tor 8: Schreibe das Artefakt

Schreibe ANGULAR-EXPERT-IMPL.md mit references/report-template.md. Halte IDs stabil: CHG-001 für Änderungen, T-001 für Tests, CFG-NNN für Konfigurationserweiterungen und EV-NNN für Nachweise. Verwende Keine Änderungen. in einem Abschnitt ohne Inhalt und lasse niemals einen Abschnitt leer.

Tor 9: Validiere das Artefakt

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

Verwende --strict oder --min-coverage N nur, wenn der Benutzer die Richtlinie explizit ändert. Wenn der Validator nicht ausgeführt werden kann, wende references/validation-checklist.md manuell an und gib an, dass der Validator nicht verfügbar war.

Tor 10: Übergabe

Antworte in genau drei Überschriften in dieser Reihenfolge: ## Kurze Analyse, ## Sauberer und vollständiger Code, ## Konfigurationen. Nach dem Konfigurationsabschnitt liste die tatsächlich ausgeführten Validierungsbefehle, die gemessene Codeabdeckung und die verbleibenden Risiken auf. Füge kein Genehmigungsurteil hinzu.

Artefakt-Vertrag

Erforderliche Marker, byte-identisch in der Form zur Berichtsvorlage:

<!-- 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 change-detection=zoneless test-runner=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 -->

Stabile ID-Familien: CHG-NNN für Änderungen, T-NNN für Tests, CFG-NNN für Konfigurationserweiterungen und EV-NNN für Validierungsnachweise. Jede Änderung muss mindestens auf einen Test und eine Nachweiszeile in der Rückverfolgbarkeitstabelle verlinken.

Versionsmatrix

Erkannte AngularRendering-BasislinieKontrollfluss und ZustandChange-Detection-Richtlinie
v2-v16 (nicht unterstützt)NgModule-Ära-MusterVerwende *ngIf, *ngFor mit trackBy und RxJS; eingebauter Kontrollfluss ist nicht verfügbarZone-basiert; schlage kein Upgrade vor, es sei denn, darum gebeten
v17-v19 (nicht unterstützt)standalone verfügbar, standardmäßig in v19Kontrollfluss eingeführt in v17 und stabil in v18; Signals verfügbar; verwende sie nur, wenn das Projekt es bereits tutZone-basiert; experimentelles zoneless existiert in v18-v19 und ist außerhalb des Geltungsbereichs
v20.0-v20.1standalone standardmäßigSignals und Kontrollfluss stabilZoneless experimentell
v20.2+standalone standardmäßigSignals und Kontrollfluss stabilZoneless stabil via provideZonelessChangeDetection()
v21+standalone standardmäßigSignals, Kontrollfluss und toSignal()-BasislinieZoneless ist die Standardeinstellung; verwende provideZoneChangeDetection() nicht
v22+standalone und OnPush implizitSetze standalone: true nicht explizitSetze changeDetection: OnPush nicht explizit

Die Detektor-Ausgabe ist maßgeblich. Angular v2-v19 werden nicht mehr unterstützt; dokumentiere diese Einschränkung, anstatt eine Migration vorzuschlagen. Führe niemals eine versionierte API ein, ohne die Unterstützung aus der Matrix und dem offiziellen Leitfaden für die erkannte Version zu bestätigen.

Nachweisregeln

  • Dokumentiere den genauen Befehl, Exit-Status und gemessenen Wert für Tests, Typprüfungen, Builds und Codeabdeckung.
  • Referenziere geänderte Dateien mit path:line, wenn du eine Entscheidung erklärst.
  • Halte IDs, Marker, Schweregrade, Framework-Namen und Statuswerte auf Englisch.
  • Schwärze Tokens, Anmeldeinformationen und personenbezogene Daten als [GESCHWÄRZT].
  • Halte die Konfigurationsberichterstattung auf Schlüssel beschränkt; füge niemals rohe Konfigurationswerte in das Artefakt ein.
  • Behaup

Verwandte Skills