opencode-workflow/skills/async-queue-design

非同步與佇列設計 (Async Queue Design) 知識合約指南

概述

async-queue-design 是知識合約，用來設計非同步工作流程、佇列主題、生產者、消費者、重試策略、DLQ、排序保證與逾時行為。供 design-architecture 在設計非同步模型時參考。

核心原則

非同步處理必須有 PRD 需求支撐。不要因為非同步「比較好」或「更有擴展性」就採用。每個非同步決策必須可追溯到特定 PRD 功能需求或 NFR。

設計重點

• 何時用非同步：長時運行操作、PRD 要求非同步、多個消費者需反應同一事件、吞吐量需求超過同步處理能力
• 佇列/主題設計：Topic vs Queue 的選擇、訊息結構、排序保證、持久性保證
• 重試策略：最大重試次數、退避策略（Fixed、Exponential、Exponential with Jitter）、重試預算
• DLQ 策略：何時路由到 DLQ、DLQ 訊息保留、監控與警報
• 逾時與取消：處理逾時的定義、取消訊號機制

知識合約職責

• 提供非同步設計的理論指引
• 不直接產生非同步流程規格（由 design-architecture 的 Async / Queue Design 章節負責）

不應做的事

• 不替系統選擇特定訊息代理
• 不定義具體的佇列名稱或主題名稱
• 不產生實作程式碼