用途:为后端 API 实现限流策略,避免服务过载,通过控制请求并发数、队列深度和处理速率,并应用背压机制。资料提到并发限制、优先级队列、熔断器和自适应限流(依据后端实时健康指标调整限制)。
主要能力:实现并发限制中间件,跟踪各端点进行中的请求,达到并发上限时以 503 拒绝新请求;按 API 密钥层级(free、pro、enterprise)分类请求的优先级队列;为下游服务调用构建熔断器,达到失败阈值后打开,返回 503 与 Retry-After;自适应限流监控后端响应延迟百分位(p95、p99),超过 SLO 时自动降低并发上限;在响应中加入 X-Throttle-Limit、X-Throttle-Remaining、X-Throttle-Reset 头;按端点实现降级策略(缓存响应、部分结果、排队延迟处理);编写负载测试验证限流触发与恢复。
使用方式:资料描述需具备支持中间件的 Web 框架(Express、FastAPI、Spring Boot、Gin)、Redis 或内存存储、监控系统(Prometheus、CloudWatch)、负载测试工具(k6、Artillery、wrk),可选队列系统(Bull、SQS)。输出文件包括 ${CLAUDE_SKILL_DIR}/src/middleware/throttle.js、circuit-breaker.js、priority-queue.js,${CLAUDE_SKILL_DIR}/src/config/throttle-config.js 和 ${CLAUDE_SKILL_DIR}/tests/throttle/。详细实现见 ${CLAUDE_SKILL_DIR}/references/implementation.md,错误模式见 errors.md,示例见 examples.md。
限制与注意事项:资料未提供具体安装命令、价格、收费、平台支持范围或实际效果数据;错误处理涉及 503、队列溢出、限流状态过期、优先级饥饿等场景。