Communitygithub.com

xcepto/xcepto-skill

Xcepto.NET AI 에이전트를 위한 스킬입니다. 분산 시스템을 위한 선언적 시스템 테스트 프레임워크인 Xcepto 작업을 지원합니다.

xcepto-skill란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 Xcepto 및 이를 기반으로 구축된 프로젝트에서 작업할 수 있도록 설계되었습니다. Xcepto는 분산 시스템을 위한 선언적 시스템 테스트 프레임워크로, 수동 sleep, 재시도, 또는 최종 일관성 예외 처리 대신 상태 머신을 선언하여 테스트를 정의합니다. 이 스킬은 Xcepto 생태계 모노레포가 포함되지 않은 소비자 저장소에서도 작동해야 하며, 로컬 프로젝트 참조, 설치된 패키지 API, 기존 테스트, IDE/컴파일러 피드백을 활용하여 적응합니다. Given-When-Then 의미 체계를 보존하고, sleep이나 폴링 루프를 사용하지 않으며, 관찰 가능한 동작과 도메인 상태를 테스트하도록 안내합니다. 또한 references/ 디렉토리의 API 맵, 생태계 맵, 패턴, 설치 가이드 등의 리소스를 참조하여 일관된 워크플로우를 제공합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add xcepto/xcepto-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Xcepto 스킬

이 스킬을 사용하여 Xcepto 및 이를 기반으로 구축된 프로젝트에서 작업하세요. Xcepto는 분산 시스템을 위한 선언적 시스템 테스트 프레임워크입니다. 테스트는 수동 sleep, 재시도, 또는 최종 일관성 예외 처리 대신 상태 머신을 선언합니다.

이 스킬은 Xcepto 생태계 모노레포가 포함되지 않은 소비자 저장소에서도 작동해야 합니다. Xcepto.NET 또는 HiveShard와 같은 형제 저장소가 있다고 가정하지 마세요.

운영 규칙

  • 소스 저장소에 의존하기 전에 현재 작업 공간에 무엇이 있는지 먼저 파악하세요. 로컬 프로젝트 참조, 설치된 패키지 API, 기존 테스트, IDE/컴파일러 피드백을 사용하세요.
  • Xcepto.NET을 공개 API 이름, 시그니처, 라이프사이클 및 동작에 대한 개념적 진실 공급원(source of truth)으로 취급하세요. 해당 소스가 없으면 설치된 패키지 참조와 기존 소비자 코드에서 추론하고 로컬 경로가 있다고 가정하지 마세요.
  • 이 스킬이 Xcepto.NET 소스 없이도 작동하지만, Xcepto.NET을 서브모듈로 추가하면 Codex에 정확한 API 및 구현 컨텍스트를 제공하므로 이점이 있다고 사용자에게 알리세요.
  • HiveShard는 선택적 다운스트림 오픈 소스 컨텍스트로 취급하세요. 현재 있거나 명시적으로 제공된 경우에만 사용하세요.
  • 다른 모든 Xcepto 소비자는 일반적으로 도메인 프로젝트로 취급하세요. 관련 없는 비공개 저장소를 명명하지 않고 로컬 코드에서 래퍼, 어댑터, 시나리오 및 상태를 추론하세요.
  • Given-When-Then 의미 체계를 보존하세요. 시나리오 설정은 Given 환경입니다. 어댑터 호출은 느린 단계(lazy step)로 When/Then 동작을 선언합니다. 상태 전환은 조건 기반입니다.
  • Xcepto 동작을 sleep, 테스트의 폴링 루프, 광범위한 재시도 또는 예외 삼키기로 대체하지 마세요. 단, 기존 호환성 유지에 필요한 경우는 예외입니다.
  • 구현 인프라가 아닌 관찰 가능한 동작과 도메인 상태를 테스트하세요. 제품이 명시적으로 동작으로 노출하지 않는 한, 컨트롤러 속성, 라우트 속성, Razor 태그 헬퍼, 소스 파일 내용, 비공개 메서드, 프레임워크 어노테이션 또는 기타 내부 배선을 단언하지 마세요.
  • 추상화를 발명하기 전에 대상 프로젝트의 로컬 패턴을 선호하세요. 기존 어댑터, 상태, 시나리오 및 타임아웃 선택은 일반적으로 도메인 의도를 인코딩합니다.

