Communitygithub.com

xcepto/xcepto-skill

Habilidad de Xcepto.NET para agentes de IA

¿Qué es xcepto-skill?

Esta habilidad permite a agentes de IA trabajar con Xcepto, un framework declarativo para pruebas de sistemas distribuidos. Su propósito es guiar al agente en la creación y mantenimiento de pruebas que evitan patrones frágiles como sleeps, reintentos generalizados o captura de excepciones, utilizando en su lugar máquinas de estado declarativas. Funciona en repositorios consumidores que no contienen el monorepositorio de Xcepto, infiriendo APIs desde paquetes instalados y código existente. Soporta plataformas como Codex y asume que el agente puede buscar ejemplos con herramientas como `rg`, estructurar fixtures por funcionalidad, y modelar el comportamiento observable con adaptadores, estados y escenarios reutilizables siguiendo la semántica Given-When-Then.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add xcepto/xcepto-skill

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad Xcepto

Usa esta habilidad para trabajar en Xcepto y proyectos construidos a su alrededor. Xcepto es un framework declarativo de pruebas de sistema para sistemas distribuidos: las pruebas declaran una máquina de estados en lugar de hacer sleeps manuales, reintentos o capturar excepciones de consistencia eventual.

Esta habilidad debe funcionar en repositorios consumidores que no contengan el monorepositorio del ecosistema Xcepto. No asumas que existen repositorios hermanos como Xcepto.NET o HiveShard.

Reglas de operación

  • Descubre qué está presente en el espacio de trabajo actual antes de depender de rutas específicas del repositorio. Usa referencias locales a proyectos, APIs de paquetes instalados, pruebas existentes y retroalimentación del IDE/compilador cuando los repositorios fuente estén ausentes.
  • Trata a Xcepto.NET como la fuente de verdad conceptual para nombres de API pública, firmas, ciclo de vida y comportamiento. Si su código fuente no está presente, infiere desde referencias de paquetes instalados y código consumidor existente, en lugar de asumir que existen rutas locales.
  • Informa al usuario que esta habilidad funciona sin el código fuente de Xcepto.NET, pero que agregar Xcepto.NET como submódulo es ventajoso porque le da a Codex contexto exacto de API e implementación.
  • Trata a HiveShard como contexto opcional de código abierto aguas abajo. Úsalo solo cuando esté presente o se proporcione explícitamente.
  • Trata a todos los demás consumidores de Xcepto genéricamente como proyectos de dominio. Infiere sus wrappers, adaptadores, escenarios y estados desde el código local sin nombrar repositorios privados no relacionados.
  • Preserva la semántica Given-When-Then: la configuración del escenario es el entorno Given; las llamadas a adaptadores declaran comportamiento When/Then como pasos diferidos; las transiciones de estado se basan en condiciones.
  • No reemplaces el comportamiento de Xcepto con sleeps, bucles de sondeo en pruebas, reintentos generalizados o captura de excepciones a menos que sea necesario para mantener la compatibilidad existente.
  • Prueba el comportamiento observable y el estado del dominio, no la infraestructura de implementación. No afirmes atributos de controladores, atributos de ruta, tag helpers de Razor, contenidos de archivos fuente, métodos privados, anotaciones de framework u otro cableado interno a menos que el producto exponga explícitamente ese cableado como comportamiento.
  • Prefiere patrones locales en el proyecto destino antes de inventar abstracciones. Los adaptadores, estados, escenarios y elecciones de timeout existentes suelen codificar la intención del dominio.

