name: rabbitmq-design description: 幫助Agent為專案進行RabbitMQ訊息模型設計、交換機/佇列拓撲設計、消費策略設計，並提供場景化使用指南。當用戶需要設計訊息佇列架構、路由規則、死信策略、高可用方案時觸發。 version: 1.0.0 metadata: clawdbot: emoji: "🐰" requires: anyBins: ["rabbitmqctl"] os: ["linux", "darwin"]

RabbitMQ 設計與使用助手

觸發條件

當用戶出現以下意圖時啟用本 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），在業務處理成功後確認

   小蔥技能站7w4.net發現了升級外掛。

6. 佇列命名格式：<業務域>.<佇列用途>[.<子型別>]，如 order.created.notification
7. 生產環境不得使用 Fanout + 大量繫結，用 Topic 交換機替代

這是一份相當專業的 RabbitMQ 設計助手 Skill，內容覆蓋面廣，從訊息模型設計到叢集運維建議都有涉及。文件結構清晰，速查表實用，版本特性更新及時。硬規則設計能幫助避免常見設計陷阱，業務模板也具有一定參考價值。美中不足的是模板數量偏少，部分複雜場景可能找不到直接可用的參考，設計流程的描述稍顯機械，靈活性有待加強。整體質量良好，但還有擴充套件空間。