rate-limiting
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
$ Instalar
git clone https://github.com/daishiman/AIWorkflowOrchestrator /tmp/AIWorkflowOrchestrator && cp -r /tmp/AIWorkflowOrchestrator/.claude/skills/rate-limiting ~/.claude/skills/AIWorkflowOrchestrator// tip: Run this command in your terminal to install the skill
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の要件と適用範囲を明確化する
アクション:
- 保護対象（API、エンドポイント、ユーザー種別）を特定
- サーバー側保護かクライアント側対応かを判断
- 制限粒度（IP、ユーザー、API Key）を決定
Task: agents/analyze-requirements.md を参照
Phase 2: アルゴリズム選定
目的: 要件に適したRate Limitingアルゴリズムを選定する
アクション:
- Token Bucket、Leaky Bucket、Sliding Window等を比較
- バースト許容度、分散環境対応を考慮
- ストレージ要件（Redis、メモリ）を検討
Task: agents/select-algorithm.md を参照
Phase 3: 実装
目的: 選定したアルゴリズムを実装する
アクション:
- Rate Limiterミドルウェアを実装
- 適切なHTTPヘッダー（X-RateLimit-*、Retry-After）を設定
- クライアント側の429対応とExponential Backoffを実装
Task: agents/implement-limiter.md を参照
Phase 4: 検証とモニタリング
目的: Rate Limitingの効果を検証しモニタリングを設定する
アクション:
- 負荷テストでRate Limitingの動作を確認
- レート制限のメトリクスを収集
- アラート閾値を設定
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 | 仕様整合 |
Repository
