用途:为构建可靠分布式系统提供模式规则集,覆盖分布式锁、弹性容错、幂等、限流、边缘计算与事件驱动六大类,共 11 条规则,规则文件位于 rules/ 目录并按需加载。
主要能力:分布式锁含 fencing token 与 owner 校验;弹性容错含熔断器(CLOSED/OPEN/HALF_OPEN)、指数退避重试与 jitter、隔板隔离;幂等含幂等键与确定性哈希;限流含令牌桶与滑动窗口;边缘计算含边缘 worker、V8 isolate、CDN 缓存与地理路由;事件驱动含事件溯源、CQRS、事务性发件箱与 saga。
使用方式:按需引用对应规则文件,例如 rules/locks-fencing-tokens.md、rules/resilience-circuit-breaker.md、rules/idempotency-keys.md、rules/ratelimit-token-bucket.md、rules/edge-workers.md、rules/event-sourcing.md。scripts/ 提供锁、熔断器、限流器模板。
限制与注意:单进程服务不需要这些模式,应使用进程内替代方案;事件溯源、CQRS、saga 在多数项目中属于过度设计。禁止无 TTL 的锁、无 owner 校验的释放、重试不可重试错误、非确定性幂等键、缓存错误响应、分布式系统中使用内存计数器。Redis 单节点锁、Redlock、PostgreSQL 咨询锁、熔断器、隔板、重试、幂等键、令牌桶、SlowAPI 等主题已移除,需查阅对应第一方来源,不在本技能内重复。
适用场景:多实例部署、需要跨实例协调、外部 API 调用容错、严格配额限流、边缘运行时与事件驱动架构。
相关技能:caching、background-jobs、observability-monitoring、error-handling-rfc9457、auth-patterns。