rate-limiting

daishiman 的头像作者 daishiman

提供速率限制和配额管理的最佳实践技能。涵盖服务器端API保护和客户端429响应的双方,从算法选择到实现支持Token Bucket、Sliding Window等。锚点:• 《设计数据密集型应用程序》(Kleppmann)/ 适用:分布式系统的速率限制 / 目的:可扩展的设计• 《API设计模式》(Geewax)/ 适用:API保护 / 目的:RESTful API的最佳实践• RFC 6585 / 适用:429 Too Many Requests / 目的:标准响应设计触发:在设计API速率限制、实施DoS保护、处理外部API速率限制或管理配额系统时使用。

📖 中文导读:提供速率限制和配额管理的最佳实践技能。涵盖服务器端API保护和客户端429响应的双方,从算法选择到实现支持Token Bucket、Sliding Window等。锚点:• 《设计数据密集型应用程序》(Kleppmann)/ 适用:分布式系统的速率限制 / 目的:可扩展的设计• 《API设计模式》(Geewax)/ 适用:API保护 / 目的:RESTful API的最佳实践• RFC 6585 / 适用:429 Too Many Requests / 目的:标准响应设计触发:在设计API速率限制、实施DoS保护、处理外部API速率限制或管理配额系统时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: rate-limiting description: | Rate Limitingとクォータ管理のベストプラクティスを提供するスキル。 サーバー側のAPI保護とクライアント側の429対応の両方をカバーし、 Token Bucket、Sliding Window等のアルゴリズム選定から実装までを支援。

Anchors: • 『Designing Data-Intensive Applications』(Kleppmann)/ 適用: 分散システムのRate Limiting / 目的: スケーラブルな設計 • 『API Design Patterns』(Geewax)/ 適用: API保護 / 目的: RESTful APIのベストプラクティス • RFC 6585 / 適用: 429 Too Many Requests / 目的: 標準準拠のレスポンス設計

Trigger: Use when designing API rate limiting, implementing DoS protection, handling external API rate limits, or managing quota systems. rate limiting, rate limiter, throttling, 429, token bucket, sliding window, quota, api protection

allowed-tools: - Read - Write - Edit - Bash - Glob - Grep

Rate Limiting

概要

Rate Limitingとクォータ管理のベストプラクティスを提供するスキル。サーバー側のAPI保護(DoS対策)とクライアント側の外部API対応の両面から、適切なアルゴリズム選定と実装パターンを支援します。

ワークフロー

Phase 1: 要件分析

目的: Rate Limitingの要件と適用範囲を明確化する

アクション:

  1. 保護対象(API、エンドポイント、ユーザー種別)を特定
  2. サーバー側保護かクライアント側対応かを判断
  3. 制限粒度(IP、ユーザー、API Key)を決定

Task: agents/analyze-requirements.md を参照

Phase 2: アルゴリズム選定

目的: 要件に適したRate Limitingアルゴリズムを選定する

アクション:

  1. Token Bucket、Leaky Bucket、Sliding Window等を比較
  2. バースト許容度、分散環境対応を考慮
  3. ストレージ要件(Redis、メモリ)を検討

Task: agents/select-algorithm.md を参照

Phase 3: 実装

目的: 選定したアルゴリズムを実装する

アクション:

  1. Rate Limiterミドルウェアを実装
  2. 適切なHTTPヘッダー(X-RateLimit-*、Retry-After)を設定
  3. クライアント側の429対応とExponential Backoffを実装

Task: agents/implement-limiter.md を参照

Phase 4: 検証とモニタリング

目的: Rate Limitingの効果を検証しモニタリングを設定する

アクション:

  1. 負荷テストでRate Limitingの動作を確認
  2. レート制限のメトリクスを収集
  3. アラート閾値を設定

Task: agents/validate-limiter.md を参照

Task仕様ナビ

Task 起動タイミング 入力 出力
analyze-requirements Phase 1開始時 システム要件 要件定義書
select-algorithm Phase 2開始時 要件定義書 アルゴリズム選定書
implement-limiter Phase 3開始時 アルゴリズム選定書 Rate Limiter実装
validate-limiter Phase 4開始時 Rate Limiter実装 検証レポート

詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照

ベストプラクティス

すべきこと

推奨事項 理由
X-RateLimit-* ヘッダーを返す クライアントが残り回数を把握可能
Retry-Afterヘッダーを429に含める クライアントが適切に待機可能
Token BucketでバーストをGraceful許容 一時的なスパイクに柔軟対応
Redisで分散環境のカウンターを共有 複数インスタンス間で一貫性確保
Exponential Backoffで429をリトライ サーバー負荷を軽減しつつ成功率向上

避けるべきこと

禁止事項 問題点
429エラーを即座にリトライ サーバー負荷増大、Ban対象に
Rate Limitヘッダーを無視 無駄なリクエストで制限到達
固定間隔でのリトライ サンダリングハード問題発生
メモリ内カウンターのみ サーバー再起動でリセット
エンドユーザーにレート制限を隠す UX悪化、問い合わせ増加

リソース参照

references/(詳細知識)

リソース パス 読込条件
アルゴリズム比較 references/algorithms.md アルゴリズム選定時
サーバー実装 references/server-implementation.md サーバー側実装時
クライアント対応 references/client-handling.md クライアント側実装時
クォータ管理 references/quota-management.md クォータシステム設計時

scripts/(決定論的処理)

スクリプト 機能
scripts/simulate-rate-limit.mjs Rate Limitingシミュレーション
scripts/log_usage.mjs スキル使用履歴の記録

assets/(テンプレート)

アセット 用途
assets/rate-limiter-template.ts Rate Limiterミドルウェア雛形

変更履歴

Version Date Changes
3.1.0 2026-01-02 agents/追加(4エージェント体制確立)
3.0.0 2026-01-02 18-skills.md仕様完全準拠、Task仕様ナビ追加
1.1.0 2025-12-24 仕様整合