Communitygithub.com

Xcepto Skill – xcepto/xcepto-skill

Skill für KI-Agenten, um mit Xcepto zu arbeiten, einem deklarativen System-Test-Framework für verteilte Systeme.

Was ist xcepto-skill?

Diese Skill ermöglicht es KI-Agenten (z. B. Codex, Claude Code), effektiv mit Projekten zu arbeiten, die das Xcepto-Testframework verwenden. Xcepto ist ein deklaratives Framework zum Testen verteilter Systeme: Anstatt manuell zu schlafen, erneut zu versuchen oder Ausnahmen zu fangen, deklarieren Tests einen endlichen Zustandsautomaten. Die Skill enthält Operating Rules, die den Agenten anleiten, wie er sich in Workspaces ohne das komplette Xcepto-Ökosystem verhalten soll. Sie betont die Verwendung lokaler Projektverweise, installierter Paket-APIs, vorhandener Tests und IDE/Compiler-Feedback, anstatt Annahmen über benachbarte Repositories wie Xcepto.NET oder HiveShard zu treffen. Der Workflow führt den Agenten schrittweise durch Identifikation der Aufgabe, Suche nach bestehenden Beispielen, Erstellung neuer Tests nach festgelegten Architekturmustern, Modellierung als Given-When-Then-Szenarien und Validierung mit dotnet test. Design Guidance gibt detaillierte Ratschläge für den Aufbau von Szenarien, Adaptern, Zuständen, Buildern und Test-Fixtures. Die Skill referenziert mehrere Markdown-Dokumente (api-map, ecosystem-map, patterns, install), die als kontextuelle Wissensbasis für den Agenten dienen.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add xcepto/xcepto-skill

In Ihrer bevorzugten KI fragen

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

Dokumentation

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

  1. 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.
  2. Finde das nächstgelegene bestehende Beispiel mit rg, bevor du Code schreibst. Suche nach Begriffen wie XceptoTest.Given, GivenEnumerated, RegisterAdapter, XceptoState, CompartmentalizedXceptoScenario und TimeoutConfig; schließe Domain-Wrapper wie HiveShardTest.Given nur ein, wenn sie lokal existieren.
  3. Erstelle für neue Xcepto-Testoberflächen die konventionelle Architektur aus references/patterns.md: feature-fokussierte Fixture-Ordner plus bei Bedarf Scenarios/, Adapters/, States/, Builders/ und Extensions/.
  4. 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).
  5. 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.
  6. 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.
  7. 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.
  8. 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.Rest und Xcepto.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.

Verwandte Skills