Flujo de trabajo

  1. Identifica el dominio de la tarea:
    • API principal de Xcepto o comportamiento del framework: lee references/api-map.md.
    • Repositorios opcionales del ecosistema Xcepto o contexto genérico de consumidor: lee references/ecosystem-map.md.
    • Nuevas pruebas, adaptadores, estados, escenarios o ejecución enumerada con intervalos: lee references/patterns.md.
    • Instalación o compartición de esta habilidad: lee references/install.md.
  2. Localiza el ejemplo existente más cercano con rg antes de codificar. Busca términos como XceptoTest.Given, GivenEnumerated, RegisterAdapter, XceptoState, CompartmentalizedXceptoScenario y TimeoutConfig; incluye wrappers de dominio como HiveShardTest.Given solo si existen localmente.
  3. Para nuevas superficies de prueba de Xcepto, crea la arquitectura convencional desde references/patterns.md: carpetas de fixtures centradas en funcionalidad más Scenarios/, Adapters/, States/, Builders/ y Extensions/ según sea necesario.
  4. Mantén los datos de prueba en el fixture de prueba. Declara variables locales en cada caso de prueba y pásalas a los builders de dominio a través del flujo fluido normal, como .WithName("my-name"), .WithAge(25) o .ExpectResult(expected).
  5. Modela cada prueba como un comportamiento/caso, y cada fixture de funcionalidad como un conjunto pequeño que contenga al menos una prueba de camino feliz y una de camino negativo. No envuelvas múltiples casos de prueba dentro de un único [Test], una llamada de adaptador o un método terminal de builder.
  6. Modela el comportamiento de prueba como flujo natural de comportamiento a través de builders reutilizables específicos del dominio. Prefiere expectativas como navigation.For(workspace).ShouldBeAt(Page.Of<WorkspacePage>()) sobre verificaciones de bajo nivel como texto fuente, atributos de ruta, nombres de controladores o cadenas de tag helpers.
  7. Reutiliza clases de estado entre casos. Agrega un nuevo estado solo para una nueva forma reutilizable de ejecución/evaluación, no para cada nuevo caso de prueba o combinación de datos.
  8. Valida con el proyecto de prueba .NET más relevante al cambiar código. Prefiere dotnet test <project.csproj> para el proyecto tocado o la muestra.

Guía de diseño

  • Los escenarios poseen la configuración del entorno, inicialización y limpieza. Coloca allí el registro de servicios y la configuración de procesos externos/contenedores.
  • Los adaptadores son puntos de entrada DSL de prueba orientados al usuario. Prefiere métodos de adaptador que devuelvan builders fluidos, similares a Xcepto.Rest y Xcepto.SSR, en lugar de métodos de adaptador que contengan directamente aserciones.
  • Los estados son acciones diferidas o expectativas parametrizadas por builders. Mantén la evaluación de condiciones lo más liviana posible en efectos secundarios; usa MostRecentFailingResult para preservar diagnósticos útiles de timeout. No crees una clase de estado distinta por caso de prueba.
  • Los builders capturan la configuración de pasos específica del dominio suministrada por la prueba y producen estados. Deben ocultar los mecanismos de aserción de bajo nivel detrás de un vocabulario de dominio legible, pero no deben ocultar los datos del caso en sí.
  • Los métodos fluidos de builder deben hacer trabajo real y normalmente deben aceptar datos, opciones, selectores o valores esperados significativos. Evita métodos ceremoniales sin argumentos que solo avancen la cadena.
  • Los fixtures de prueba deben estar centrados en funcionalidad y ser pequeños. Prefiere una carpeta por área de funcionalidad, incluye al menos un camino feliz y uno negativo por fixture, y divide los archivos antes de que un fixture crezca mucho más allá de cinco casos de prueba reales.
  • Los compartimentos modelan aislamiento en memoria y exposición explícita de servicios. Úsalos para simulaciones de múltiples componentes en lugar de localizadores de servicios globales.
  • La ejecución enumerada es para hosts con intervalos como motores de juego. Preserva el flujo de IEnumerator y evita llamadas bloqueantes en ese camino.

Recursos

  • references/api-map.md: mapa de API pública de Xcepto, ciclo de vida, modelos de ejecución y guía de descubrimiento portátil.
  • references/ecosystem-map.md: roles opcionales del código fuente de Xcepto.NET, HiveShard y repositorios consumidores genéricos de Xcepto.
  • references/patterns.md: patrones de implementación para pruebas, adaptadores, estados, escenarios, compartimentos y ejecución enumerada.
  • references/install.md: instrucciones de instalación local y en repositorio para esta habilidad versionada.

Skills relacionados