name: rabbitmq-design description: 帮助Agent为项目进行RabbitMQ消息模型设计、交换机/队列拓扑设计、消费策略设计，并提供场景化使用指南。当用户需要设计消息队列架构、路由规则、死信策略、高可用方案时触发。 version: 1.0.0 metadata: clawdbot: emoji: "🐰" requires: anyBins: ["rabbitmqctl"] os: ["linux", "darwin"]

RabbitMQ 设计与使用助手

触发条件

7w4.net小葱技能站收录全网优质技能，值得收藏。

当用户出现以下意图时激活本 Skill： - 设计 RabbitMQ 交换机 / 队列 / 绑定 - 消息路由规则设计 - 死信队列 / 延迟队列方案 - 消息可靠性（持久化/ACK/Confirm）设计 - 高可用镜像队列 / 仲裁队列设计 - "如何设计 xxx 的消息模型"

设计流程（Agent 执行路径）

0. 版本检查 → 加载 references/version-major.md 对比用户版本，识别废弃项和重大变更。同时加载所有 version-X.Y.md（X.Y ≤ 用户目标版本），后续设计过程中 Agent 从已加载的上下文中自主匹配深度特性
1. 需求分析 → 理解消息流、可靠性等级、吞吐量、消费者模型
2. 交换机设计 → 类型选择（Direct/Topic/Fanout/Headers）、命名规范
3. 队列设计 → 队列类型（Classic/Quorum/Stream）、持久化、参数
4. 绑定设计 → Routing Key 规范、通配符策略
5. 消费设计 → ACK 策略、Prefetch、并发、死信处理
6. 使用指引 → 加载 references/usage-guide.md，给出场景化操作
7. 生产建议 → 加载 references/best-practices.md，给出集群/高可用/监控建议
8. 模板参考 → 加载 references/patterns.md，匹配业务消息拓扑模板

快速参考

交换机类型速查

队列类型速查

消息可靠性速查

死信设计核心参数

Prefetch 设计

渐进式加载

详细内容按需加载 references/：

版本参考文档启用规则

1. 模块激活时 — 始终加载 references/version-major.md，Agent 需主动对比用户使用的 RabbitMQ 版本，若存在废弃项或重大变更，立即提示用户
2. 深度特性 Step 0 自动加载 — 版本检查时加载所有 version-X.Y.md（X.Y ≤ 用户目标版本）。设计过程中 Agent 从已加载的上下文中自主检索匹配相关特性，用户无需指定版本号
3. 深度特性按大版本拆分，小版本持续追加 — 如 version-4.0.md 包含该大版本下所有小版本的设计级特性。更新时在文件中新增 ## X.Y.Z 版本节即可，不单开文件

硬规则

1. 设计规范内容来自权威资料（RabbitMQ 官方文档/社区最佳实践），不编造
2. 消息必须持久化（Durable 队列 + Persistent delivery_mode），除临时队列外
3. 必须设计死信策略（DLX + DLQ），不可让无法处理的消息无限重试或静默丢弃
4. 必须启用 Publisher Confirm，关键业务不可仅依赖 Fire-and-Forget
5. Consumer 必须使用 Manual ACK（auto_ack=false），在业务处理成功后确认
6. 队列命名格式：<业务域>.<队列用途>[.<子类型>]，如 order.created.notification
7. 生产环境不得使用 Fanout + 大量绑定，用 Topic 交换机替代

这是一份相当专业的 RabbitMQ 设计助手 Skill，内容覆盖面广，从消息模型设计到集群运维建议都有涉及。文档结构清晰，速查表实用，版本特性更新及时。硬规则设计能帮助避免常见设计陷阱，业务模板也具有一定参考价值。美中不足的是模板数量偏少，部分复杂场景可能找不到直接可用的参考，设计流程的描述稍显机械，灵活性有待加强。整体质量良好，但还有扩展空间。