用途:该技能用于设计事件驱动 API,基于 AsyncAPI 3.0 规范描述面向消息的架构,适用于消息代理配置(Kafka、RabbitMQ、MQTT、WebSocket 绑定)、在 C# 中实现(事件契约、MassTransit、Confluent Kafka)以及事件版本管理与向后兼容。
主要能力:区分 AsyncAPI 与 OpenAPI(请求/响应 vs 事件驱动;HTTP vs Kafka/RabbitMQ/MQTT/WebSocket;同步 vs 异步);给出 AsyncAPI 3.0 结构概览(asyncapi、info、servers、channels、operations、components);支持协议与绑定版本参考(Kafka 0.5.0、AMQP 0.3.0、MQTT 0.2.0、WebSocket);提供通道命名约定 {domain}.{entity}.{action}.{version},如 orders.order.created.v1。
使用方式:采用文档优先方法,创建规范前先调用 docs-management 技能了解事件驱动模式,并通过 MCP 服务器核实 AsyncAPI 3.0 语法。工作流程为:识别事件、定义通道、设计消息、选择协议、添加绑定、记录安全、制定版本策略、用 AsyncAPI 生成器生成客户端与处理器代码。按需加载参考文件:basic-template.md(从零创建规范)、protocol-patterns.md(协议配置)、csharp-implementation.md(.NET/C# 实现)、event-design-patterns.md(事件信封、版本与最佳实践)。
适用场景:消息队列、流式处理、IoT 等异步通信设计。限制:资料未提供具体定价、平台支持范围或效果承诺;版本历史显示 v2.0.0(2026-01-17)重构为渐进式披露,v1.0.0(2025-12-26)初始发布。