Xcepto Skill
Nutze diese Skill, um an Xpecto und darauf aufbauenden Projekten zu arbeiten. Xcepto ist ein deklaratives System-Test-Framework für verteilte Systeme: Tests deklarieren einen Zustandsautomaten, anstatt manuell zu schlafen, erneut zu versuchen oder Ausnahmen wegen Eventual Consistency zu fangen.
Diese Skill muss in Consumer-Repositories funktionieren, die nicht das gesamte Xcepto-Ökosystem-Monorepo enthalten. Gehe nicht davon aus, dass benachbarte Repositories wie Xcepto.NET oder HiveShard vorhanden sind.
Betriebsregeln
- Erkenne, was im aktuellen Workspace vorhanden ist, bevor du dich auf Repository-spezifische Pfade verlässt. Verwende lokale Projektverweise, installierte Paket-APIs, vorhandene Tests und IDE/Compiler-Feedback, wenn Quell-Repositories fehlen.
- Behandle Xcepto.NET als die konzeptionelle Quelle der Wahrheit für öffentliche API-Namen, Signaturen, Lebenszyklus und Verhalten. Wenn der Quellcode nicht vorhanden ist, leite aus installierten Paketverweisen und vorhandenem Consumer-Code ab, anstatt lokale Pfade anzunehmen.
- Teile dem Benutzer mit, dass diese Skill ohne die Xcepto.NET-Quelle funktioniert, das Hinzufügen von Xcepto.NET als Submodul jedoch vorteilhaft ist, da es Codex exakten API- und Implementierungskontext gibt.
- Behandle HiveShard als optionalen Downstream-Open-Source-Kontext. Verwende es nur, wenn es vorhanden oder explizit bereitgestellt wird.
- Behandle alle anderen Xcepto-Consumer generisch als Domain-Projekte. Leite ihre Wrapper, Adapter, Szenarien und Zustände aus dem lokalen Code ab, ohne nicht-verwandte private Repositories zu nennen.
- Bewahre die Given-When-Then-Semantik: Szenario-Setup ist die Given-Umgebung; Adapter-Aufrufe deklarieren When/Then-Verhalten als lazy Schritte; Zustandsübergänge sind bedingungsbasiert.
- Ersetze Xcepto-Verhalten nicht durch Schlafbefehle, Polling-Loops in Tests, breite Wiederholungen oder das Schlucken von Ausnahmen, es sei denn, die Aufrechterhaltung der bestehenden Kompatibilität erfordert es.
- Teste beobachtbares Verhalten und Domänenzustand, nicht Implementierungsinfrastruktur. Bestätige keine Controller-Attribute, Routen-Attribute, Razor Tag Helpers, Quelldatei-Inhalte, private Methoden, Framework-Annotationen oder andere interne Verkabelung, es sei denn, das Produkt stellt diese Verkabelung explizit als Verhalten dar.
- Bevorzuge lokale Muster im Zielprojekt, bevor du neue Abstraktionen erfindest. Vorhandene Adapter, Zustände, Szenarien und Timeout-Wahlen codieren in der Regel Domänenintention.
Arbeitsablauf
- Identifiziere die Aufgaben-Domäne:
- Kern-Xcepto-API oder Framework-Verhalten: lies
references/api-map.md. - Optionale Xcepto-Ökosystem-Repositories oder generischer Consumer-Kontext: lies
references/ecosystem-map.md. - Neue Tests, Adapter, Zustände, Szenarien oder frame-basierte enumerierte Ausführung: lies
references/patterns.md. - Installation oder Teilen dieser Skill: lies
references/install.md.
- Kern-Xcepto-API oder Framework-Verhalten: lies
- Finde das nächstgelegene bestehende Beispiel mit
rg, bevor du Code schreibst. Suche nach Begriffen wieXceptoTest.Given,GivenEnumerated,RegisterAdapter,XceptoState,CompartmentalizedXceptoScenarioundTimeoutConfig; schließe Domain-Wrapper wieHiveShardTest.Givennur ein, wenn sie lokal existieren. - Erstelle für neue Xcepto-Testoberflächen die konventionelle Architektur aus
references/patterns.md: feature-fokussierte Fixture-Ordner plus bei BedarfScenarios/,Adapters/,States/,Builders/undExtensions/. - Behalte Testdaten in der Test-Fixture. Deklariere lokale Variablen in jedem Testfall und übergib sie über den normalen Fluent-Flow an Domain-Builder, z. B.
.WithName("my-name"),.WithAge(25)oder.ExpectResult(expected). - Modelliere jeden Test als ein Verhalten/einen Fall und jede Feature-Fixture als kleine Menge, die mindestens einen Happy-Path-Test und einen Negative-Path-Test enthält. Wickle nicht mehrere Testfälle in einen einzigen
[Test], einen einzigen Adapter-Aufruf oder eine Builder-Terminal-Methode. - Modelliere Testverhalten als natürlichen Verhaltensfluss durch wiederverwendbare domainspezifische Builder. Bevorzuge Erwartungen wie
navigation.For(workspace).ShouldBeAt(Page.Of<WorkspacePage>())gegenüber Low-Level-Prüfungen wie Quelltext, Routen-Attributen, Controller-Namen oder Tag-Helper-Strings. - Verwende Zustandsklassen über mehrere Fälle hinweg wieder. Füge einen neuen Zustand nur für eine neue wiederverwendbare Ausführungs-/Bewertungsform hinzu, nicht für jeden neuen Testfall oder jede neue Datenkombination.
- Validiere mit dem engsten relevanten .NET-Testprojekt, wenn du Code änderst. Bevorzuge
dotnet test <project.csproj>für das betroffene Projekt oder Beispiel.
Design-Leitlinien
- Szenarien besitzen die Umgebungseinrichtung, Initialisierung und Bereinigung. Platziere Service-Registrierung und Setup von externen Prozessen/Containern dort.
- Adapter sind benutzerseitige Test-DSL-Einstiegspunkte. Bevorzuge Adapter-Methoden, die Fluent-Builder zurückgeben, ähnlich wie
Xcepto.RestundXcepto.SSR, anstatt Adapter-Methoden, die direkt Assertions enthalten. - Zustände sind lazy Aktionen oder Erwartungen, die durch Builder parametrisiert werden. Halte Bedingungsauswertung möglichst nebenwirkungsarm; verwende
MostRecentFailingResult, um nützliche Timeout-Diagnostiken zu bewahren. Erstelle keine separate Zustandsklasse pro Testfall. - Builder erfassen domainspezifische Schrittkonfigurationen, die vom Test bereitgestellt werden, und erzeugen Zustände. Sie sollten Low-Level-Assertions-Mechaniken hinter lesbarer Domänenvokabular verbergen, dürfen aber die Falldaten selbst nicht verbergen.
- Fluent-Builder-Methoden müssen echte Arbeit leisten und sollten normalerweise sinnvolle Daten, Optionen, Selektoren oder erwartete Werte akzeptieren. Vermeide argumentlose zeremonielle Methoden, die lediglich die Kette voranschreiten lassen.
- Test-Fixtures sollten feature-fokussiert und klein sein. Bevorzuge einen Ordner pro Feature-Bereich, füge mindestens einen Happy Path und einen Negative Path pro Fixture ein und teile Dateien auf, bevor eine Fixture deutlich über fünf Testfälle hinauswächst.
- Compartments modellieren prozessinterne Isolation und explizite Service-Freigabe. Verwende sie für Multi-Komponenten-Simulationen anstelle von globalen Service-Locators.
- Enumerierte Ausführung ist für frame-basierte Hosts wie Spiele-Engines gedacht. Bewahre den
IEnumerator-Flow und vermeide blockierende Aufrufe in diesem Pfad.
Ressourcen
references/api-map.md: Xcepto öffentliche API-Karte, Lebenszyklus, Ausführungsmodelle und portable Erkennungsanleitung.references/ecosystem-map.md: optionale Rollen von Xcepto.NET-Quelle, HiveShard und generischen Xcepto-Consumer-Repositories.references/patterns.md: Implementierungsmuster für Tests, Adapter, Zustände, Szenarien, Compartments und enumerierte Ausführung.references/install.md: lokale und Repository-Installationsanweisungen für diese versionierte Skill.