技能介绍

解决什么问题

事件驱动架构的接口文档通常散落在各处：Kafka 的 topic 定义在某个服务的代码里，RabbitMQ 的队列和绑定写在配置中心，消息格式一改，文档就先失了真。等到下游团队问"某个事件谁生产、字段有哪些"时，往往只能靠翻代码或口头确认。这个技能要消灭的就是这种状态：只要仓库里有一份符合 AsyncAPI 3.0 的规范文件，就能自动产出一份结构化的事件目录，让通道、消息 schema 与服务器绑定沉淀为单一事实源。

工作原理

技能的核心是调用 AsyncAPI 生态的 parser-js（@asyncapi/parser）解析规范文档，分三步完成目录构建：

提取通道：遍历规范中的 channels，每个通道代表一个事件流通的端点；
还原消息 schema：从消息的 payload 中提取消息体的数据结构，供订阅方核对字段；
读取服务器绑定：解析 Kafka 与 RabbitMQ 的 bindings，还原 broker 侧的接入配置，如 topic 名称、队列与交换机等。

最终输出一份人类可读的事件驱动架构文档，可直接入库或挂到内部文档站，供消息生产者与消费者共同查阅。

适用边界

输入必须已是 AsyncAPI 3.0 规范文件，技能不会从业务代码反推事件模型，也不做代码扫描；
目前仅覆盖 Kafka 与 RabbitMQ 两种绑定，其他 broker 或协议（如 MQTT、Google Pub/Sub）不在提取范围内；
官方提示无法自动获取源码级安装方式或使用说明，若要在生产或敏感流水线中使用，建议先审阅上游 AsyncAPI 项目（asyncapi.com）及官方文档（asyncapi.com/docs），确认解析行为与版本兼容性后再接入。