SuperAPI AI 工具集

414-frameworks-quarkus-kafka

编程与开发

查看项目

更新于 10-15 15:18

技能介绍

用途

该技能面向在 Quarkus 应用中使用 Kafka 消息通信的开发场景,基于 SmallRye Reactive Messaging 提供设计、实现与错误处理方面的指导。当需要为 Quarkus 项目添加 Kafka、审查响应式消息的消费者与生产者、改进重试或死信处理、配置 Kafka 频道,或添加失败策略与 DLQ 处理时,可使用本技能。

主要能力

技能覆盖的主题包括:频道与主题设计、构建期 Jackson 序列化、类型化消息、重试机制、死信处理以及幂等性。它提供与框架对齐的具体示例,用于设计、实现和错误处理。

使用方式

技能定义了明确的工作流程:

  1. 阅读参考文档并评估项目上下文。阅读 references/414-frameworks-quarkus-kafka.md,并在提出变更前检查当前的消息设置。
  2. 收集范围并确定目标改进。识别投递语义与弹性目标,以定义安全的改进方案。
  3. 应用与框架对齐的变更。在 Reactive Messaging 中实现或重构频道、序列化器与失败策略。
  4. 运行验证并报告结果。执行构建与测试,并总结变更内容、已验证内容以及后续行动。

技能包含强制约束:在应用任何变更前,必须运行 ./mvnw compile 或 mvn compile;如果编译失败,必须立即停止;在应用改进后,运行 ./mvnw clean verify 或 mvn clean verify 进行验证。

适用场景

  • 在 Quarkus 中添加 Kafka
  • 审查 Quarkus Reactive Messaging 的消费者与生产者
  • 改进 Quarkus Kafka 中的重试、死信处理或幂等性
  • 配置 Quarkus Reactive Messaging 的 Kafka 频道
  • 添加 Quarkus Kafka 失败策略或 DLQ 处理

限制

技能要求先编译再重构消息代码,并在变更后验证;编译失败时必须立即停止。详细规则与示例需查阅参考文档 references/414-frameworks-quarkus-kafka.md。关于该技能支持的 Quarkus 或 Kafka 具体版本、依赖坐标、配置项默认值、性能指标或收费信息,资料中暂未提供。