🇬🇧 English version: README.en.md
Agent Skill, обучающий AI-агентов для разработки (Claude Code, opencode и другие совместимые агенты) созданию .NET-приложений на фреймворке Wolverine (v6.x).
Все API и примеры кода в этом скилле сверены с реальными исходниками Wolverine — а не только с документацией — чтобы исключить выдуманные API.
| Тема | Reference-файл |
|---|---|
| Быстрый старт, конвенции хендлеров, message bus, CLI | references/quickstart.md |
| Саги и долгоживущие workflow | references/sagas.md |
| Durable messaging (транзакционный inbox/outbox) | references/durability.md |
| Транспорт RabbitMQ | references/transports-rabbitmq.md |
| Транспорт Kafka (offset-стратегии, масштабирование) | references/transports-kafka.md |
| Остальные транспорты — AWS SQS/SNS, Azure Service Bus, GCP Pub/Sub, NATS, MQTT, Pulsar, Redis, SignalR, TCP | references/additional-transports.md |
| HTTP-endpoints (Wolverine.Http) | references/http-endpoints.md |
| HTTP advanced — версионирование API, conneg, output caching, antiforgery | references/http-advanced.md |
| Интеграция gRPC | references/grpc.md |
| Интеграция с Marten и event sourcing (агрегаты, подписки) | references/marten.md |
Обработка ошибок — circuit breaker, retry, Fault<T>, DLQ |
references/error-handling.md |
| Валидация — FluentValidation, DataAnnotations | references/validation.md |
| Тестирование — TrackedSession, стабы, TestMessageContext | references/testing.md |
| Кодогенерация и Native AOT | references/codegen.md |
| Сериализация и шифрование сообщений AES-256-GCM | references/serialization.md |
| Rate limiting и батчинг сообщений | references/batching-rate-limiting.md |
Health checks (WolverineFx.HealthChecks, broker probes) |
references/health-checks.md |
| Node agents, leader election, управление кластером | references/node-agents.md |
| Shims для миграции с MediatR / MassTransit, CloudEvents | references/interop-shims.md |
| Observability — OpenTelemetry, метрики, CritterWatch | references/observability.md |
wolverine-development/
├── SKILL.md # Точка входа: обзор, quick reference, навигация
└── references/ # 20 подробных reference-файлов, загружаемых по требованию
Скилл следует паттерну progressive disclosure: агент постоянно видит только имя и описание скилла (~100 слов). Когда задача, связанная с Wolverine, активирует скилл, загружается SKILL.md (~250 строк). Подробные reference-файлы читаются только тогда, когда нужна конкретная тема — это экономит контекстное окно агента.
mkdir -p ~/.config/opencode/skills/wolverine-development
cp -r SKILL.md references ~/.config/opencode/skills/wolverine-development/mkdir -p ~/.claude/skills/wolverine-development
cp -r SKILL.md references ~/.claude/skills/wolverine-development/Или добавьте скилл в конкретный проект — в .claude/skills/wolverine-development/.
Любой агент, поддерживающий спецификацию Agent Skills, может использовать этот скилл — укажите ему директорию, содержащую SKILL.md.
После установки скилл активируется автоматически, когда вы просите агента о задачах, связанных с Wolverine, например:
- «Создай сагу для обработки заказа с таймаутом 10 минут»
- «Настрой Kafka listener с гарантией at-least-once»
- «Добавь durable outbox с PostgreSQL»
- «Мигрируй этот MassTransit consumer на Wolverine»
- «Почему сообщение застряло в inbox?»
Скилл написан по трём источникам:
- Официальная документация (https://wolverinefx.net) — концепции и руководства
- Исходный код Wolverine (JasperFx/wolverine) — каждая нетривиальная сигнатура API сверена с реальным кодом (
WolverineOptions.*.cs,MetricsConstants.cs,IBrokerHealthProbe.cs, тестовые наборы и т.д.) - Собственные тесты Wolverine — паттерны использования и ассерты взяты из
CoreTests,MartenTestsи compliance-тестов транспортов
Ориентирован на Wolverine 6.x (ветка main). Функциональность, специфичная для конкретных версий, помечена в reference-файлах (например, «v5.36+», «v6.8+»).
Содержимое скилла распространяется под лицензией MIT. Сам Wolverine — © Jeremy D. Miller and contributors, также под лицензией MIT.
Нашли устаревший или неверный API? PR приветствуются — пожалуйста, сверяйте изменения с актуальными исходниками Wolverine перед отправкой.
🇬🇧 Looking for the English version? See README.en.md.