워크플로우

  1. 작업 도메인을 식별하세요:
    • 핵심 Xcepto API 또는 프레임워크 동작: references/api-map.md를 읽으세요.
    • 선택적 Xcepto 생태계 저장소 또는 일반 소비자 컨텍스트: references/ecosystem-map.md를 읽으세요.
    • 새 테스트, 어댑터, 상태, 시나리오 또는 프레임 간 열거형 실행: references/patterns.md를 읽으세요.
    • 이 스킬 설치 또는 공유: references/install.md를 읽으세요.
  2. 코딩 전에 rg를 사용하여 가장 가까운 기존 예제를 찾으세요. XceptoTest.Given, GivenEnumerated, RegisterAdapter, XceptoState, CompartmentalizedXceptoScenario, TimeoutConfig와 같은 용어를 검색하고, 로컬에 있는 경우에만 HiveShardTest.Given과 같은 도메인 래퍼를 포함하세요.
  3. 새 Xcepto 테스트 표면의 경우 references/patterns.md에서 일반적인 아키텍처를 만드세요: 기능 중심의 픽스처 폴더와 필요에 따라 Scenarios/, Adapters/, States/, Builders/, Extensions/를 추가하세요.
  4. 테스트 데이터를 테스트 픽스처에 유지하세요. 각 테스트 케이스에서 로컬 변수를 선언하고 .WithName("my-name"), .WithAge(25), .ExpectResult(expected)와 같은 일반적인 fluent 흐름을 통해 도메인 빌더에 전달하세요.
  5. 각 테스트를 하나의 동작/케이스로 모델링하고, 각 기능 픽스처를 최소 하나의 happy-path 테스트와 하나의 negative-path 테스트를 포함하는 작은 집합으로 구성하세요. 여러 테스트 케이스를 하나의 [Test], 하나의 어댑터 호출 또는 하나의 빌더 종료 메서드 내에 래핑하지 마세요.
  6. 테스트 동작을 재사용 가능한 도메인별 빌더를 통한 자연스러운 동작 흐름으로 모델링하세요. 소스 텍스트, 라우트 속성, 컨트롤러 이름 또는 태그 헬퍼 문자열과 같은 저수준 검사보다 navigation.For(workspace).ShouldBeAt(Page.Of<WorkspacePage>())와 같은 기대 표현을 선호하세요.
  7. 여러 케이스에서 상태 클래스를 재사용하세요. 새 테스트 케이스나 새 데이터 조합마다가 아니라, 새로운 재사용 가능한 실행/평가 형태에 대해서만 새 상태를 추가하세요.
  8. 코드를 변경할 때 가장 좁은 관련 .NET 테스트 프로젝트로 검증하세요. 영향을 받는 프로젝트 또는 샘플에 대해 dotnet test <project.csproj>를 선호하세요.

디자인 지침

  • 시나리오는 환경 설정, 초기화 및 정리를 담당합니다. 서비스 등록 및 외부 프로세스/컨테이너 설정을 여기에 배치하세요.
  • 어댑터는 사용자 대상 테스트 DSL 진입점입니다. 어댑터 메서드가 직접 단언을 포함하는 대신 Xcepto.Rest 및 Xcepto.SSR과 유사한 fluent 빌더를 반환하도록 선호하세요.
  • 상태는 빌더에 의해 매개변수화된 느린 동작(lazy actions) 또는 기대입니다. 가능하면 조건 평가를 부작용이 적게 유지하세요. 유용한 타임아웃 진단을 보존하기 위해 MostRecentFailingResult를 사용하세요. 테스트 케이스당 별도의 상태 클래스를 만들지 마세요.
  • 빌더는 테스트에서 제공하는 도메인별 단계 구성을 캡처하고 상태를 생성합니다. 읽기 쉬운 도메인 어휘 뒤에 저수준 단언 메커니즘을 숨겨야 하지만, 케이스 데이터 자체를 숨겨서는 안 됩니다.
  • Fluent 빌더 메서드는 실제 작업을 수행해야 하며 일반적으로 의미 있는 데이터, 옵션, 선택기 또는 예상 값을 받아야 합니다. 단순히 체인을 진행하는 인수 없는 의례적 메서드는 피하세요.
  • 테스트 픽스처는 기능 중심이고 작아야 합니다. 기능 영역당 폴더를 선호하고, 각 픽스처에 최소 하나의 happy path와 하나의 negative path를 포함하며, 픽스처가 5개 실제 테스트 케이스를 크게 넘기 전에 파일을 분할하세요.
  • 컴파트먼트(Compartment)는 인메모리 격리와 명시적 서비스 노출을 모델링합니다. 전역 서비스 로케이터 대신 다중 구성 요소 시뮬레이션에 사용하세요.
  • 열거형 실행(Enumerated execution)은 게임 엔진과 같은 프레임 간 호스트를 위한 것입니다. IEnumerator 흐름을 보존하고 해당 경로에서 차단 호출을 피하세요.

리소스

  • references/api-map.md: Xcepto 공개 API 맵, 라이프사이클, 실행 모델 및 이식 가능한 검색 지침.
  • references/ecosystem-map.md: Xcepto.NET 소스, HiveShard 및 일반 Xcepto 소비자 저장소의 선택적 역할.
  • references/patterns.md: 테스트, 어댑터, 상태, 시나리오, 컴파트먼트 및 열거형 실행을 위한 구현 패턴.
  • references/install.md: 이 버전 관리 스킬의 로컬 및 저장소 설치 지침.

관련 스킬